Company API

The Company API transforms a domain into a full company profile.

Attributes

The dot notation indicates that the field is one level deep inside the object. If we can’t find data for an attribute, then we’ll set a null value.

Attribute Description
name
string
Normalized company name
legalName
string
Normalized legal company name
aliases
array
Other names associated with company
domainAliases
string
Other domains associated with company
url
string
Primary website url
tags
array
A list of descriptive tags to describe company (see options)
category.sector
string
Top level sector to categorize company industry (see options)
category.industryGroup
string
Industry group (see options)
category.industry
string
Industry (see options)
category.subIndustry
string
Sub industry (see options)
description
string
The best description we have of the company
foundedYear
integer
Founding year of company
location
string
Formatted address of company
timeZone
string
Time zone based on location
utcOffset
integer
The offset from UTC in hours in the company’s location
geo.streetNumber
string
Primary office street number
geo.streetName
string
Primary office street name
geo.subPremise
string
Primary office suite number
geo.city
string
Primary office normalized city
geo.state
string
Primary office normalized state
geo.stateCode
string
Primary office normalized two letter state code
geo.country
string
Primary office normalized country
geo.countryCode
string
Primary office normalized two letter state code
geo.lat
float
Approximate latitude
geo.lng
float
Approximate longitude
metrics.alexaUsRank
integer
The US Alexa ranking of the domain
metrics.alexaGlobalRank
integer
The global Alexa ranking of the domain
metrics.employees
integer
Approximate number of employees at company
metrics.employeesRange
string
Approximate employee range at company
metrics.marketCap
integer
Company's market capitalization
metrics.annualRevenue
integer
Company's approximate annual revenue
metrics.estimatedAnnualRevenue
string
Company's approximate annual revenue range
tech
array
Technology detected on company's website
facebook.handle
string
The Facebook handle of Company's page
facebook.likes
integer
Number of Facebook likes on Company's page
linkedin.handle
string
The LinkedIn handle
twitter.handle
string
The Twitter handle
twitter.id
string
Twitter ID
twitter.bio
string
Twitter bio
twitter.followers
integer
Count of Twitter followers
twitter.following
integer
Count of Twitter friends
twitter.location
string
Twitter location
twitter.site
string
Twitter website
twitter.avatar
string
Twitter URL avatar
crunchbase.handle
string
Crunchbase handle
logo
string
The best URL logo we could find of the company
emailProvider
boolean
Whether or not this domain is an email provider (gmail.com, comcast.net, etc.)
type
string
The company type, which is either public, private, nonprofit, or government
ticker
string
The ticker symbol the company is traded under
phone
string
The primary phone number of company
geo.stateCode
string
Normalized two letter state code
geo.country
string
Normalized country
geo.countryCode
string
Normalized two letter state code
geo.lat
float
Rough latitude
geo.lng
float
Rough longitude
bio
string
Best bio we have
avatar
string
Best avatar url we have
employment.name
string
Company name
employment.domain
string
Company domain
employment.title
string
Title at Company
employment.role
string
Role at Company
employment.seniority
string
Seniority at Company
social.facebook.handle
string
Facebook ID or screen name
social.twitter.handle
string
Twitter screen name
social.twitter.id
number
Twitter id
social.twitter.bio
string
Twitter bio
social.twitter.statuses
number
Twitter statuses
social.twitter.statuses
number
Twitter favorites
social.twitter.followers
number
Twitter followers
social.twitter.following
number
Twitter following
social.twitter.avatar
string
Twitter avatar url
social.twitter.location
string
Twitter location
social.twitter.site
string
Twitter site
social.linkedin.handle
string
LinkedIn handle
tags
array
Statistically derived descriptive tags of person

An example of the JSON response.


{
  "name": "Wal-Mart Stores",
  "legalName": "Wal-Mart Stores, Inc.",
  "aliases": [
    "Walmart Global eCommerce",
    "Walmart, Inc."
  ],
  "domain": "walmart.com",
  "domainAliases": [
    "walmart.net",
    "walmartstores.com",
    "wal-mart.com",
    "wallmart.com",
    "walmartcareers.com",
    "wamart.com",
    "walmartjobs.com",
    "walmarts.com",
    "walmartgreenroom.com",
    "walmartfoundation.org",
    "walmartonline.com",
    "relion.com",
    "walmart.org"
  ],
  "url": "https://www.walmart.com/",
  "tags": [
    "Retail",
    "Consumer Electronics",
    "Apparel & Footwear",
    "Jewelry, Watches & Luxury Goods",
    "Toys",
    "Pets",
    "Supermarkets",
    "E-commerce",
    "B2C",
    "Pharmacy",
    "Health Care"
  ],
  "category": {
    "sector": "Consumer Services",
    "industryGroup": "Retail",
    "industry": "General Retailers",
    "subIndustry": "Broadline Retailers"
  },
  "description": "Wal-Mart Stores, Inc. operates retail stores in various formats worldwide. It operates through three segments: Walmart U.S., Walmart International, and Sam’s Club. The company operates discount stores, supermarkets, supercenters, hypermarkets, warehouse clubs, cash and carry stores, home improvement stores, specialty electronics stores, apparel stores, drug stores, convenience stores, and membership-only warehouse clubs; and retail Websites, such as walmart.com and samsclub.com, as well as mobile commerce applications. It offers grocery products, including meat, produce, natural and organics, deli and bakery, dairy, frozen foods, alcoholic and nonalcoholic beverages, floral and dry grocery, as well as consumables, such as health and beauty aids, baby products, household chemicals, paper goods, and pet supplies; and health and wellness products, which include pharmacy, optical services, clinical services, over-the-counter drugs, and other medical products. The company also provides electronics, cameras and supplies, photo processing services, cellular phones, cellular service plan contracts and prepaid service, movies, music, video games, and books; stationery, automotive, hardware and paint, sporting goods, and outdoor living and horticulture, as well as fabrics, crafts, and seasonal merchandise; apparel for women, girls, men, boys, and infants, as well as shoes, jewelry, and accessories; and home furnishings, housewares and small appliances, bedding, home decor, and toys. In addition, it offers fuel and financial services and related products, including money orders, prepaid cards, wire transfers, money transfers, check cashing, and bill payment. In addition, it offers brand name merchandise, including hardgoods, softgoods, and selected private-label items, such as Member’s Mark. It operates 11,593 stores under 63 banners in 28 countries and e-commerce Websites in 11 countries. Wal-Mart Stores, Inc. was founded in 1945 and is headquartered in Bentonville, Arkansas.",
  "foundedYear": 1962,
  "location": "702 SW 8th Street Bentonville, AR 72716 United States",
  "timeZone": "America/Chicago",
  "utcOffset": -6,
  "geo": {
    "streetNumber": "702",
    "streetName": "Sw 8Th Street",
    "subPremise": null,
    "city": "Bentonville",
    "postalCode": "72716",
    "state": "Arkansas",
    "stateCode": "AR",
    "country": "United States of America",
    "countryCode": "US",
    "lat": 36.3655840,
    "lng": -94.2181500
  },
  "metrics": {
    "alexaUsRank": 43,
    "alexaGlobalRank": 162,
    "employees": 2300000,
    "employeesRange": "10K+",
    "marketCap": 287676727296,
    "annualRevenue": 495011987456,
    "estimatedAnnualRevenue": "$10B+"
  },
  "tech": [
    "omniture_adobe_analytics",
    "google_adsense",
    "double_click",
    "app_nexus",
    "typekit_by_adobe",
    "google_analytics"
  ],
  "facebook": {
    "handle": "walmart",
    "likes": 34046266
  },
  "linkedin": {
    "handle": "company/walmart"
  },
  "twitter": {
    "handle": "walmart",
    "id": "17137891",
    "bio": "Save Money, Live Better. Follow us to learn about tips, solutions & limited time specials! If you need customer support please tweet us @walmarthelp.",
    "followers": 919530,
    "following": 4140,
    "location": "Bentonville, Arkansas",
    "site": "http://www.walmart.com",
    "avatar": "https://pbs.twimg.com/profile_images/872879465818243072/oHnYN1Jw_normal.jpg"
  },
  "crunchbase": {
    "handle": "organization/walmart"
  },
  "logo": "https://pbs.twimg.com/profile_images/872879465818243072/oHnYN1Jw_normal.jpg",
  "emailProvider": false,
  "type": "public",
  "ticker": "WMT",
  "phone": "+1 479-273-4000",
}

    

Lookup

The Company API is designed to look up a company via their domain. We also support a few other attributes that may help in the lookup process.

Parameter Description
domain
string (required)
The domain to lookup.

HTTP Request

When you make a request, the default behavior is to return a 200 status with the data. If the data is not yet in our database or stale we will return an empty 202 status. You can either try the request again in a few minutes, stream the request, or provide a webhook we should call when the data is ready.

Here are the other options you can provide.

Parameter Description
webhookUrl
string
The webhook url we should call when the data is ready
webhookId
string
An optional id we will include with the webhook call

Responses

Code Description
200 - OK A match has been found.
202 - Accepted Occurs when email is not yet in our database or the data is stale.
404 - Not Found We could not find a match.

When the webhookUrl parameter is included, we will make a POST call to the url you provide when processing is complete.

  
  curl 'https://company.bigpicture.io/v1/companies/find?domain=walmart.com&webhookUrl=https://requestb.in/wpyz2mwp' \
  -H 'Authorization: {API_KEY}'
  
  

You can also include an optional webhookId, which will be included with the response data. It's useful if you have a single webhook endpoint and want to match up results to an internal id.


curl 'https://company.bigpicture.io/v1/companies/find?domain=walmart.com&webhookUrl=https://requestb.in/wpyz2mwp&webhookId=12345' \
-H 'Authorization: {API_KEY}'

  

Streaming

Our system works by doing a realtime search of various sources and doing a deep analysis of the data before returning a final result. If you'd prefer, you can hold the connection open and wait until the data is ready by calling the stream endpoint.

Please note, this endpoint currently has a lower rate limit of 5 requests per min. If you need a higher rate limit, please contact us.

Stream example


curl 'https://company.bigpicture.io/v1/companies/find/stream?domain=bigpicture.io' \
  -H 'Authorization: {API_KEY}'

      

Parameter Options

Below are some of the options available for specific parameters.

Category

The company data returns a standardized set of industry data divided into four tiers - sector, industryGroup, industry, and subIndustry. The categories are currently based on the ICB classification system.

sector industryGroup industry subIndustry
Basic Materials Basic Resources Forestry & Paper Forestry
Basic Materials Basic Resources Forestry & Paper Paper
Basic Materials Basic Resources Industrial Metals & Mining Iron & Steel
Basic Materials Basic Resources Industrial Metals & Mining Nonferrous Metals
Basic Materials Basic Resources Industrial Metals & Mining Aluminum
Basic Materials Basic Resources Mining Diamonds & Gemstones
Basic Materials Basic Resources Mining Gold Mining
Basic Materials Basic Resources Mining Platinum & Precious Metals
Basic Materials Basic Resources Mining Coal
Basic Materials Basic Resources Mining General Mining
Basic Materials Chemicals Chemicals Specialty Chemicals
Basic Materials Chemicals Chemicals Commodity Chemicals
Consumer Goods Automobiles & Parts Automobiles & Parts Auto Parts
Consumer Goods Automobiles & Parts Automobiles & Parts Automobiles
Consumer Goods Automobiles & Parts Automobiles & Parts Tires
Consumer Goods Food & Beverage Beverages Brewers
Consumer Goods Food & Beverage Beverages Distillers & Vintners
Consumer Goods Food & Beverage Beverages Soft Drinks
Consumer Goods Food & Beverage Food Producers Farming, Fishing & Plantations
Consumer Goods Food & Beverage Food Producers Food Products
Consumer Goods Personal & Household Goods Household Goods & Home Construction Furnishings
Consumer Goods Personal & Household Goods Household Goods & Home Construction Home Construction
Consumer Goods Personal & Household Goods Household Goods & Home Construction Nondurable Household Products
Consumer Goods Personal & Household Goods Household Goods & Home Construction Durable Household Products
Consumer Goods Personal & Household Goods Leisure Goods Recreational Products
Consumer Goods Personal & Household Goods Leisure Goods Consumer Electronics
Consumer Goods Personal & Household Goods Leisure Goods Toys
Consumer Goods Personal & Household Goods Personal Goods Clothing & Accessories
Consumer Goods Personal & Household Goods Personal Goods Footwear
Consumer Goods Personal & Household Goods Personal Goods Personal Products
Consumer Goods Personal & Household Goods Tobacco Tobacco
Consumer Services Media Media Media Agencies
Consumer Services Media Media Broadcasting & Entertainment
Consumer Services Media Media Publishing
Consumer Services Retail Food & Drug Retailers Food Retailers & Wholesalers
Consumer Services Retail Food & Drug Retailers Drug Retailers
Consumer Services Retail General Retailers Apparel Retailers
Consumer Services Retail General Retailers Specialized Consumer Services
Consumer Services Retail General Retailers Specialty Retailers
Consumer Services Retail General Retailers Broadline Retailers
Consumer Services Retail General Retailers Home Improvement Retailers
Consumer Services Travel & Leisure Travel & Leisure Airlines
Consumer Services Travel & Leisure Travel & Leisure Recreational Services
Consumer Services Travel & Leisure Travel & Leisure Hotels
Consumer Services Travel & Leisure Travel & Leisure Restaurants & Bars
Consumer Services Travel & Leisure Travel & Leisure Travel & Tourism
Consumer Services Travel & Leisure Travel & Leisure Gambling
Financials Banks Banks Banks
Financials Financial Services Equity Investment Instruments Equity Investment Instruments
Financials Financial Services Financial Services Investment Services
Financials Financial Services Financial Services Asset Managers
Financials Financial Services Financial Services Mortgage Finance
Financials Financial Services Financial Services Consumer Finance
Financials Financial Services Financial Services Specialty Finance
Financials Financial Services Nonequity Investment Instruments Nonequity Investment Instruments
Financials Insurance Life Insurance Life Insurance
Financials Insurance Nonlife Insurance Reinsurance
Financials Insurance Nonlife Insurance Insurance Brokers
Financials Insurance Nonlife Insurance Full Line Insurance
Financials Insurance Nonlife Insurance Property & Casualty Insurance
Financials Real Estate Real Estate Investment & Services Real Estate Holding & Development
Financials Real Estate Real Estate Investment & Services Real Estate Services
Financials Real Estate Real Estate Investment Trusts Hotel & Lodging REITs
Financials Real Estate Real Estate Investment Trusts Specialty REITs
Financials Real Estate Real Estate Investment Trusts Mortgage REITs
Financials Real Estate Real Estate Investment Trusts Diversified REITs
Financials Real Estate Real Estate Investment Trusts Industrial & Office REITs
Financials Real Estate Real Estate Investment Trusts Residential REITs
Financials Real Estate Real Estate Investment Trusts Retail REITs
Health Care Health Care Health Care Equipment & Services Medical Supplies
Health Care Health Care Health Care Equipment & Services Health Care Providers
Health Care Health Care Health Care Equipment & Services Medical Equipment
Health Care Health Care Pharmaceuticals & Biotechnology Biotechnology
Health Care Health Care Pharmaceuticals & Biotechnology Pharmaceuticals
Industrials Construction & Materials Construction & Materials Heavy Construction
Industrials Construction & Materials Construction & Materials Building Materials & Fixtures
Industrials Industrial Goods & Services Aerospace & Defense Aerospace
Industrials Industrial Goods & Services Aerospace & Defense Defense
Industrials Industrial Goods & Services Electronic & Electrical Equipment Electronic Equipment
Industrials Industrial Goods & Services Electronic & Electrical Equipment Electrical Components & Equipment
Industrials Industrial Goods & Services General Industrials Containers & Packaging
Industrials Industrial Goods & Services General Industrials Diversified Industrials
Industrials Industrial Goods & Services Industrial Engineering Commercial Vehicles & Trucks
Industrials Industrial Goods & Services Industrial Engineering Industrial Machinery
Industrials Industrial Goods & Services Industrial Transportation Marine Transportation
Industrials Industrial Goods & Services Industrial Transportation Railroads
Industrials Industrial Goods & Services Industrial Transportation Trucking
Industrials Industrial Goods & Services Industrial Transportation Delivery Services
Industrials Industrial Goods & Services Industrial Transportation Transportation Services
Industrials Industrial Goods & Services Support Services Business Support Services
Industrials Industrial Goods & Services Support Services Financial Administration
Industrials Industrial Goods & Services Support Services Waste & Disposal Services
Industrials Industrial Goods & Services Support Services Business Training & Employment Agencies
Industrials Industrial Goods & Services Support Services Industrial Suppliers
Oil & Gas Oil & Gas Alternative Energy Renewable Energy Equipment
Oil & Gas Oil & Gas Alternative Energy Alternative Fuels
Oil & Gas Oil & Gas Oil & Gas Producers Integrated Oil & Gas
Oil & Gas Oil & Gas Oil & Gas Producers Exploration & Production
Oil & Gas Oil & Gas Oil Equipment, Services & Distribution Pipelines
Oil & Gas Oil & Gas Oil Equipment, Services & Distribution Oil Equipment & Services
Technology Technology Software & Computer Services Computer Services
Technology Technology Software & Computer Services Software
Technology Technology Software & Computer Services Internet
Technology Technology Technology Hardware & Equipment Electronic Office Equipment
Technology Technology Technology Hardware & Equipment Telecommunications Equipment
Technology Technology Technology Hardware & Equipment Semiconductors
Technology Technology Technology Hardware & Equipment Computer Hardware
Telecommunications Telecommunications Fixed Line Telecommunications Fixed Line Telecommunications
Telecommunications Telecommunications Mobile Telecommunications Mobile Telecommunications
Utilities Utilities Electricity Conventional Electricity
Utilities Utilities Electricity Alternative Electricity
Utilities Utilities Gas, Water & Multi-utilities Multi-utilities
Utilities Utilities Gas, Water & Multiutilities Gas Distribution
Utilities Utilities Gas, Water & Multiutilities Water

Tags

BigPicture.io provides two levels of granularity for company tags: general tags and detail tags.

General tags are high level, generic categories that can be applied broadly to a company. Detail tags can be used for very detailed company segmentation.

General Tags
B2B
B2C
E-Commerce
Enterprise
ISP
Marketplace
Mobile
SAAS
Detail Tags
3D Printing
Accounting
Aerospace & Defense
Agriculture
Airlines
Alternative Medicine
Animation
Apparel & Fashion
Apparel & Footwear
Architecture
Arts
Arts & Crafts
Asset Management
Audio
Automation
Automotive
Banking & Mortgages
Beverages
Biotechnology
Broadband
Broadcasting
Building Materials
Business Supplies
Chemicals
Civil Engineering
Cloud Services
Communications
Computer Hardware
Computer Networking
Construction
Consulting & Professional Services
Consumer Discretionary
Consumer Electronics
Consumer Goods
Consumer Staples
Corporate & Business
Cosmetics
Design
E-Commerce & Marketplaces
E-Learning
Education
Electrical
Energy
Entertainment & Recreation
Eyewear
Facilities
Family Services
Finance
Financial Services
Fine Art
Fishery
Food
Food Production
Food
Fundraising
Gambling & Casinos
Graphic Design
Ground Transportation
Health & Wellness
Health Care
Higher Education
Home & Furniture
Home Improvement
Human Resources
Import & Export
Industrials & Manufacturing
Information Technology & Services
Insurance
International Relations
International Trade
Internet
Investment
Investment Banking
Investment Management
Jewelry
Legal Services
Libraries
Machinery
Maritime
Market Research
Marketing & Advertising
Mechanical Engineering
Media
Medicine
Military
Mining & Metals
Mobile
Movies & TV
Museums
Music
Nanotechnology
Oil & Gas
Outsourcing
Packaging & Containers
Paper Goods
Payments
Pharmaceuticals
Pharmacy
Photography
Plastics
Plumbing
Pornography
Primary & Secondary Education
Printing
Public Relations
Publishing
Ranching
Real Estate
Renewable Energy
Renewables & Environment
Research
Restaurants
Security
Services
Shipbuilding
Shipping & Logistics
Sporting Goods
Sports & Fitness
Supermarkets
Talent Agencies
Technology
Telecommunications
Textiles
Tobacco
Tools
Translation
Transportation
Travel & Leisure
Utilities
Venture Capital
Veterinary
Video Games
Wholesale
Wireless