Search APEC jobs
Input
query requiredFree-text job search query, same as APEC's own search box (e.g. "data engineer").
page optional1-based page, 20 offers per page (APEC's own default page size).
Default: 1lieuId optionalApec location id, if you already know it (e.g. 75 = Paris department, 596717 = Lyon). Skips the location lookup. Takes precedence over location.
location optionalLocation name (e.g. "Lyon"). Omit to search all of France. Only used when it matches one Apec place exactly (or Apec suggests a single place); when several places match, the run refuses and lists them with their lieuId so you can pass the right one. The place used is returned as resolvedLocation.
Output
jobs requiredpage requiredtotal requiredMatching offer count reported by APEC's API (totalCount). 0 with empty jobs[] = 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 lieuId was passed directly.
