Skip to main content
find job postings
The assistant tool is 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: Employment type accepts 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

Authorization
string
header
required

Send Authorization: Bearer dl_live_<64 lowercase hexadecimal characters>. Signed-in users can create account-scoped, revocable keys in the Datalayer dashboard. A key does not grant credits. Dashboard session cookies are not API credentials.

Headers

Idempotency-Key
string

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.

Required string length: 1 - 128
Pattern: ^[A-Za-z0-9_-]{1,128}$

Body

application/json
query
string
required
Required string length: 1 - 200
function
string

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.

Required string length: 1 - 200
seniority
string

Indexed 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.

Required string length: 1 - 200
employment_type
string

Indexed 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.

Required string length: 1 - 200
country
string

English 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.

Required string length: 1 - 200
location
string
Required string length: 1 - 200
industry
string
Required string length: 1 - 200
posted_within_days
integer
default:30

Inclusive posted window ending now. job_posted_date must fall from now minus this many days through now, so a future posted date is excluded.

Required range: 1 <= x <= 90
company_id
string
Pattern: ^[1-9][0-9]{0,19}$
company
string
Required string length: 1 - 200
limit
integer
default:10

Advanced: how many matches to return on this page, from 1 to 25. Defaults to 10.

Required range: 1 <= x <= 25
offset
integer
default:0

Advanced: how many matches to skip before this page, from 0 to 1000. Defaults to 0.

Required range: 0 <= x <= 1000
max_credits
integer

Advanced: highest number of credits this call may spend. The call is refused before any lookup when the estimate is higher.

Required range: 0 <= x <= 3
dry_run
boolean

Advanced: return the maximum credit estimate without looking up data.

Response

A settled result or a maximum estimate with no data lookup.

data
object
required
meta
object
required