Company Enrichment API
With Abstract’s Company Enrichment API, you can easily get detailed information about any company domain.
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 URLs and to use HTTP status codes to indicate errors.
HTTPS
The Company Enrichment API requires all communications to be secured with TLS 1.2 or greater.
API Versions
All of Abstract’s APIs are versioned. The Company Enrichment API is currently on Version 2.
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 APIs 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
Validation endpoint
Abstract’s Company Enrichment API simply requires your unique API key and the domain you’d like to enrich:
This was a successful request, so the company details associated with the domain are returned below:
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=domain will return only the domain in the JSON response.
Response parameters
The API response is returned in a universal and lightweight JSON format.
The domain the company website is hosted on.
The name of the company.
A brief description of the company.
The URL to download the company’s logo.
The year the company was founded.
The number and name of the street the company is based in.
The city or regiont he company headquarter is based in.
The state the company is based in.
The country the company is based in.
Country’s ISO 3166-1 alpha-2 code.
ZIP or postal code.
Decimal of the latitude.
Decimal of the longitude.
Code that indicates the industry of the company
Code that indicates the industry of the company
The industry the company is operating in.
The approximate number of employees of the company.
The approximate range of employees of the company.
The approximate annual reveneu of the company.
The approximate range of revenue of the company.
Array with the phone numbers of the company.
Array with the emails addresess to contact the company.
Indicates if the company is public or private.
If the company is public, it will show the company’s ticker.
If the company is public, it will show the company’s exchange.
Indicates if the company is listes on the Umbrella top 1 Million companies.
Array with the company’s tags.
Array with the company’s tech tags.
Linkedin URL
Facebook URL
Twitter/X URL
Instagram URL
Crunchbase URL
Response and error codes
Whenever you make a request that fails for some reason, an error is returned in JSON format. The errors include an error code and description, which you can find detailed below.
| Code | Type | Details |
|---|---|---|
| 200 | OK | Everything worked as expected. |
| 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. (Free plans) |
| 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. |
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 counted per request, not per successful response. So if you submit a request for the (invalid) domain “kasj8929hs”, that still counts as 1 credit.