Enrichment API
Single Company Enrichment
Search for companies using criteria such as company name, company website, and more.
Note: At least one combination of company_website or company_name is required in the request.
Request
POST
/company
company_namestringin body
The name of the company where the person works.
Max Length:
255
Example:
ExampleCorp
company_websitestringin body
The website of the company associated with the person.
Example:
https://example.com
metadataobjectin body
top_matches_returnednumber
The number of top matching companies to return in the response.
Can be set between 1 and 10 to retrieve multiple company records based on the search criteria.
Default:
1
Maximum: 10
Minimum: 1
Example:
1
Response
200
400
401
403
429
Single Company Enrichment Success data.
companiesarrayrequired
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_fieldsobjectrequired
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:
{"website":"example.com","name":"ExampleCorp"}
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_fieldsstringrequired
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:
{"website":"example.com","name":"ExampleCorp"}
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
Remaining contact credits after contact enrichment.
Example:
10
Request Sample
curl -X POST "https://api.selling.com/company" \
-H "Authorization: Bearer your_api_key_here" \
-H "Content-Type: application/json" \
-d '{
"company_name": "ExampleCorp",
"company_website": "https://example.com",
"metadata": {
"top_matches_returned": 1
}
}'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": {
"website": "example.com",
"name": "ExampleCorp"
},
"custom_fields": {
"website": "example.com",
"name": "ExampleCorp"
}
}
],
"remaining_credits": 10
}