The Demandbase gem is a Ruby wrapper for the Demandbase real-time targeting and personalization platform's API.
Prerequisites
You'll need an active Demandbase account with at least one Real Time Identification (RTID) key. You can sign up for a trial developer key here.
Installation
Install the Demandbase wrapper with:
gem install demandbase
or add the following to your Gemfile:
gem 'demandbase', '~> 0.1.1'
Configuraton
Set an environment variable called $DEMANDBASE_RTID_KEY with the your RTID key value.
Bash Example
export DEMANDBASE_RTID_KEY=1234deadbeef4321
Heroku Example
heroku config:add DEMANDBASE_RTID_KEY=1234deadbeef4321
Usage
Domain Lookup
If everything's installed and configured you should be able to look up companies' information via their domain name as follows:
record = Demandbase::lookup_domain 'microsoft.com'
# => <Demandbase::Record:0x007fce82a46060>
record.company_name
# => "Microsoft Corporation"
record.is_academic?
# => false
record.is_government?
# => false
record.demandbase_sid
# => 457441
record.marketing_alias
# => "Microsoft"
record.industry
# => "Software & Technology"
record.sub_industry
# => "Software Applications"
record.employee_count
# => 94050
record.primary_sic
# => "7372"
record.street_address
# => "1 Microsoft Way"
record.city
# => "Redmond"
record.state
# => "WA"
record.zip
# => "98052"
record.country
# => "US"
record.country_name
# => "United States"
record.phone
# => "425-882-8080"
record.stock_ticker
# => "MSFT"
record.web_site
# => "microsoft.com"
record.annual_sales
# => 73723000000
record.revenue_range
# => "Over $5B"
record.employee_range
# => "Enterprise"
record.b2b
# => true
record.b2c
# => true
record.traffic
# => "Very High"
record.latitude
# => 47.6401
record.longitude
# => -122.13
record.fortune_1000
# => true
record.forbes_2000
# => true
IP Lookup
The IP lookup returns some additional information e.g.
record = Demandbase::lookup_ip 'microsoft.com'
# => <Demandbase::Record:0x007fce82a46060>
Lazy Lookup
If you have an IP, domain name, email address, or craptacular URL and just want to use that use lookup
ip_looking_thing = '12.12.12.12'
domain_looking_thing 'http://google.com'
url_looking_thing 'www.google.com/lol?seriously=true'
email_looking_thing '[email protected]'
(Demandbase::lookup ip_looking_thing).class
# => Demanbase::IPRecord
(Demandbase::lookup domain_looking_thing).class
# => Demanbase::DomainRecord
(Demandbase::lookup url_looking_thing).class
# => Demanbase::DomainRecord
(Demandbase::lookup email_looking_thing).class
# => Demanbase::DomainRecord
Field Info
| Field name (click for description) | DomainRecord Presence? | IPRecord Presence? |
|---|---|---|
| registry_company_name | :finnadie: | :metal: |
| registry_city | :finnadie: | :metal: |
| registry_state | :finnadie: | :metal: |
| registry_country | :finnadie: | :metal: |
| registry_latitude | :finnadie: | :metal: |
| registry_longitude | :finnadie: | :metal: |
| ip | :finnadie: | :metal: |
| information_level | :finnadie: | :metal: |
| worldhq_sid | :finnadie: | :metal: |
| domestichq_sid | :finnadie: | :metal: |
| hq_sid | :finnadie: | :metal: |
| isp | :finnadie: | :metal: |
| company_name | :metal: | :metal: |
| demandbase_sid | :metal: | :metal: |
| marketing_alias | :metal: | :metal: |
| industry | :metal: | :metal: |
| sub_industry | :metal: | :metal: |
| employee_count | :metal: | :metal: |
| primary_sic | :metal: | :metal: |
| street_address | :metal: | :metal: |
| city | :metal: | :metal: |
| state | :metal: | :metal: |
| zip | :metal: | :metal: |
| country | :metal: | :metal: |
| country_name | :metal: | :metal: |
| phone | :metal: | :metal: |
| web_site | :metal: | :metal: |
| annual_sales | :metal: | :metal: |
| revenue_range | :metal: | :metal: |
| employee_range | :metal: | :metal: |
| b2b | :metal: | :metal: |
| b2c | :metal: | :metal: |
| traffic | :metal: | :metal: |
| latitude | :metal: | :metal: |
| longitude | :metal: | :metal: |
| fortune_1000 | :metal: | :metal: |
| forbes_2000 | :metal: | :metal: |
Registry Company Name
Registry City
Registry State
Registry Country
Registry Latitude
Registry Longitude
IP
Information Level
World HQ SID
Domestic HQ SID
HQ SID
ISP
Company Name
Demandbase SID
Marketing Alias
Industry
Sub Industry
Employee Count
Primary SIC
Street Address
City
State
Zip
Country
Country Name
Phone
Web Site
Annual Sales
Revenue Range
Revenue Range
| Value | Description |
|---|---|
| $1 - $1M | :credit_card: |
| $1M - $5M | :dollar: |
| $5M - $10M | :dollar: :dollar: |
| $10M - $25M | :dollar: :dollar: :dollar: :dollar: :dollar: :dollar: :dollar: :dollar: :dollar: :dollar: |
| $25M - $50M | :dollar: :dollar: :dollar: :dollar: :dollar: :dollar: :dollar: :dollar: :dollar: :dollar: :dollar: :dollar: :dollar: :dollar: :dollar: :dollar: :dollar: :dollar: :dollar: :dollar: |
| $50M - $100M | :moneybag: |
| $100M - $250M | :moneybag::moneybag: |
| $250M - $500M | :moneybag::moneybag::moneybag: |
| $500M - $1B | :moneybag::moneybag::moneybag::moneybag: |
| $1B - $2.5B | :moneybag::moneybag::moneybag::moneybag::moneybag: |
| $2.5B - $5B | :moneybag::moneybag::moneybag::moneybag::moneybag::moneybag: |
| Over $5B | :money_with_wings: |
Employee Range
| Value | Description |
|---|---|
| Unknown | :house: |
| Small | :school:1-99 employees |
| Mid-Market | :department_store: 100-999 employees |
| Enterprise | :office: 1000+ employees |
Audience
| Company Size | Vertical | Origination |
|---|---|---|
| Enterprise Mid-Market SMB |
Government Education |
Wireless Residential SOHO Unknown |
Audience Segment
| Company Size | Government | Education | Wireless | Residential/SOHO/Unknown |
|---|---|---|---|---|
| Industry Search Engine |
Federal International State City Local Military Public Safety |
University K12 Vocational Educational Services Educational ISP |
Wireless Device Wireless Hotspot |
Bots |
B2B
B2C
Traffic
Latitude
Longitude
Fortune 1000
Forbes 2000
DLC / Enhancements
- Use the csi gem if you'd like to correlate SIC codes with NAICS codes.
- Use the fortune-finder gem if you'd like to retrieve the ranking of a Fortune 500 company.
- Use the forbes-finder gem if you'd like to retrieve the ranking of a Fortune 1000 company.
License
MIT.