France Travail Scraper

Overview

This actor scrapes structured job listings from France Travail (formerly Pôle Emploi), France's official government job portal. It extracts detailed job data including title, location, contract type, salary, and required skills by programmatically querying the search endpoint and visiting individual job detail pages.

Key Features

• Structured Data Extraction: Pulls clean, organized fields from job postings.
• Flexible Search: Can start from specific URLs (startUrls) or build searches dynamically using a query and filters.
• Pagination Handling: Automatically navigates through search result pages.
• Comprehensive Filtering: Supports a wide range of France Travail's native search filters (contract type, experience, date posted, etc.).
• Controlled Execution: Stops when maxItems is reached or when no more jobs are found.

How to Use

You must provide either a query (keyword) or one or more startUrls to begin scraping. The actor will then apply any additional filters you specify and collect job data up to your defined maxItems.

Input

Configure the actor using the following input fields. Provide the input as a JSON object.

Required:
* maxItems (integer): The maximum number of job listings to scrape.

Search Initialization (provide one):
* startUrls (array): A list of specific France Travail search or job detail URLs to scrape from.
* query (array or string): Keyword(s) for the job search. The actor constructs the search URL automatically.

Common Filters (all optional):
* sort (string): "0" for Relevance or "1" for Date.
* creationDate (string): Filter by posting age. Options: "1" (A day), "3" (Three Days), "7" (One Week), "14" (Two Weeks), "31" (One Month), "0" (All Offers).
* typeContract (array): Contract types like "CDI", "CDD", "MIS".
* weeklyDuration (array): Work schedule: "1" (Full Time), "2" (Part Time), "3" (Not Specified).
* experience (array): Required experience: "1" (<1y), "2" (1–3y), "3" (>3y), "0" (Not specified).
* professionalDomain (array): Professional domain codes (e.g., "M", "B", "C").

Other Configuration:
* proxyConfiguration (object): Apify Proxy settings. Example: { "useApifyProxy": true }

Example Input:

{
  "query": ["data engineer"],
  "maxItems": 50,
  "sort": "1",
  "creationDate": "7",
  "typeContract": ["CDI"],
  "proxyConfiguration": { "useApifyProxy": true }
}

Output

The actor outputs each job listing as a separate item in the dataset. Each item contains structured fields such as:
* url: The direct link to the job posting.
* title: Job title.
* postalCode & city: Location information.
* contractType: e.g., CDI, CDD.
* salaryText: Description of the salary or wage.
* description: Full job description text.
* requiredSkills: List of required competencies.
* companyName: Hiring organization.
* publicationDate: When the offer was posted.

The data is available in JSON, CSV, and other formats via the Apify dataset.