curl --request POST \
--url https://api.datalayer.so/v1/companies/profile \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"company_id": "<string>",
"domain": "<string>",
"name": "<string>",
"profile_url": "<string>",
"include": [],
"max_credits": 1,
"dry_run": true
}
'import requests
url = "https://api.datalayer.so/v1/companies/profile"
payload = {
"company_id": "<string>",
"domain": "<string>",
"name": "<string>",
"profile_url": "<string>",
"include": [],
"max_credits": 1,
"dry_run": True
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
company_id: '<string>',
domain: '<string>',
name: '<string>',
profile_url: '<string>',
include: [],
max_credits: 1,
dry_run: true
})
};
fetch('https://api.datalayer.so/v1/companies/profile', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"data": {
"company_id": "<string>",
"name": "<string>",
"website": "<string>",
"profile_url": "<string>",
"description": "<string>",
"logo_url": "<string>",
"founded_year": 1,
"company_type": "<string>",
"employee_count": 1,
"employee_size": "<string>",
"headquarters": {
"city": "<string>",
"region": "<string>",
"country": "<string>"
},
"locations": [
{
"address": "<string>",
"is_primary": true
}
],
"industries": [
{
"name": "<string>",
"is_primary": true
}
],
"specialties": [
"<string>"
],
"industry_codes": {
"sic": [
{
"code": "<string>",
"name": "<string>"
}
],
"naics": [
{
"code": "<string>",
"name": "<string>"
}
]
},
"source_updated_at": "<string>",
"coverage_note": "<string>",
"domain": "<string>",
"resolution": {
"basis": "company_id",
"ambiguous": false
},
"evidence": {
"source": "<string>",
"source_url": "<string>",
"source_updated_at": "<string>",
"retrieved_at": "2023-11-07T05:31:56Z",
"coverage_note": "<string>"
},
"sections": {
"workforce": {
"status": "not_requested",
"reason": "<string>",
"partial": true,
"truncated": true,
"limit": 4503599627370495,
"source_total": 4503599627370495,
"evidence": {
"source": "<string>",
"source_url": "<string>",
"source_updated_at": "<string>",
"retrieved_at": "2023-11-07T05:31:56Z",
"coverage_note": "<string>"
},
"data": {
"observations": [
{
"date": "2023-12-25",
"employee_count": 4503599627370495
}
],
"employee_change": {
"from_date": "2023-12-25",
"through_date": "2023-12-25",
"absolute": 123,
"percent": 123
}
},
"cause": "<string>"
},
"team": {
"status": "not_requested",
"reason": "<string>",
"partial": true,
"truncated": true,
"limit": 4503599627370495,
"source_total": 4503599627370495,
"evidence": {
"source": "<string>",
"source_url": "<string>",
"source_updated_at": "<string>",
"retrieved_at": "2023-11-07T05:31:56Z",
"coverage_note": "<string>"
},
"data": [
{
"tag_id": "<string>",
"label": "<string>",
"indexed_current": 4503599627370495,
"first_observed": "<string>",
"last_observed": "<string>"
}
],
"cause": "<string>"
},
"hiring": {
"status": "not_requested",
"reason": "<string>",
"partial": true,
"truncated": true,
"limit": 4503599627370495,
"source_total": 4503599627370495,
"evidence": {
"source": "<string>",
"source_url": "<string>",
"source_updated_at": "<string>",
"retrieved_at": "2023-11-07T05:31:56Z",
"coverage_note": "<string>"
},
"data": [
{
"job_id": "<string>",
"title": "<string>",
"location": "<string>",
"country": "<string>",
"posted_at": "<string>",
"source_url": "<string>",
"company_id": "<string>",
"company_name": "<string>",
"match_basis": "company_id"
}
],
"summary": {
"window_days": 90,
"indexed_posting_count": 4503599627370495,
"count_relation": "eq",
"by_function": [
{
"label": "<string>",
"count": 4503599627370495
}
],
"by_seniority": [
{
"label": "<string>",
"count": 4503599627370495
}
],
"top_titles": [
{
"label": "<string>",
"count": 4503599627370495
}
],
"median_days_open": 1,
"days_open_sample_size": 20,
"function_headcount": [
{
"tag_id": "<string>",
"label": "<string>",
"indexed_current": 4503599627370495,
"observations": [
{
"month": "2023-12-25",
"indexed_count": 4503599627370495
}
],
"truncated": true
}
],
"coverage_note": "<string>"
},
"cause": "<string>"
},
"activity": {
"status": "not_requested",
"reason": "<string>",
"partial": true,
"truncated": true,
"limit": 4503599627370495,
"source_total": 4503599627370495,
"evidence": {
"source": "<string>",
"source_url": "<string>",
"source_updated_at": "<string>",
"retrieved_at": "2023-11-07T05:31:56Z",
"coverage_note": "<string>"
},
"data": [
{
"text": "<string>",
"posted_at": "<string>",
"source_url": "<string>",
"is_repost": true
}
],
"cause": "<string>"
}
}
},
"meta": {
"retrieved_at": "2023-11-07T05:31:56Z",
"billing_status": "credits_settled",
"profiles_used": 0,
"request_id": "<string>",
"contract_version": "2026-10-19",
"credit_version": "datalayer_credits_v1",
"upstream_requests": 4,
"lookup_requests": 4,
"credits_used": 1,
"receipt": {
"version": "datalayer_credits_v1",
"request_id": "<string>",
"reserved": 50,
"settled": 50,
"released": 50,
"items": [
{
"kind": "company",
"reference": "<string>",
"credits": 0,
"repeat": true
}
]
},
"replayed": true
}
}{
"error": {
"code": "<string>",
"message": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>"
}
}Get a company profile
Requested workforce (100 observations/past year), team (100 categories), hiring (10 postings/past 90 days, with function and seniority counts, top titles and median days open where close dates exist) and activity (five cached posts) are bundled. Hiring counts are indexed postings, not confirmed hires. Sections report not_requested/available/no_data/unavailable independently of partial/truncated coverage. Names alone require disambiguation. A website technology stack is not included; use get_tech_stack.
curl --request POST \
--url https://api.datalayer.so/v1/companies/profile \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"company_id": "<string>",
"domain": "<string>",
"name": "<string>",
"profile_url": "<string>",
"include": [],
"max_credits": 1,
"dry_run": true
}
'import requests
url = "https://api.datalayer.so/v1/companies/profile"
payload = {
"company_id": "<string>",
"domain": "<string>",
"name": "<string>",
"profile_url": "<string>",
"include": [],
"max_credits": 1,
"dry_run": True
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
company_id: '<string>',
domain: '<string>',
name: '<string>',
profile_url: '<string>',
include: [],
max_credits: 1,
dry_run: true
})
};
fetch('https://api.datalayer.so/v1/companies/profile', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"data": {
"company_id": "<string>",
"name": "<string>",
"website": "<string>",
"profile_url": "<string>",
"description": "<string>",
"logo_url": "<string>",
"founded_year": 1,
"company_type": "<string>",
"employee_count": 1,
"employee_size": "<string>",
"headquarters": {
"city": "<string>",
"region": "<string>",
"country": "<string>"
},
"locations": [
{
"address": "<string>",
"is_primary": true
}
],
"industries": [
{
"name": "<string>",
"is_primary": true
}
],
"specialties": [
"<string>"
],
"industry_codes": {
"sic": [
{
"code": "<string>",
"name": "<string>"
}
],
"naics": [
{
"code": "<string>",
"name": "<string>"
}
]
},
"source_updated_at": "<string>",
"coverage_note": "<string>",
"domain": "<string>",
"resolution": {
"basis": "company_id",
"ambiguous": false
},
"evidence": {
"source": "<string>",
"source_url": "<string>",
"source_updated_at": "<string>",
"retrieved_at": "2023-11-07T05:31:56Z",
"coverage_note": "<string>"
},
"sections": {
"workforce": {
"status": "not_requested",
"reason": "<string>",
"partial": true,
"truncated": true,
"limit": 4503599627370495,
"source_total": 4503599627370495,
"evidence": {
"source": "<string>",
"source_url": "<string>",
"source_updated_at": "<string>",
"retrieved_at": "2023-11-07T05:31:56Z",
"coverage_note": "<string>"
},
"data": {
"observations": [
{
"date": "2023-12-25",
"employee_count": 4503599627370495
}
],
"employee_change": {
"from_date": "2023-12-25",
"through_date": "2023-12-25",
"absolute": 123,
"percent": 123
}
},
"cause": "<string>"
},
"team": {
"status": "not_requested",
"reason": "<string>",
"partial": true,
"truncated": true,
"limit": 4503599627370495,
"source_total": 4503599627370495,
"evidence": {
"source": "<string>",
"source_url": "<string>",
"source_updated_at": "<string>",
"retrieved_at": "2023-11-07T05:31:56Z",
"coverage_note": "<string>"
},
"data": [
{
"tag_id": "<string>",
"label": "<string>",
"indexed_current": 4503599627370495,
"first_observed": "<string>",
"last_observed": "<string>"
}
],
"cause": "<string>"
},
"hiring": {
"status": "not_requested",
"reason": "<string>",
"partial": true,
"truncated": true,
"limit": 4503599627370495,
"source_total": 4503599627370495,
"evidence": {
"source": "<string>",
"source_url": "<string>",
"source_updated_at": "<string>",
"retrieved_at": "2023-11-07T05:31:56Z",
"coverage_note": "<string>"
},
"data": [
{
"job_id": "<string>",
"title": "<string>",
"location": "<string>",
"country": "<string>",
"posted_at": "<string>",
"source_url": "<string>",
"company_id": "<string>",
"company_name": "<string>",
"match_basis": "company_id"
}
],
"summary": {
"window_days": 90,
"indexed_posting_count": 4503599627370495,
"count_relation": "eq",
"by_function": [
{
"label": "<string>",
"count": 4503599627370495
}
],
"by_seniority": [
{
"label": "<string>",
"count": 4503599627370495
}
],
"top_titles": [
{
"label": "<string>",
"count": 4503599627370495
}
],
"median_days_open": 1,
"days_open_sample_size": 20,
"function_headcount": [
{
"tag_id": "<string>",
"label": "<string>",
"indexed_current": 4503599627370495,
"observations": [
{
"month": "2023-12-25",
"indexed_count": 4503599627370495
}
],
"truncated": true
}
],
"coverage_note": "<string>"
},
"cause": "<string>"
},
"activity": {
"status": "not_requested",
"reason": "<string>",
"partial": true,
"truncated": true,
"limit": 4503599627370495,
"source_total": 4503599627370495,
"evidence": {
"source": "<string>",
"source_url": "<string>",
"source_updated_at": "<string>",
"retrieved_at": "2023-11-07T05:31:56Z",
"coverage_note": "<string>"
},
"data": [
{
"text": "<string>",
"posted_at": "<string>",
"source_url": "<string>",
"is_repost": true
}
],
"cause": "<string>"
}
}
},
"meta": {
"retrieved_at": "2023-11-07T05:31:56Z",
"billing_status": "credits_settled",
"profiles_used": 0,
"request_id": "<string>",
"contract_version": "2026-10-19",
"credit_version": "datalayer_credits_v1",
"upstream_requests": 4,
"lookup_requests": 4,
"credits_used": 1,
"receipt": {
"version": "datalayer_credits_v1",
"request_id": "<string>",
"reserved": 50,
"settled": 50,
"released": 50,
"items": [
{
"kind": "company",
"reference": "<string>",
"credits": 0,
"repeat": true
}
]
},
"replayed": true
}
}{
"error": {
"code": "<string>",
"message": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>"
}
}get_company_profile. Supply exactly one canonical company_id, bare website domain or public
LinkedIn company profile_url. Domain/URL matches must agree with the returned
reference. A name alone returns an ambiguity error: search and choose a canonical
ID rather than silently selecting a similarly named business.
include: ["workforce", "team", "hiring", "activity"] requests the complete
bounded context for one credit with the base profile. All are off by default.
Inspect data.sections, evidence, source dates, partial/truncated coverage and
status. A valid base profile still costs one when optional context is unavailable.
Workforce: 100 observations/past year; team: 100 indexed categories; hiring: ten
postings from the past 90 days plus an indexed summary of counts by function and
seniority, top titles, and median days open where both a posted date and a close
date exist. A missing close date is excluded, not treated as still open.
Function headcount trend is included only when it fits the lookup budget.
Activity: five cached posts. Counts are indexed observations, not payroll, and
are not confirmed hires. Unknown dates stay null.
Eligible repeats and added context cost zero within 24 hours. dry_run and
max_credits are supported. A website technology stack is not included; use
get_tech_stack. Receipts and retries.Authorizations
Headers
Recommended for every paid operation. Account-scoped and bound to normalized operation/input. Retry exactly the same key after transport loss: a committed credit result is replayed from persisted normalized bytes without a data lookup or another debit. Changed input, key expiry or paid-anchor expiry returns 409. In-flight requests return request_in_progress. Network delivery and D1 commit are not atomic. If omitted a request ID is created.
1 - 128^[A-Za-z0-9_-]{1,128}$Body
- Option 1
- Option 2
- Option 3
- Option 4