curl --request POST \
--url https://api.datalayer.so/v1/jobs/postings \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"query": "<string>",
"function": "<string>",
"seniority": "<string>",
"employment_type": "<string>",
"country": "<string>",
"location": "<string>",
"industry": "<string>",
"posted_within_days": 30,
"company_id": "<string>",
"company": "<string>",
"limit": 10,
"offset": 0,
"max_credits": 1,
"dry_run": true
}
'import requests
url = "https://api.datalayer.so/v1/jobs/postings"
payload = {
"query": "<string>",
"function": "<string>",
"seniority": "<string>",
"employment_type": "<string>",
"country": "<string>",
"location": "<string>",
"industry": "<string>",
"posted_within_days": 30,
"company_id": "<string>",
"company": "<string>",
"limit": 10,
"offset": 0,
"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({
query: '<string>',
function: '<string>',
seniority: '<string>',
employment_type: '<string>',
country: '<string>',
location: '<string>',
industry: '<string>',
posted_within_days: 30,
company_id: '<string>',
company: '<string>',
limit: 10,
offset: 0,
max_credits: 1,
dry_run: true
})
};
fetch('https://api.datalayer.so/v1/jobs/postings', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"data": {
"offset": 4503599627370495,
"limit": 13,
"next_offset": -4503599627369996,
"result_scope": {
"mode": "bounded_shortlist",
"evaluated": 12,
"exhaustive": false,
"scope": "bounded_shortlist",
"filters_applied_to": "<string>",
"provider_total": 4503599627370495,
"indexed_total": 4503599627370495
},
"coverage_note": "<string>",
"total": {
"value": 4503599627370495,
"relation": "eq"
},
"truncated": true,
"posted_within_days": 45,
"retrieved_at": "2023-11-07T05:31:56Z",
"source_updated_at": "<string>",
"companies": [
{
"company_id": "<string>",
"company_name": "<string>",
"linkedin_org_id": "<string>",
"match_basis": "company_id",
"postings": [
{
"title": "<string>",
"location": "<string>",
"seniority": "<string>",
"posted_at": "<string>",
"source_url": "<string>",
"description": "<string>",
"description_truncated": true,
"salary": {
"min": 1,
"max": 1,
"currency": "<string>",
"unit": "HOUR"
},
"functions": [
"<string>"
],
"employment_type": "<string>",
"closed_at": "<string>",
"status": "open",
"source_domain": "<string>",
"first_seen_at": "<string>",
"updated_at": "<string>"
}
],
"postings_in_page": 12
}
]
},
"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>"
}
}Find job postings
Cross-company indexed job postings from the last 1 to 90 days (default 30), through now, so a future job_posted_date is excluded. Country names and aliases are translated to ISO 3166-1 alpha-2 codes; existing codes pass through. Seniority, employment type, and function words are translated to the indexed labels described on those fields; unknown values pass through. Function boosts labeled matches instead of excluding recent unlabeled postings. With a query, unlabeled postings that match the query still appear. Without a query, the translated function label is also matched against the job title. Industry and company-name filters match indexed labels case-insensitively after whitespace is trimmed. Filters also include title/keywords, location text, and one optional company. Results are grouped by employer for this page and ordered newest posted date first, with a function match breaking a posted-date tie. The jobs-index company ID is a different namespace from the company profile ID. A page with at least one posting costs 1 credit; an empty successful page and failures cost zero. Identical searches repeat free for 24 hours. Indexed postings are not confirmed hires.
curl --request POST \
--url https://api.datalayer.so/v1/jobs/postings \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"query": "<string>",
"function": "<string>",
"seniority": "<string>",
"employment_type": "<string>",
"country": "<string>",
"location": "<string>",
"industry": "<string>",
"posted_within_days": 30,
"company_id": "<string>",
"company": "<string>",
"limit": 10,
"offset": 0,
"max_credits": 1,
"dry_run": true
}
'import requests
url = "https://api.datalayer.so/v1/jobs/postings"
payload = {
"query": "<string>",
"function": "<string>",
"seniority": "<string>",
"employment_type": "<string>",
"country": "<string>",
"location": "<string>",
"industry": "<string>",
"posted_within_days": 30,
"company_id": "<string>",
"company": "<string>",
"limit": 10,
"offset": 0,
"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({
query: '<string>',
function: '<string>',
seniority: '<string>',
employment_type: '<string>',
country: '<string>',
location: '<string>',
industry: '<string>',
posted_within_days: 30,
company_id: '<string>',
company: '<string>',
limit: 10,
offset: 0,
max_credits: 1,
dry_run: true
})
};
fetch('https://api.datalayer.so/v1/jobs/postings', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"data": {
"offset": 4503599627370495,
"limit": 13,
"next_offset": -4503599627369996,
"result_scope": {
"mode": "bounded_shortlist",
"evaluated": 12,
"exhaustive": false,
"scope": "bounded_shortlist",
"filters_applied_to": "<string>",
"provider_total": 4503599627370495,
"indexed_total": 4503599627370495
},
"coverage_note": "<string>",
"total": {
"value": 4503599627370495,
"relation": "eq"
},
"truncated": true,
"posted_within_days": 45,
"retrieved_at": "2023-11-07T05:31:56Z",
"source_updated_at": "<string>",
"companies": [
{
"company_id": "<string>",
"company_name": "<string>",
"linkedin_org_id": "<string>",
"match_basis": "company_id",
"postings": [
{
"title": "<string>",
"location": "<string>",
"seniority": "<string>",
"posted_at": "<string>",
"source_url": "<string>",
"description": "<string>",
"description_truncated": true,
"salary": {
"min": 1,
"max": 1,
"currency": "<string>",
"unit": "HOUR"
},
"functions": [
"<string>"
],
"employment_type": "<string>",
"closed_at": "<string>",
"status": "open",
"source_domain": "<string>",
"first_seen_at": "<string>",
"updated_at": "<string>"
}
],
"postings_in_page": 12
}
]
},
"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>"
}
}find_job_postings. Search indexed job postings across companies. Provide at least one of query,
function, seniority, employment_type, country, location, industry,
company_id or company. company_id and company cannot be sent together.
posted_within_days defaults to 30 and cannot exceed 90. The window ends at
now: job_posted_date must be from now minus that many days through now, so a
future posted date, including a timestamp later today, is excluded.
Results on this page are grouped by employer and ordered newest posted date first. Each posting includes title,
location, seniority, posted date, source URL, a shortened plain-text description,
salary when present, function labels, employment type, close date and status,
source domain, and first-seen and updated dates. A company can continue on the
next page. Pages contain at most 25 postings, with offset at most 1000.
result_scope.scope is indexed. mode remains provider_index. indexed_total
matches provider_total.
description is the indexed posting text with HTML removed, whitespace
collapsed, and the text cut at 500 characters. description_truncated is true
when that cut happened. salary is present only when an amount, currency, or
pay unit was stored (HOUR, DAY, WEEK, MONTH, YEAR, or ONCE). An
empty salary object is returned as null. functions are the indexed function
labels. employment_type is the indexed employment type.
closed_at is the indexed close date, including a date still in the future.
status is open when that date is still ahead, closed when it has passed,
and null when no close date was stored. A missing close date is not treated as
open. source_domain is the hostname of the indexed posting URL, without a
leading www. first_seen_at is when the posting was first indexed.
updated_at is when the indexed posting was last updated. The page
source_updated_at is the newest valid updated_at on
this page. Unknown or future source dates stay null. Retrieval time is not
source freshness.
company_id on a group is the company profile ID only when the request filtered
by company_id and that profile was resolved through its LinkedIn organization
ID. The jobs-index company ID is a different namespace and is not returned.
Matching is case-insensitive. Surrounding and repeated whitespace is ignored.
Unknown values are sent unchanged.
Country accepts an English name, a common alias, or an ISO 3166-1 alpha-2 code.
Canada maps to CA. United States and USA map to US. UK,
United Kingdom, Britain, and Great Britain map to GB. Other English
country names map to their ISO code. An existing 2-letter code passes through,
including CA, US, and GB.
Seniority accepts an indexed label or a plain word:
| Input | Indexed label |
|---|---|
| intern, internship | Internship |
| entry, entry level, entry-level, junior | Entry-level |
| associate | Associate |
| mid, mid-level, senior, lead, mid-senior, mid-senior level | Mid-Senior level |
| director | Director |
| executive | Executive |
| not applicable | Not Applicable |
Full-time, Part-time, Contract, Temporary,
Internship, Volunteer, or Other. Spacing and hyphens are ignored, so
full time and fulltime match Full-time. contractor matches Contract,
temp matches Temporary, and intern matches Internship.
Function accepts one indexed label: Accounting, Administrative, Advertising,
Analyst, Art / Creative, Business Development, Consulting, Customer Service,
Design, Distribution, Education, Engineering, Finance, General Business,
HealthCare Provider, Human Resources, Information Technology, Legal,
Management, Manufacturing, Marketing, Other, Product Management, Production,
Project Management, Public Relations, Purchasing, QualityAssurance, Research,
Sales, Science, Strategy / Planning, Supply Chain, Training, or
Writing / Editing. Spacing, hyphens, and slashes are ignored, so
Quality Assurance matches QualityAssurance and Art/Creative matches
Art / Creative. healthcare matches HealthCare Provider. Abbreviations
IT, HR, QA, and PR are accepted.
Function labels are filled in after the posting is indexed, so a
function boosts labeled matches instead of hiding recent unlabeled postings.
When query is present, an unlabeled posting that matches the query still
appears. When no query is present, the translated function label is also
matched against the job title, so an unlabeled recent posting whose title
contains that label still appears. Newest posted date stays first. A function
match sorts ahead of another posting with the same posted date.
Industry and company-name filters match indexed labels directly. Location is
a text match.
A successful page that returns at least one posting costs 1 credit. A successful
page with zero postings costs zero. Failures cost zero and are not evidence of
no postings. The identical search repeats free within 24 hours. dry_run and
max_credits apply. Indexed postings are not confirmed open roles or hires. A
timeout is not an empty market.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
- Option 5
- Option 6
- Option 7
- Option 8
- Option 9
Indexed job function: Accounting, Administrative, Advertising, Analyst, Art / Creative, Business Development, Consulting, Customer Service, Design, Distribution, Education, Engineering, Finance, General Business, HealthCare Provider, Human Resources, Information Technology, Legal, Management, Manufacturing, Marketing, Other, Product Management, Production, Project Management, Public Relations, Purchasing, QualityAssurance, Research, Sales, Science, Strategy / Planning, Supply Chain, Training, Writing / Editing. Spacing, hyphens, and slashes are ignored, so Quality Assurance matches QualityAssurance, healthcare and Health Care Provider match HealthCare Provider, and Art/Creative matches Art / Creative. Abbreviations IT, HR, QA, and PR are accepted. Matching is case-insensitive. Unknown values pass through unchanged. Function labels are filled in after the posting is indexed, so this boosts labeled matches instead of excluding recent unlabeled postings. When a query is present, unlabeled postings that match the query still appear. When no query is present, the translated label is also matched against the job title. Newest posted date stays first, and a function match breaks a tie.
1 - 200Indexed seniority or a plain word. intern maps to Internship. entry and junior map to Entry-level. mid, senior, and lead map to Mid-Senior level. director maps to Director. executive maps to Executive. Indexed labels also accepted: Internship, Entry-level, Associate, Mid-Senior level, Director, Executive, Not Applicable. Matching is case-insensitive. Unknown values pass through unchanged.
1 - 200Indexed employment type: Full-time, Part-time, Contract, Temporary, Internship, Volunteer, or Other. Spacing and hyphens are ignored, so full time and fulltime match Full-time. contractor matches Contract, temp matches Temporary, and intern matches Internship. Matching is case-insensitive. Unknown values pass through unchanged.
1 - 200English country name, common alias, or ISO 3166-1 alpha-2 code. Canada maps to CA. United States and USA map to US. UK, United Kingdom, Britain, and Great Britain map to GB. Other English country names map to their ISO code. Existing 2-letter codes pass through. Matching is case-insensitive. Unknown values pass through unchanged.
1 - 200