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
|
metrics.raised |
string
Company's approximate amount of funding raised
|
tech |
array
Technology detected on company's website
|
facebook.handle |
string
The Facebook handle of 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
URL logo for 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
|
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 Sams 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...",
"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": 34,
"alexaGlobalRank": 119,
"employees": 2300000,
"employeesRange": "10K+",
"marketCap": 287676727296,
"annualRevenue": 495011987456,
"estimatedAnnualRevenue": "$10B+",
"raised": null
},
"tech": [
"omniture_adobe_analytics",
"google_adsense",
"double_click",
"app_nexus",
"typekit_by_adobe",
"google_analytics"
],
"facebook": {
"handle": "walmart"
"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": "http://logo.bigpicture.io/logo/walmart.com",
"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.
|
curl 'https://company.bigpicture.io/v1/companies/find?domain=walmart.com' \
-H 'Authorization: {API_KEY}'
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 |
