Search jobs

Case-insensitive substring match on the job title (3-200 characters).

Full-text search across the job. Google-style syntax: quoted "exact phrase", OR, and -term exclusion (a query that is ONLY exclusions is rejected with 400). Operator precedence: implicit AND binds tighter than OR, and a -term attaches only to its adjacent group — so "machine learning" OR "data scientist" -senior parses as A OR (B AND NOT senior) and CAN still return Senior ML titles. To exclude a term everywhere, distribute it across each branch: "machine learning" -senior OR "data scientist" -senior. By default q matches the job TITLE only (precise — best for common role terms); pass q_scope=full to also search the description. Phrase queries under q_scope=full combined with very narrow filters (a small country, a rare language) can hit the search timeout; the default title scope is immune, so prefer it for phrase precision. q composes as a filter with the standard sort/cursor pagination (newest-first over the matches) and respects the default 90-day freshness window unless a date filter is given. Symbol-bearing tech tokens (c++, c#, .net) are matched as a title substring instead of full-text (they collapse under English tokenization). If a full-text search yields no rows a single title-substring fallback runs and its results are flagged fuzzy: true.

Which fields q searches. title (default) matches the job title only — precise, best for common role terms (e.g. developer, engineer), which otherwise match description boilerplate. full also searches the description — broader reach, best for niche skills or tools that appear only in the requirements text (a language or framework not named in the title). Only affects results when q is set (ignored otherwise).

Filter by ISO 3166-1 alpha-2 country code(s). Repeat the parameter or comma-separate values (e.g. country=us,de). A job matches if it is tagged with any of the given countries. Up to 20 values; case-insensitive.

Filter by state / region reference code(s). Repeat the parameter or comma-separate values (e.g. state=CA,NY). A job matches if it is tagged with any of the given regions. Up to 20 values; case-insensitive.

Case-insensitive substring match on the city name.

Filter by workplace arrangement.

Filter by employment type.

Filter by seniority level.

Filter by ISO 639-1 language code (2 letters, case-insensitive).

Keep jobs whose stated salary range reaches at least this amount. Jobs that state only a minimum (no maximum) match when that minimum is at least this value.

Keep jobs whose stated salary range starts at or below this amount.

Filter by ISO 4217 currency code (3 letters, case-insensitive).

When true, return only jobs that specify a salary; when false, only jobs without a salary.

Filter by the numeric company id.

Filter by listing status. open (default) returns active listings; closed returns delisted ones.

Only jobs posted at or after this ISO-8601 timestamp, including a UTC offset (e.g. 2024-01-01T00:00:00+00:00). When none of posted_since, posted_until, or first_seen_since are provided and status is open, results default to the last 90 days.

Only jobs posted at or before this ISO-8601 timestamp, including a UTC offset (e.g. 2024-01-01T00:00:00+00:00).

Only jobs first seen at or after this ISO-8601 timestamp, including a UTC offset (e.g. 2024-01-01T00:00:00+00:00).

Sort field for the descending keyset pagination. Defaults to posted_at. A full-text q composes with either sort as a filter.

Maximum number of jobs to return. Defaults to 100; values above 500 are clamped to 500.

Opaque pagination cursor taken from a previous response next_cursor. Must be used with the same sort value that produced it.

Include the job description in each result: off (default, omitted), text (markdown as description_md), or html (description_html).