Enrich a company

This endpoint allows you to enrich a company with its complete accurate B2B data.

Important note: When possible, it is recommended to use our Bulk Enrich Company endpoint instead for faster response time. It allows you to enrich up to 50 companies at once, instead of performing 50 individual requests.

How are credits spent?

Enriching a company record cost 1 credit per match.
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/enrich-company
Method: POST
Headers:
- X-KEY: your_api_key
- Content-Type: application/json

Parameters

Parameter	Example value	Description
`data` ^required	`See below`	The company to enrich. See below for complete details.

Data parameter

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

Datapoint	Example value	Description
`company_website` ^optional	`deloitte.com`	The company website.
`company_linkedin_url` ^optional	`https://linkedin.com/company/deloitte`	The company’s LinkedIn URL.
`company_name` ^optional	`Deloitte`	The company name. We discourage using solely the company name for enrichment, as many company have the same name. Prioritize the `company_website` or `company_linkedin_url`.

Minimum requirements for matching

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

Important note #1: We advise strongly against using only the company_name for matching. Many company have the same name, and this can result in mismatch/inaccurate results. Whenever possible, try to use at least the company_website.

Important note #2: the more datapoints you submit, the better, so whenever possible, submit everything you have for greater accuracy. For example, it is better to submit company_website and company_linkedin_url together rather than just one of them.

Example request

Simple request that always returns a result if a company is matched.

In this example, we used the company_website. This request will perform better than a request with only the company_name.


POST "https://api.prospeo.io/enrich-company"
X-KEY: "your_api_key"
Content-Type: "application/json"
 
{
   "data": {
       "company_website": "intercom.com"
   }
}

Response

This response contains all the possible fields and their example value. When a field is unavailable, it will be null.

You can find the details of every company field here.

For error handling, see the error codes at the bottom of the page here.


{
	"error": false,
	"free_enrichment": false,
	"company": {
		"company_id": "63f53afe4ceeca00016bdd2f",
		"name": "Prospeo.io",
		"website": "https://prospeo.io",
		"domain": "prospeo.io",
		"other_websites": [],
		"description": "Say stop to bad quality data - find leads that respond.",
		"description_seo": "Prospeo is the most accurate email finder. Find emails from everywhere with our free tools.",
		"description_ai": "Prospeo is a searchable database of leads, offering quality data through verified emails and mobiles of B2B contacts.",
		"type": "Public",
		"industry": "Environmental Services",
		"employee_count": 4631,
		"employee_range": "1000-5000",
		"location": {
			"country": "Canada",
			"country_code": "CA",
			"state": "Ontario",
			"city": "Toronto",
			"raw_address": "Suite 1102, 20 Eglinton Ave W, M4R 1K8, Toronto, Canada"
		},
		"sic_codes": [
			"5045"
		],
		"naics_codes": [],
		"email_tech": {
			"domain": "prospeo.io",
			"mx_provider": "GOOGLE",
			"catch_all_domain": false
		},
		"linkedin_url": "http://www.linkedin.com/company/prospeoio",
		"twitter_url": "https://x.com/prospeoio/",
		"facebook_url": "https://www.facebook.com/prospeoio",
		"crunchbase_url": "https://www.crunchbase.com/organization/venture-capital",
		"instagram_url": "https://instagram.com/prospeoio/",
		"youtube_url": "https://youtuce.com/prospeoio/",
		"phone_hq": {
			"phone_hq": "+1 234 567 8900",
			"phone_hq_national": "234 567 8900",
			"phone_hq_international": "+12345678900",
			"phone_hq_country": "United States",
			"phone_hq_country_code": "US"
		},
		"linkedin_id": "18511550",
		"founded": 2015,
		"revenue_range": {
			"min": 5000000000,
			"max": 10000000000
		},
		"revenue_range_printed": "$ 5B-10B+",
		"keywords": [
			"Data quality",
			"B2B data",
			"Leads list"
		],
		"logo_url": "https://prospeoassets.s3.us-east-1.amazonaws.com/company_logo/GF45H5U785G18.jpg",
		"attributes": {
			"has_demo": false,
			"has_free_trial": true,
			"has_downloadable": false,
			"has_mobile_apps": null,
			"has_online_reviews": true,
			"has_pricing": true
		},
		"funding": {
			"count": 1,
			"total_funding": 1000000,
			"total_funding_printed": "$1M",
			"latest_funding_date": "2025-05-11",
			"latest_funding_stage": "Series A",
			"funding_events": [
				{
					"amount": 1000000,
					"amount_printed": "$1M",
					"raised_at": "2025-05-11",
					"stage": "Series A",
					"link": "https://www.crunchbase.com/funding_round/iq-business-south-africa-private-equity--6b34a99a"
				}
			]
		},
		"technology": {
			"count": 3,
			"technology_names": [
				"Google Analytics",
				"Mailchimp",
				"Outlook"
			],
			"technology_list": [
				{
					"name": "Google Analytics",
					"category": "Analytics"
				},
				{
					"name": "Mailchimp",
					"category": "Webmail"
				},
				{
					"name": "Outlook",
					"category": "Webmail"
				}
			]
		},
		"job_postings": {
			"active_count": 1,
			"active_titles": [
				"Rust engineer"
			]
		}
	}
}

Response details

Property	Type	Description
`error`	boolean	Indicates if an error has occurred. If `false`, the request was successful. If `true`, an error has occurred and a `error_code` property will be present. See below.
`free_enrichment`	boolean	Indicates whether you were charged. This will be `true` if you enriched the record in the past.
`company`	object	The matched company. See our up-to-date company fields in details here.

Error codes

HTTP code	`error_code` property	Meaning
`400`	`NO_MATCH`	We couldn’t match the data you provided with a company record.
`400`	`INSUFFICIENT_CREDITS`	You do not have enough credit to perform the request.
`401`	`INVALID_API_KEY`	Invalid API key, check your `X-KEY` header.
`429`	`RATE_LIMITED`	You hit the rate limit for your current plan.
`400`	`INVALID_REQUEST`	The request your submitted is invalid.
`400`	`INTERNAL_ERROR`	An error occurred on our side, please contact the support.

Rate limit

See our rate limits page.