Search France Travail jobs
Input
query requiredFree-text job search query, same as France Travail's own search box (e.g. "data engineer").
page optional1-based page, 20 offers per page.
Default: 1lieux optionalFrance Travail location code, if you already know it: a department code with a D suffix (e.g. "75D") or a commune code (e.g. "69123" = Lyon). Skips the location lookup. Takes precedence over location.
location optionalCity or department name (e.g. "Lyon"). Omit to search all of France. Only used when it matches one commune or department exactly (or France Travail returns a single place); when several match (e.g. "Paris" is both), the run refuses and lists their lieux codes so you can pass the right one. The place used is returned as resolvedLocation.
Output
jobs requiredpage requiredtotal optionalMatching offer count reported by France Travail's results header. Only populated on page 1 (the page>1 fragment endpoint doesn't repeat it) — null on later pages. 0 with empty jobs[] on page 1 = no matching offers (first-class outcome, not an error).
resolvedLocation optionalThe place the search was filtered on (null when no location was given). label/type are null when lieux was passed directly.
