Enrich up to 50 company records at once

This endpoint allows you to enrich multiple company’s in one request while staying blazing-fast.

How are credits spent?

• One credit is spent per matched company.
• You won’t be charged if no results are found.
• You won’t be charged if you enrich the same record twice in the lifetime of your account.

Endpoint

• URL: https://api.prospeo.io/bulk-enrich-company 
• Method: POST
• Headers:
  • X-KEY: your_api_key
  • Content-Type: application/json

Parameters

Data parameter

The data parameter for the /bulk-enrich-company endpoint is a list of all the companies you wish to enrich.

The data parameter contains the datapoints you have for us to identify the record. We offer the following matching datapoints:

Minimum requirements for matching

We require at least one of the above datapoint to accurately match a company.

Example request

We generated our own identifier (1,2,3,4,5) so that in case of a match, we can reconcile it with the response.

In the below request, the identifier 4 contains an property (full_name). Hence, this record will be ignored and provided in the invalid_datapoints list of the response.

POST "https://api.prospeo.io/bulk-enrich-company"
X-KEY: "your_api_key"
Content-Type: "application/json"
 
{
   "data": [
   	{
   		"identifier": "1",
   		"company_website": "intercom.com"
   	},
   	{
   		"identifier": "2",
   		"company_linkedin_url": "https://www.linkedin.com/company/deloitte"
   	},
   	{
   		"identifier": "3",
   		"company_name":  "Milka"
   	},
   	{
   		"identifier": "4",
   		"full_name":  "Pinterest"
   	},
   	... up to 50 objects
   ]
}

Response

The response structure is as follow:

{
	"error": false,
	"total_cost": 10,
	"not_matched": ["3"],
	"invalid_datapoints": ["4"],
	"matched": [
		{
			"identifier": "1",
			"company": {
				...
			}
		},
		{
			"identifier": "2",
			"company": {
				...
			}
		}
	]
}

Response details

Error codes

Rate limit

See our rate limits page.