curl -X POST https://api.dataforb2b.ai/enrich/company \
-H "api_key: YOUR_api_key" \
-H "Content-Type: application/json" \
-d '{
"company_identifier": "google"
}'
import requests
response = requests.post(
"https://api.dataforb2b.ai/enrich/company",
headers={
"api_key": "YOUR_api_key",
"Content-Type": "application/json"
},
json={
"company_identifier": "google"
}
)
data = response.json()
company = data.get('company')
print(f"Company: {company['name']}")
print(f"Industry: {company['industry']}")
print(f"Employees: {company['size']['employees']}")
print(f"Followers: {company['metrics']['followers']}")
const response = await fetch('https://api.dataforb2b.ai/enrich/company', {
method: 'POST',
headers: {
'api_key': 'YOUR_api_key',
'Content-Type': 'application/json'
},
body: JSON.stringify({
company_identifier: 'google'
})
});
const data = await response.json();
const company = data.company;
console.log('Company:', company.name);
console.log('Industry:', company.industry);
console.log('Employees:', company.size.employees);
console.log('Followers:', company.metrics.followers);
{
"company": {
"id": "<string>",
"name": "<string>",
"tagline": {},
"description": {},
"industry": {},
"headquarters": {
"country": "<string>",
"city": "<string>",
"region": "<string>"
},
"founded_year": {},
"company_type": {},
"logo_url": {},
"links": {
"website": {},
"linkedin": "<string>",
"twitter": {},
"instagram": {},
"facebook": {}
},
"size": {
"employees": 123,
"range_min": 123,
"range_max": {}
},
"metrics": {
"followers": 123
},
"signals": {
"verified": true,
"actively_hiring": true
},
"categories": [
{}
],
"locations": {
"country": "<string>",
"city": "<string>",
"region": "<string>",
"is_headquarters": true
},
"funding": {
"stage": "<string>",
"total_rounds": 123,
"last_round_amount": {},
"last_round_currency": {},
"last_round_date": {},
"rounds": [
{}
],
"investors": {},
"other_investors_count": {}
},
"growth": {
"percent_1m": 123,
"percent_6m": 123,
"percent_12m": 123
}
},
"credits_used": 123
}Enrichment
Enrich Company
Enrich a company with all its data (general info, metrics, growth, funding, etc.)
POST
/
enrich
/
company
curl -X POST https://api.dataforb2b.ai/enrich/company \
-H "api_key: YOUR_api_key" \
-H "Content-Type: application/json" \
-d '{
"company_identifier": "google"
}'
import requests
response = requests.post(
"https://api.dataforb2b.ai/enrich/company",
headers={
"api_key": "YOUR_api_key",
"Content-Type": "application/json"
},
json={
"company_identifier": "google"
}
)
data = response.json()
company = data.get('company')
print(f"Company: {company['name']}")
print(f"Industry: {company['industry']}")
print(f"Employees: {company['size']['employees']}")
print(f"Followers: {company['metrics']['followers']}")
const response = await fetch('https://api.dataforb2b.ai/enrich/company', {
method: 'POST',
headers: {
'api_key': 'YOUR_api_key',
'Content-Type': 'application/json'
},
body: JSON.stringify({
company_identifier: 'google'
})
});
const data = await response.json();
const company = data.company;
console.log('Company:', company.name);
console.log('Industry:', company.industry);
console.log('Employees:', company.size.employees);
console.log('Followers:', company.metrics.followers);
{
"company": {
"id": "<string>",
"name": "<string>",
"tagline": {},
"description": {},
"industry": {},
"headquarters": {
"country": "<string>",
"city": "<string>",
"region": "<string>"
},
"founded_year": {},
"company_type": {},
"logo_url": {},
"links": {
"website": {},
"linkedin": "<string>",
"twitter": {},
"instagram": {},
"facebook": {}
},
"size": {
"employees": 123,
"range_min": 123,
"range_max": {}
},
"metrics": {
"followers": 123
},
"signals": {
"verified": true,
"actively_hiring": true
},
"categories": [
{}
],
"locations": {
"country": "<string>",
"city": "<string>",
"region": "<string>",
"is_headquarters": true
},
"funding": {
"stage": "<string>",
"total_rounds": 123,
"last_round_amount": {},
"last_round_currency": {},
"last_round_date": {},
"rounds": [
{}
],
"investors": {},
"other_investors_count": {}
},
"growth": {
"percent_1m": 123,
"percent_6m": 123,
"percent_12m": 123
}
},
"credits_used": 123
}Credit Cost
| Data Type | Credits |
|---|---|
| Full company info | 1.5 credits |
Request Body
string
required
Company identifier. Supports multiple formats:
- Universal name (slug):
google,microsoft,apple - Full URL:
https://www.linkedin.com/company/google/ - Short URL:
linkedin.com/company/google - Encoded ID:
org_0lox54iG5IEZSb71mZWLR8z9CVPs8v1Lj8oQ— theidreturned by Search Company and Typeahead - Twitter/X URL or handle:
https://x.com/google,x.com/google,@google
With a Twitter/X identifier, the company is resolved from its X profile and matched to enrich firmographic data. Pass a LinkedIn identifier when you have one for the most complete results.
Response
object
Complete company data with all available information
Show company properties
Show company properties
string
Encoded company ID (org_xxx)
string
Company name
string | null
Company tagline/slogan
string | null
Full company description
string | null
Industry
object | null
number | null
Year the company was founded
string | null
Type of company (e.g., “Public Company”, “Private”, “Nonprofit”)
string | null
Company logo URL
object
object
object
array
Array of company categories/tags (strings)
array | null
object | null
Funding information
Show funding properties
Show funding properties
string
Funding stage (e.g.,
seed_round, series_a, series_b, post_ipo_equity)number
Total number of funding rounds
number | null
Amount of the last funding round, in
last_round_currencystring | null
Currency of the last round (e.g., “USD”)
string | null
Date of last funding round (YYYY-MM-DD format)
array
Funding rounds history. Each item has
round (e.g., series_a, seed_round), amount_usd (number or null) and date (YYYY-MM-DD).array | null
Investors, when known
number | null
Number of additional investors not listed
Companies resolved from a Twitter/X identifier return a reduced object built from the X profile:
headquarters is a free-text string, firmographic fields (industry, size, funding, growth…) are null, and a source: "twitter" field is added.number
Credits charged for this request.
Errors
| Status | detail | Cause |
|---|---|---|
| 400 | Invalid encoded company ID: ... | The org_ ID could not be decoded |
| 400 | Invalid company identifier: no company slug found in the URL. | A LinkedIn URL with no slug after /company/ |
| 404 | Company not found: ... | No company matches the identifier |
| 422 | (validation array) | company_identifier is missing, null, empty or blank |
curl -X POST https://api.dataforb2b.ai/enrich/company \
-H "api_key: YOUR_api_key" \
-H "Content-Type: application/json" \
-d '{
"company_identifier": "google"
}'
import requests
response = requests.post(
"https://api.dataforb2b.ai/enrich/company",
headers={
"api_key": "YOUR_api_key",
"Content-Type": "application/json"
},
json={
"company_identifier": "google"
}
)
data = response.json()
company = data.get('company')
print(f"Company: {company['name']}")
print(f"Industry: {company['industry']}")
print(f"Employees: {company['size']['employees']}")
print(f"Followers: {company['metrics']['followers']}")
const response = await fetch('https://api.dataforb2b.ai/enrich/company', {
method: 'POST',
headers: {
'api_key': 'YOUR_api_key',
'Content-Type': 'application/json'
},
body: JSON.stringify({
company_identifier: 'google'
})
});
const data = await response.json();
const company = data.company;
console.log('Company:', company.name);
console.log('Industry:', company.industry);
console.log('Employees:', company.size.employees);
console.log('Followers:', company.metrics.followers);