France Travail Scraper

Scrape structured job-offer data from France Travail (francetravail.fr, formerly Pôle Emploi) — France's national employment platform with 700,000+ active listings.

Returns normalized job records: listing id + canonical URL, title, employer/recruiter, full location + postal code, contract type, salary range, full description, experience, skills & soft skills, additional information, employer page + apply/contact links, ROME codes, and listing labels.

Why use this actor

• Market researchers & analysts — track hiring volume, salary ranges, contract mix, and regional/role demand (logistics, IT, healthcare, hospitality).
• Recruiting intelligence — benchmark employer hiring patterns, contract mix, and compensation across regions and sectors.
• Data engineers — feed structured records into dashboards, warehouses, ETL pipelines, alerts, or search/matching engines.
• Lead generation — identify employers, recruiters, and role-level context for prospect research.

Input parameters

Provide keywords + filters (search mode) or paste France Travail search URLs (url mode).

Parameter	Type	Description	Default
mode	string	search (keywords + filters) or url (paste search links).	search
queries	string[]	Search keywords (one per line), e.g. data analyst, cariste. Each runs a separate search.	—
location	string	City, department code, region, or postal area. Empty = all of France.	—
radius	integer	Search radius in km around the location (0 = none).	10
publishedDate	string	Last 24 hours | Last 3 Days | Last Week | Last 2 Weeks | Last Month.	—
contractType	string[]	Contract types (CDI, CDD, Intérim, Apprentissage, …).	—
contractDuration	string[]	Full-time | Part-time | Not specified.	—
jobCategory	string[]	Professional domains (IT, Healthcare, Logistics, Hospitality, …).	—
minSalary	integer	Minimum monthly gross salary in EUR. 0 = keep all.	0
experience	string[]	Entry / Mid / Senior / Not specified (applied from job detail).	—
seniority	string[]	Executive / Non-executive / Not specified.	—
onlyFranceTravail	boolean	Keep only offers published directly on France Travail (exclude partners).	false
inclusiveEmployer	boolean	Keep only disability-inclusive (Handi-engage) employers.	false
adaptedCompany	boolean	Keep only adapted companies.	false
sortBy	string	Most relevant | Newest.	Newest
urls	string[]	France Travail search URLs (url mode).	—
maxItems	integer	The run cap — global max listings returned.	20
maxPages	integer	Per-search page limit (20 jobs/page). 0 = unlimited (stops at maxItems).	0
fetchDetails	boolean	Open each job page for the full description, salary, skills, employer block, apply/contact links. Billed as a detail-enrichment surcharge.	true
proxy	object	Apify proxy settings. Residential is recommended.	Residential

One cap rule

maxItems is the single cap. maxPages defaults to unlimited and stops at maxItems. Set maxPages only when you want a hard per-search page limit.

Output

Each record has the stable envelope type + id + url (dedupe key: type + ":" + id):

• Core: type, id, url, title, seedId, seedType, seedValue, pageIndex
• Location: location, postalCode, addressLocality, addressRegion, addressCountry, mapUrl
• Contract: contractType, workTime, workHours, employmentType, publishedAt, validThrough
• Description: description
• Salary: salary, salaryCurrency, salaryMin, salaryMax, salaryUnit, salaryText
• Requirements: experienceRequirements[], skills[], softSkills[], additionalInformation[]
• Employer: company, companySize, recruiterName, recruiterDescription, employerPageUrl, employerLogoUrl, employerPhone, employerEmail, applyActionUrl, contactActionUrl, industry, qualification, romeCodes[], jobLabels[]
• Badges: inclusiveEmployer, adaptedCompany, scrapedAt

Example inputs

Query-driven run:

{
  "mode": "search",
  "queries": ["data analyst", "business analyst"],
  "location": "Paris",
  "publishedDate": "Last Week",
  "contractType": ["Permanent contract (CDI) | CDI"],
  "sortBy": "Newest | Date",
  "maxItems": 50
}

Targeted category + salary:

{
  "mode": "search",
  "queries": ["cariste"],
  "location": "Lille",
  "jobCategory": ["Logistics | Transport, Logistique"],
  "contractDuration": ["Full-time | Temps plein"],
  "minSalary": 2000,
  "maxItems": 30
}

Pricing

Pay-per-event: a Results event per dataset row, plus a small detail-enrichment event per detail page fetched (only when fetchDetails is on). An Apify Actor Start event covers compute.

Connection guidance

Apify Residential proxy (any country) gives the highest reliability. Some datacenter exit IPs may be geo-restricted; if a run returns no results on datacenter, switch the proxy to Residential or re-run for a fresh exit IP. If you are on the Apify Free plan, residential proxy access is not included — upgrade or paste your own residential proxy URLs in the proxy field.

Compliance & ethics

This actor collects publicly available job-posting information from francetravail.fr for legitimate business purposes (labor-market research, recruiting intelligence, monitoring). Users are responsible for ensuring their collection, storage, and use complies with applicable laws, regulations, and platform terms. This section is informational, not legal advice.