Company Enrichment API
/v1
curl --request GET \
--url https://companyenrichment.abstractapi.com/v1
It’s very simple to use: you are only required to send your unique api_key
and the domain
you want to enrich to get information about the company.
Getting started
REST
The Company Enrichment API, like all of Abstract’s APIs, is organized around REST. It is designed to use predictable, resource-oriented URL’s and to use HTTP status codes to indicate errors.
HTTPS
The Company Enrichment API requires all communications to be secured TLS 1.2 or greater.
API Versions
All of Abstract’s API are versioned. The Company Enrichment API is currently on Version 1.
Your API Key
Your API key is your unique authentication key to be used to access Abstract’s Company Enrichment API. Note that each of Abstract’s API has a unique API key, so you will need different keys to access the Company Enrichment and Email Validation APIs, for example. To authenticate your requests, you will need to append your API key to the base URL.
Base URL
https://companyenrichment.abstractapi.com/v1
Validation endpoint
Abstract’s Company Enrichment API simply requires your unique API key and the domain you’d like to enrich:
https://companyenrichment.abstractapi.com/v1
? api_key = YOUR_UNIQUE_API_KEY
& domain = airbnb.com
This was a successful request, so the company details associated with the domain are returned below:
{
"name": "Airbnb",
"domain": "airbnb.com",
"year_founded": 2008,
"industry": "Internet",
"employees_count": 14604,
"locality": "San Francisco",
"country": "United States",
"linkedin_url": "linkedin.com/company/airbnb"
}
Request parameters
Your unique API key. Note that each user has unique API keys for each of Abstract’s APIs, so your Company Enrichment API key will not work for your IP Geolocation API, for example.
The domain of the company you want to get data from.
You can chose to only receive a few fields from the JSON response. To do so, you can include a fields value in the query parameters with a comma separated list of the top-level keys you want to be returned. For example, adding ?fields=city will return only the city in the JSON response.
Response parameters
The API response is returned in a universal and lightweight JSON format.
The name of the company.
The domain the company website is hosted on.
The country the company is based in.
The city or regiont he company headquarter is based in.
The approximate number of employees of the company.
The industry the company is operating in.
The year the company was founded.
The linkedin URL of the company.
Response and error codes
Whenever you make a request that fails for some reason, an error is returned also in the JSON format. The errors include an error code and description, which you can find in detail below.
Code | Type | Details |
---|---|---|
200 | OK | Everything worked as expected. |
204 | OK | Their is no location data for the submitted IP. |
400 | Bad request | Bad request. |
401 | Unauthorized | The request was unacceptable. Typically due to the API key missing or incorrect. |
422 | Quota reached | The request was aborted due to insufficient API credits. |
429 | Too many requests | The request was aborted due to the number of allowed requests per second being reached. This happens on free plans as requests are limited to 1 per second. |
500 | Internal server error | The request could not be completed due to an error on the server side. |
503 | Service unavailable | The server was unavailable. |
Possible responses
The country and industry fields have a limited number of possible responses as listed below:
Field: industry
The industry field can take any of the values listed below:
Industry |
---|
Accounting |
Airlines/Aviation |
Alternative Dispute Resolution |
Alternative Medicine |
Animation |
Apparel & Fashion |
Architecture & Planning |
Arts And Crafts |
Automotive |
Aviation & Aerospace |
Banking |
Biotechnology |
Broadcast Media |
Building Materials |
Business Supplies And Equipment |
Capital Markets |
Chemicals |
Civic & Social Organization |
Civil Engineering |
Commercial Real Estate |
Computer Games |
Computer Hardware |
Computer Networking |
Computer & Network Security |
Computer Software |
Construction |
Consumer Electronics |
Consumer Goods |
Consumer Services |
Cosmetics |
Dairy |
Defense & Space |
Design |
Education Management |
E-Learning |
Electrical/Electronic Manufacturing |
Entertainment |
Environmental Services |
Events Services |
Executive Office |
Facilities Services |
Farming |
Financial Services |
Fine Art |
Fishery |
Food & Beverages |
Food Production |
Fund-Raising |
Furniture |
Gambling & Casinos |
Glass, Ceramics & Concrete |
Government Administration |
Government Relations |
Graphic Design |
Health, Wellness And Fitness |
Higher Education |
Hospital & Health Care |
Hospitality |
Human Resources |
Import And Export |
Individual & Family Services |
Industrial Automation |
Information Services |
Information Technology And Services |
Insurance |
International Affairs |
International Trade And Development |
Internet |
Investment Banking |
Investment Management |
Judiciary |
Law Enforcement |
Law Practice |
Legal Services |
Legislative Office |
Leisure, Travel & Tourism |
Libraries |
Logistics And Supply Chain |
Luxury Goods & Jewelry |
Machinery |
Management Consulting |
Maritime |
Marketing And Advertising |
Market Research |
Mechanical Or Industrial Engineering |
Media Production |
Medical Devices |
Medical Practice |
Mental Health Care |
Military |
Mining & Metals |
Motion Pictures And Film |
Museums And Institutions |
Music |
Nanotechnology |
Newspapers |
Non-Profit Organization Management |
Nonprofit Organization Management |
Oil & Energy |
Online Media |
Outsourcing/Offshoring |
Package/Freight Delivery |
Packaging And Containers |
Paper & Forest Products |
Performing Arts |
Pharmaceuticals |
Philanthropy |
Photography |
Plastics |
Political Organization |
Primary/Secondary Education |
Printing |
Professional Training & Coaching |
Program Development |
Public Policy |
Public Relations And Communications |
Public Safety |
Publishing |
Railroad Manufacture |
Ranching |
Real Estate |
Recreational Facilities And Services |
Religious Institutions |
Renewables & Environment |
Research |
Restaurants |
Retail |
Security And Investigations |
Semiconductors |
Shipbuilding |
Sporting Goods |
Sports |
Staffing And Recruiting |
Supermarkets |
Telecommunications |
Textiles |
Think Tanks |
Tobacco |
Translation And Localization |
Transportation/Trucking/Railroad |
Utilities |
Venture Capital & Private Equity |
Veterinary |
Warehousing |
Wholesale |
Wine And Spirits |
Wireless |
Writing And Editing |
Field: country
The country field can take can take any of the values listed below:
Country |
---|
Afghanistan |
Åland Islands |
Albania |
Algeria |
American Samoa |
Andorra |
Angola |
Anguilla |
Antigua And Barbuda |
Argentina |
Armenia |
Aruba |
Australia |
Austria |
Azerbaijan |
Bahamas |
Bahrain |
Bangladesh |
Barbados |
Belarus |
Belgium |
Belize |
Benin |
Bermuda |
Bhutan |
Bolivia |
Bosnia And Herzegovina |
Botswana |
Brazil |
British Virgin Islands |
Brunei |
Bulgaria |
Burkina Faso |
Burundi |
Cambodia |
Cameroon |
Canada |
Cape Verde |
Caribbean Netherlands |
Cayman Islands |
Central African Republic |
Chad |
Chile |
China |
Colombia |
Comoros |
Cook Islands |
Costa Rica |
Côte D’Ivoire |
Croatia |
Cuba |
Curaçao |
Cyprus |
Czechia |
Democratic Republic Of The Congo |
Denmark |
Djibouti |
Dominica |
Dominican Republic |
Ecuador |
Egypt |
El Salvador |
Equatorial Guinea |
Eritrea |
Estonia |
Ethiopia |
Faroe Islands |
Fiji |
Finland |
France |
French Guiana |
French Polynesia |
Gabon |
Gambia |
Georgia |
Germany |
Ghana |
Gibraltar |
Greece |
Greenland |
Grenada |
Guadeloupe |
Guam |
Guatemala |
Guernsey |
Guinea |
Guinea-Bissau |
Guyana |
Haiti |
Honduras |
Hong Kong |
Hungary |
Iceland |
India |
Indonesia |
Iran |
Iraq |
Ireland |
Isle Of Man |
Israel |
Italy |
Jamaica |
Japan |
Jersey |
Jordan |
Kazakhstan |
Kenya |
Kiribati |
Kosovo |
Kuwait |
Kyrgyzstan |
Laos |
Latvia |
Lebanon |
Lesotho |
Liberia |
Libya |
Liechtenstein |
Lithuania |
Luxembourg |
Macau |
Macedonia |
Madagascar |
Malawi |
Malaysia |
Maldives |
Mali |
Malta |
Marshall Islands |
Martinique |
Mauritania |
Mauritius |
Mayotte |
Mexico |
Micronesia |
Moldova |
Monaco |
Mongolia |
Montenegro |
Montserrat |
Morocco |
Mozambique |
Myanmar |
Namibia |
Nepal |
Netherlands |
Netherlands Antilles |
New Caledonia |
New Zealand |
Nicaragua |
Niger |
Nigeria |
Niue |
Norfolk Island |
North Korea |
Northern Mariana Islands |
Norway |
Oman |
Pakistan |
Palau |
Palestine |
Panama |
Papua New Guinea |
Paraguay |
Peru |
Philippines |
Poland |
Portugal |
Puerto Rico |
Qatar |
Republic Of The Congo |
Réunion |
Romania |
Russia |
Rwanda |
Saint Barthélemy |
Saint Helena |
Saint Kitts And Nevis |
Saint Lucia |
Saint Martin |
Saint Pierre And Miquelon |
Saint Vincent And The Grenadines |
Samoa |
San Marino |
São Tomé And Príncipe |
Saudi Arabia |
Senegal |
Serbia |
Seychelles |
Sierra Leone |
Singapore |
Sint Maarten |
Slovakia |
Slovenia |
Solomon Islands |
Somalia |
South Africa |
South Korea |
South Sudan |
Spain |
Sri Lanka |
Sudan |
Suriname |
Svalbard And Jan Mayen |
Swaziland |
Sweden |
Switzerland |
Syria |
Taiwan |
Tajikistan |
Tanzania |
Thailand |
Timor-Leste |
Togo |
Tonga |
Trinidad And Tobago |
Tunisia |
Turkey |
Turkmenistan |
Turks And Caicos Islands |
Tuvalu |
U.S. Virgin Islands |
Uganda |
Ukraine |
United Arab Emirates |
United Kingdom |
United States |
Uruguay |
Uzbekistan |
Vanuatu |
Venezuela |
Vietnam |
Western Sahara |
Yemen |
Zambia |
Zimbabwe |
Code samples and libraries
Please see the top of this page for code samples for these languages and more. If we’re missing a code sample, or if you’d like to contribute a code sample or library in exchange for free credits, email us at: team@abstractapi.com
Other notes
A note on metered billing: Each individual domain you submit for lookup counts as a credit used. Credits are also counted per request, not per successful response. So if you submit a request for the (invalid) domain “kasj8929hs”, that still counts as 1 credit.
curl --request GET \
--url https://companyenrichment.abstractapi.com/v1
{
"name": "Airbnb",
"domain": "airbnb.com",
"year_founded": 2008,
"industry": "Internet",
"employees_count": 14604,
"locality": "San Francisco",
"country": "United States",
"linkedin_url": "linkedin.com/company/airbnb"
}