Enrichment API
Bulk Company Enrichment Results
This endpoint allows users to retrieve the results of a completed bulk
company enrichment job, which was initiated via the /companies endpoint.
After submitting a batch of companies for enrichment, users can access the processed
data from this URL. The results will be returned in JSON format and will include
details for each company that was processed. Note that after the expiration date,
the results will no longer be available, and the data will be permanently deleted.
This endpoint allows users to retrieve the results of a completed bulk company
enrichment job. After submitting a batch of companies for verification,
users can access the processed data from this URL. The results will be available
in JSON format and will include details for each company that was processed.
Request
GET
/companies/results/{job_id}.json
job_idstringrequiredin path
A unique identifier for the background process handling the bulk enrichment request.
Example:
e01f423b-70f8-4911-93c7-97a07155354e
Response
200
202
400
401
403
404
429
Bulk Company Enrichment Results.
companiesarrayrequired
An array containing the enriched company data. Each company in the array
represents a processed result with details such as website, name, and phone number.
credit_chargedbooleanrequired
Credit charged for email OR contact phone OR Mobile phone.
Example:
true
curated_listsstringrequired
Any curated lists or special mentions the company is included in. Provides additional context about the company's recognition or placement.
Example:
Fortune 1000
custom_fieldsobject
A dictionary of custom metadata associated with the company.
This can include fields like Salesforce IDs, external IDs, or other user-defined data.
Example:
{"id":"id_123","salesforce_key":"key_123"}
descriptionstringrequired
A brief overview of the company. Describes the company's business focus and key activities in a few sentences.
Example:
ExampleCorp is a multinational technology company specializing in internet-related services and products.
employees_categorystringrequired
The general range of the company's number of employees. Indicates the size of the organization for context on its scale.
Example:
10,001+
employees_numbernumberrequired
The exact number of employees at the company. Provides specific data on the company's workforce size.
Example:
100000
errorstringrequired
Reason of error if contact is not enriched.
Example:
You have run out of API credits. Some of the submitted records were not enriched. Please contact support to purchase more credits.
facebookstringrequired
The Facebook page URL of the company. Offers a link to the company's social media presence on Facebook.
Example:
https://www.facebook.com/ExampleCorp
hq_address_1stringrequired
The first line of the company's headquarters address. Provides the primary location details for the company's main office.
Example:
1600 Amphitheatre Pkwy
hq_address_2stringrequired
The second line of the company's headquarters address, if applicable. Used for additional address details or suite numbers.
Example:
8200 Ruby Heights Ave
hq_citystringrequired
The city where the company's headquarters is located. Helps in identifying the primary business location.
Example:
Mountain View
hq_countrystringrequired
The country where the company's headquarters is located. Indicates the nation of the company's primary office.
Example:
United States
hq_statestringrequired
The state where the company's headquarters is located. Provides regional context for the company's main office.
Example:
California
hq_zip_codestringrequired
The zip code of the company's headquarters address. Used for precise geographic identification of the company's location.
Example:
94043
industrystringrequired
The industry or sector in which the company operates. Helps in understanding the company's primary business activities.
Example:
Information Technology and Services
linkedinstringrequired
The LinkedIn profile URL of the company. Provides a link to the company's professional network page for more details and connections.
Example:
https://www.linkedin.com/company/ExampleCorp
naics_codenumberrequired
The North American Industry Classification System (NAICS) code for the company. Provides a detailed industry classification.
Example:
518210
namestringrequired
The official name of the company. Identifies the organization and provides context about its identity.
Example:
ExampleCorp
number_of_available_locationsnumberrequired
The total number of physical locations or offices the company has. Indicates the geographic spread of the organization.
Example:
158
original_fieldsstring
An object containing the original fields passed by the user in the initial request.
This ensures that users can cross-reference the enriched data with their original input.
Example:
{"first_name":"John","last_name":"Doe","email":"john.doe@example.com"}
phonestringrequired
The primary company phone number for the company. Used for business inquiries and communication.
Example:
+16502530000
recent_funding_amountnumberrequired
The amount of money raised in the most recent funding round. Provides specific data on the latest financial investment received by the company.
Example:
41300000
recent_funding_datestringrequired
The date of the most recent funding round or investment. Shows the latest update on the company’s financial backing.
Example:
03/23/2021
recent_funding_roundstringrequired
The type of funding round in the most recent investment. Indicates the nature of the financial event, such as Series A, B, etc.
Example:
Unknown
revenue_categorystringrequired
The revenue range of the company. Shows the financial scale of the organization for additional context about its market position.
Example:
$1+ Billion
revenue_numbernumberrequired
The exact revenue figure for the company. Provides specific data on the company's financial performance.
Example:
100000
sic_codenumberrequired
The Standard Industrial Classification (SIC) code for the company. Identifies the primary industry and sector the company operates in.
Example:
7374
twitterstringrequired
The Twitter handle of the company. Provides a link to the company's official Twitter profile for updates and interactions.
Example:
https://twitter.com/ExampleCorp
websitestringrequired
The official website of the company. Provides a link to the company's online presence for more information and resources.
Example:
exmaple.com
year_foundednumberrequired
The year the company was founded. Provides historical context about the establishment of the organization.
Example:
1970
youtubestringrequired
The YouTube channel URL of the company. Offers a link to the company's video content on YouTube.
Example:
www.youtube.com/user/ExampleCorp
remaining_creditsnumberrequired
The number of credits remaining after the bulk company enrichment operation.
This indicates how many more enrichment requests the user can make.
Example:
999999
Request Sample
curl -X GET "https://api.selling.com/companies/results/e01f423b-70f8-4911-93c7-97a07155354e.json" \
-H "Authorization: Bearer your_api_key_here" \
-H "Content-Type: application/json"Response Sample
{
"companies": [
{
"error": "You have run out of API credits. Some of the submitted records were not enriched. Please contact support to purchase more credits.",
"credit_charged": true,
"website": "exmaple.com",
"name": "ExampleCorp",
"phone": "+16502530000",
"employees_category": "10,001+",
"employees_number": 100000,
"revenue_category": "$1+ Billion",
"revenue_number": 100000,
"sic_code": 7374,
"naics_code": 518210,
"industry": "Information Technology and Services",
"linkedin": "https://www.linkedin.com/company/ExampleCorp",
"facebook": "https://www.facebook.com/ExampleCorp",
"twitter": "https://twitter.com/ExampleCorp",
"youtube": "www.youtube.com/user/ExampleCorp",
"curated_lists": "Fortune 1000",
"number_of_available_locations": 158,
"description": "ExampleCorp is a multinational technology company specializing in internet-related services and products.",
"year_founded": 1970,
"recent_funding_date": "03/23/2021",
"recent_funding_amount": 41300000,
"recent_funding_round": "Unknown",
"hq_address_1": "1600 Amphitheatre Pkwy",
"hq_address_2": "8200 Ruby Heights Ave",
"hq_city": "Mountain View",
"hq_state": "California",
"hq_zip_code": "94043",
"hq_country": "United States",
"original_fields": {
"first_name": "John",
"last_name": "Doe",
"email": "john.doe@example.com"
},
"custom_fields": {
"id": "id_123",
"salesforce_key": "key_123"
}
}
],
"remaining_credits": 999999
}