Skip to main content
POST

​
Credit Cost

​
Request Body

​
string
default:"linkedin"
Job platform to search: linkedin or indeed.
​
string
Search keyword: job title, skill, or company (e.g., "backend engineer").
​
string
Location to search in (e.g., "Paris, France", "United States"). The universal geo param — used by both platforms.
​
string
default:"usa"
Indeed only — optional. Selects the Indeed country site. Auto-derived from location when it names a country (e.g. "Lyon, France" → France). Pass it explicitly only to override, or when location has no country. Ignored by LinkedIn.
​
integer
Search radius in miles around the location (0–200).
​
string
Employment type: fulltime, parttime, contract, temporary, internship.
​
string
Work arrangement: onsite, remote, hybrid.
​
string
Seniority (LinkedIn only): internship, entry_level, associate, mid_senior, director, executive.
​
string
Freshness of the postings: past_24h, past_week, past_month.
On Indeed, date_posted cannot be combined with job_type or work_type: when both are sent, only one of them is applied.
job_type, work_type, experience_level and date_posted only accept the values listed above. Any other value returns a 422 validation error.
​
string
Comma-separated company IDs to restrict the search (LinkedIn only). Accepts encoded IDs (org_xxx, as returned by Typeahead and Search Company) and/or raw numeric LinkedIn IDs.
​
string
Company name to restrict the search to a single employer’s postings (both platforms resolve it to that company’s jobs). Combine with keyword and/or location to narrow within the company. Ignored if company_ids is provided.
​
boolean
default:"false"
Include the full job description on each result. On LinkedIn this is slower (one extra request per job); on Indeed it adds no latency.
​
integer
default:"0"
Number of results to skip for pagination.
​
integer
default:"25"
Number of job postings to return. Maximum: 100 per request.

​
Response

​
integer
Total number of matching job postings. On LinkedIn this is the platform’s global count (capped at 1000 — shown as “1,000+” — for very large result sets). On Indeed, which exposes no global count, it’s a lower bound (how many were enumerated so far); use has_next to know if more exist.
​
integer
Offset used for pagination.
​
integer
Number of results returned in this response.
​
boolean
Whether more results are available. Use it with offset to paginate.
​
number
Credits used for this search.
​
array
List of job postings, normalized across platforms.