# France Travail Scraper | $0.8 / 1k | Fast & Reliable (`fatihtahta/france-travail-scraper`) Actor Extract structured France Travail job listings with titles, salaries, contract details, employer data, locations, and skills. Built for enterprise-grade hiring intelligence, labor market analysis, and automated recruiting or analytics pipelines. - **URL**: https://apify.com/fatihtahta/france-travail-scraper.md - **Developed by:** [Fatih Tahta](https://apify.com/fatihtahta) (community) - **Categories:** Jobs, Developer tools, Automation - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 1 bookmarks - **User rating**: No ratings yet ## Pricing from $0.80 / 1,000 results This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## France Travail Scraper **Slug:** fatihtahta/france-travail-scraper ### Overview France Travail Scraper collects structured job listing data from [France Travail](https://francetravail.fr), including core job attributes such as listing ID, title, company, location, publication date, contract details, salary details, skills, and employer information when available. It is designed for teams that need consistent job market data without manually searching and exporting listings one by one. [France Travail](https://francetravail.fr) is France's national employment platform, making it a valuable source for labor market visibility, hiring activity, and role-level demand signals across regions and sectors. The actor automates recurring collection so you can build datasets faster, reduce manual work, and keep results consistent across runs. It is well suited for reporting, enrichment, monitoring, and operational workflows that depend on clean JSON output. ### Why Use This Actor - **Market researchers and analysts:** Track hiring volume, salary ranges, contract mix, and regional demand for roles such as logistics, IT, healthcare, or hospitality. - **Product and content teams:** Discover trending job titles, skill requirements, and employer language to inform content calendars, landing pages, or audience research. - **Developers and data engineers:** Feed structured job data into dashboards, warehouses, alerts, ETL pipelines, or internal search and matching systems. - **Lead generation and enrichment teams:** Identify employers, recruiters, and job-level context that can support prospect research or company enrichment workflows. - **Monitoring and competitive intelligence teams:** Watch how hiring activity changes over time by location, contract type, publication recency, or selected job categories. ### Input Parameters Provide any combination of URLs, queries, and filters to define the job listings you want to collect. | Parameter | Type | Description | Default | | --- | --- | --- | --- | | `queries` | `string[]` | Search keywords to run as separate job searches, such as job titles, skills, or hiring phrases. Example values: `data analyst`, `cariste`, `assistant comptable`. | – | | `location` | `string` | A city, department, region, or postal area applied to all searches. Leave empty to search across France. | – | | `published_date` | `string` | Publication recency filter. Allowed values: `Last 24 hours`, `Last 3 Days`, `Last Week`, `Last 2 Weeks`, `Last Month`. | – | | `contract_type` | `string[]` | Employment contract types to include. Allowed values: `Permanent contract (CDI) \| CDI`, `Fixed-term contract (CDD) \| CDD`, `Temporary work (Interim) \| Intérim`, `Permanent temp contract \| CDI Intérimaire`, `Seasonal work \| Saisonnier`, `Apprenticeship contract \| Contrat apprentissage`, `Professional training contract \| Cont. professionnalisation`, `Pre-employment training program \| Prépa.opérationnel.emploi`, `Project-based permanent contract \| CDI de chantier ou d'opération`, `Educational engagement contract \| Contrat d'Engagement Educatif`, `Intermittent contract \| Contrat intermittent`, `PACTE contract \| Contrat pacte`, `Usage-based contract \| Contrat d'usage`, `Subsidized employment contract (CAE) \| CUI - CAE`, `Subsidized employment contract (CIE) \| CUI - CIE`, `Military reserve service commitment \| Engagement à servir dans la réserve`, `Franchise / self-employed license \| Franchise`, `Economic integration program \| Insertion par l'activ.éco.`, `Umbrella company employment \| Portage salarial`, `Commercial profession \| Profession commerciale`, `Liberal profession / independent professional \| Profession libérale`, `Business takeover \| Reprise d'entreprise`. | – | | `contract_duration` | `string[]` | Working time filters. Allowed values: `Full-time \| Temps plein`, `Part-time \| Temps partiel`, `Not specified \| Non renseignée`. | – | | `job_category` | `string[]` | Professional domains to include. Allowed values: `Procurement \| Achats, Comptabilité, Gestion`, `Arts \| Arts, Artisanat d'art`, `Finance \| Banque, Assurance`, `Construction \| Bâtiment, Travaux Publics`, `Sales \| Commerce, Vente`, `Communication \| Communication, Multimédia`, `Consulting \| Conseil, Etudes`, `Management \| Direction d'entreprise`, `Agriculture \| Espaces verts et naturels, Agriculture, Pêche, Soins aux animaux`, `Hospitality \| Hôtellerie - Restauration, Tourisme, Animation`, `Real estate \| Immobilier`, `Industry \| Industrie`, `IT \| Informatique, Télécommunication`, `Maintenance \| Installation, Maintenance`, `Marketing \| Marketing, Stratégie commerciale`, `HR \| Ressources Humaines`, `Healthcare \| Santé`, `Administrative \| Secrétariat, Assistanat`, `Services \| Services à la personne, à la collectivité`, `Entertainment \| Spectacle`, `Sports \| Sport`, `Logistics \| Transport, Logistique`. | – | | `min_salary` | `integer` | Minimum monthly gross salary to keep in results. Must be at least `1`. | – | | `experience` | `string[]` | Experience requirements to include. Allowed values: `Entry-level \| Moins de 1 an`, `Mid-level \| De 1 à 3 ans`, `Senior \| Plus de 3 ans`, `Not specified \| Non renseignée`. | – | | `seniority` | `string[]` | Qualification level filter. Allowed values: `Executive \| Cadre`, `Non-executive \| Non cadre`, `Not specified \| Non renseignée`. | – | | `only_france_travail` | `boolean` | When `true`, keeps only listings published directly on France Travail rather than partner listings. | `false` | | `early_application` | `boolean` | When `true`, focuses on listings with lower visible application count to surface less competitive opportunities. | `false` | | `inclusive_employer` | `boolean` | When `true`, keeps only listings from employers that display a disability-inclusion commitment. | `false` | | `adapted_company` | `boolean` | When `true`, keeps only listings from adapted companies. | `false` | | `sort_by` | `string` | Result sorting mode. Allowed values: `Most relevant \| Pertinence`, `Newest \| Date`. | – | | `maximize_coverage` | `boolean` | When `true`, broad searches are expanded to recover more matching listings from larger result sets while preserving your selected filters. | `true` | | `limit` | `integer` | Maximum number of listings to save for each query. Use smaller values for testing and larger values for fuller collection. Must be at least `1`. | – | | `proxyConfiguration` | `object` | Apify proxy and connection settings for more reliable collection on longer or larger runs. Most users can keep the default configuration. | Apify Proxy with `RESIDENTIAL` group | ### Example Inputs #### Scenario: query-driven monitoring run ```json { "queries": ["data analyst", "business analyst"], "location": "Paris", "published_date": "Last Week", "contract_type": ["Permanent contract (CDI) | CDI"], "sort_by": "Newest | Date", "limit": 300 } ```` #### Scenario: targeted category and salary run ```json { "queries": ["cariste"], "location": "Lille", "job_category": ["Logistics | Transport, Logistique"], "contract_duration": ["Full-time | Temps plein"], "min_salary": 2000, "experience": ["Mid-level | De 1 à 3 ans"], "limit": 150 } ``` #### Scenario: inclusive employer sourcing run ```json { "queries": ["assistant administratif"], "location": "Lyon", "only_france_travail": true, "inclusive_employer": true, "adapted_company": true, "early_application": true, "maximize_coverage": true, "limit": 100 } ``` ### Output #### 6.1 Output destination The actor writes results to an Apify dataset as JSON records. And the dataset is designed for direct consumption by analytics tools, ETL pipelines, and downstream APIs without post-processing. #### 6.2 Record envelope (all items) For primary job listing records, the stable record envelope includes: - **type** *(string, required)*: Logical record category. Use `job` when creating downstream idempotency keys and normalized schemas. - **id** *(string, required)*: France Travail listing identifier. - **url** *(string, required)*: Canonical listing URL. Recommended idempotency key: `type + ":" + id` Use this key for deduplication and upserts so the same listing discovered across repeated runs or overlapping searches resolves to one stable downstream record. #### 6.3 Examples Example: job (`type = "job"`) ```json { "type": "job", "id": "206TTWG", "url": "https://candidat.francetravail.fr/offres/recherche/detail/206TTWG", "title": "Offre n° 206TTWG DIRECTEUR DE MAGASIN H/F - PARIS 8 (H/F)", "seedId": "ef38c2d88459", "seedType": "query", "seedValue": "manager", "pageIndex": 4, "company": "SRECRUTEMENT", "location": "75 - Paris 8e Arrondissement", "postalCode": "75008", "addressLocality": "Paris", "addressRegion": "Île-de-France", "addressCountry": "France", "mapUrl": "https://fr.mappy.com/plan#/75008%20paris%20e%20arrondissement#xtor=CS1-84-[francetravail]-[lieu-travail]", "contractType": "CDI Contrat travail", "publishedAt": "2026-04-13T00:00:00", "validThrough": "2027-04-13T00:00:00", "description": "DIRECTEUR DE MAGASIN Au sein d'une enseigne spécialisée dans le bien-être animal en pleine expansion nous recherchons un Directeur ou une Directrice de Magasin pour notre point de vente à Paris 8. Vous intégrez une structure à taille humaine (600 collaborateurs) qui place la cohésion d'équipe et la proximité client au coeur de son modèle, avec de réelles perspectives d'évolution. Votre quotidien : Piloter et suivre la performance globale du magasin. Animer et manager une équipe motivée et passionnée. Élaborer et suivre le budget du magasin. Appliquer la politique commerciale et sociale de l'enseigne. Garantir le respect des règles d'hygiène et de sécurité. Votre profil ( en plus d'aimer les animaux :) Expérience de 3 ans minimum en management dans le commerce spécialisé, idéalement en ayant touché un peu à l'animalerie. Maîtrise de l'analyse et de la gestion des KPI (compte d'exploitation, fidélisation client, NPS). Compétences en merchandising, gestion et rotation des stocks. Sens du collectif, goût pour les chiffres et force de proposition. Nous ne pourrons considérer votre candidature si pas d'expérience en commerce spécialisé ( uniquement grande distribution par exemple) Les avantages Statut cadre, forfait jour. 11 RTT. Tickets restaurant EDENRED. Mutuelle d'entreprise. Remise salarié sur les produits en magasin. 1% patronal pour les projets de logement et de travaux. Primes valorisant l'engagement et les compétences. Vous vous reconnaissez dans ce descriptif ? Nous avons hâte de recevoir votre candidature ! avec votre CV marketé ( résultats obtenus, kpis utilisés, etc).", "salary": 32000, "salaryCurrency": "EUR", "salaryMin": 32000, "salaryMax": 34000, "salaryUnit": "YEAR", "salaryText": "Salaire brut : Annuel de 32000.0 Euros à 34000.0 Euros sur 12.0 mois Intéressement / participation Titres restaurant / Prime de panier", "employmentType": "FULL_TIME", "workHours": "39H/semaine Travail en journée Travail le samedi", "experienceRequirements": [ "2 An(s)" ], "skills": [ "Assurer le suivi des stocks en temps réel", "Présenter et valoriser un produit ou un service", "Analyser les tendances de vente pour ajuster les commandes", "Diriger et gérer un ensemble, une structure, une organisation", "Définir des besoins en approvisionnement", "Elaborer une stratégie commerciale", "Elaborer, suivre et piloter un budget", "Evaluer régulièrement les compétences techniques de l'équipe", "Former les nouveaux employés aux techniques de vente", "Gérer les retours des clients pour améliorer les services", "Identifier et gérer des invendus", "Mettre en place des indicateurs de performance technique", "Mettre en place une politique de gestion des stocks", "Organiser le traitement des commandes", "Surveiller régulièrement les performances de vente et ajuster les stratégies", "Traiter les réclamations des clients" ], "softSkills": [ "Faire preuve de leadership", "Faire preuve de rigueur et de précision", "Etre force de proposition" ], "additionalInformation": [ "Qualification : Cadre", "Secteur d'activité : Activités des agences de placement de main-d'œuvre" ], "companySize": "M. SRECRUTEMENT SRECRUTEMENT", "recruiterName": "M. SRECRUTEMENT SRECRUTEMENT", "recruiterDescription": "Voir la page employeur", "employerPageUrl": "https://recrute.francetravail.fr/page-employeur/ronat-sylvain-113", "employerPhone": "0668786396", "applyActionUrl": "https://candidat.francetravail.fr/offres/recherche.rechercheoffre.voletdetail.postuler.contact:chargercontact?emission=1&idOffre=206TTWG&indexFin=80&lieux=75D&motsCles=manager&offresPartenaires=true&range=60-79&rayon=10&tri=0", "contactActionUrl": "https://candidat.francetravail.fr/offres/recherche.rechercheoffre.voletdetail.postuler.contact:chargercontact?emission=1&idOffre=206TTWG&indexFin=80&lieux=75D&motsCles=manager&offresPartenaires=true&range=60-79&rayon=10&tri=0", "industry": "Activités des agences de placement de main-d'œuvre", "qualification": "Cadre" } ``` ### Field reference #### Job fields (`type = "job"`) - **type** *(string, required)*: Logical record category for downstream normalization. - **id** *(string, required)*: France Travail listing identifier. - **url** *(string, required)*: Canonical listing URL. - **title** *(string, required)*: Listing title as shown on France Travail. - **seedId** *(string, required)*: Stable identifier for the originating search input. - **seedType** *(string, required)*: Origin of the search input, such as a query-based run. - **seedValue** *(string, required)*: Original query or source value that produced the record. - **pageIndex** *(integer, required)*: Source results page index for the record. - **company** *(string, optional)*: Employer or hiring company name. - **location** *(string, optional)*: Human-readable job location. - **postalCode** *(string, optional)*: Postal code when available. - **addressLocality** *(string, optional)*: City or locality. - **addressRegion** *(string, optional)*: Region name. - **addressCountry** *(string, optional)*: Country name. - **mapUrl** *(string, optional)*: Public map link associated with the job location. - **contractType** *(string, optional)*: Contract type text shown on the listing. - **workTime** *(string, optional)*: Working time label, such as full-time or part-time. - **publishedAt** *(string, optional)*: Publication timestamp. - **validThrough** *(string, optional)*: Expiration or validity timestamp when provided. - **description** *(string, optional)*: Full job description text. - **salary** *(number, optional)*: Convenience salary value when provided. - **salaryCurrency** *(string, optional)*: Salary currency code. - **salaryMin** *(number, optional)*: Lower bound of the salary range. - **salaryMax** *(number, optional)*: Upper bound of the salary range. - **salaryUnit** *(string, optional)*: Salary period, such as year or month. - **salaryText** *(string, optional)*: Original salary text as displayed. - **employmentType** *(string, optional)*: Employment type value such as full time. - **workHours** *(string, optional)*: Working hours or schedule text. - **experienceRequirements** *(array\[string], optional)*: Experience requirements listed on the job. - **skills** *(array\[string], optional)*: Skill requirements or competencies. - **softSkills** *(array\[string], optional)*: Behavioral or soft-skill requirements. - **additionalInformation** *(array\[string], optional)*: Additional listing details not represented in dedicated fields. - **companySize** *(string, optional)*: Employer size or employer label shown on the listing. - **recruiterName** *(string, optional)*: Recruiter or employer contact name. - **recruiterDescription** *(string, optional)*: Recruiter summary text. - **employerPageUrl** *(string, optional)*: Public employer page URL when available. - **employerLogoUrl** *(string, optional)*: Public employer logo URL when available. - **employerPhone** *(string, optional)*: Public phone number when available. - **employerEmail** *(string, optional)*: Public email address when available. - **applyActionUrl** *(string, optional)*: Public application URL shown with the listing. - **contactActionUrl** *(string, optional)*: Public contact URL shown with the listing. - **industry** *(string, optional)*: Employer industry or activity sector. - **qualification** *(string, optional)*: Qualification level shown on the listing. - **jobLabels** *(array\[string], optional)*: Additional listing labels or tags when available. ### Data guarantees & handling - **Best-effort extraction:** fields may vary by region, session, availability, and UI experiments. - **Optional fields:** null-check in downstream code. - **Deduplication:** recommend `type + ":" + id`. ### How to Run on Apify 1. Open the Actor in Apify Console. 2. Configure your search parameters, such as keywords, location, publication recency, contract type, or job category. 3. Set the maximum number of outputs to collect with the `limit` field. 4. Click **Start** and wait for the run to finish. 5. Download results in JSON, CSV, Excel, or other supported formats. ### Scheduling & Automation #### Scheduling **Automated Data Collection** You can schedule recurring runs to keep your France Travail job dataset fresh without starting each run manually. This is useful for monitoring hiring activity, building rolling dashboards, or keeping enrichment workflows up to date. - Navigate to **Schedules** in Apify Console - Create a new schedule (daily, weekly, or custom cron) - Configure input parameters - Enable notifications for run completion - Optional: add webhooks for automated processing #### Integration Options - **Webhooks:** Trigger downstream actions when a run completes - **Zapier:** Connect to 5,000+ apps without coding - **Make (Integromat):** Build multi-step automation workflows - **Google Sheets:** Export results to a spreadsheet - **Slack/Discord:** Receive notifications and summaries - **Email:** Send automated reports via email ### Performance - **Small runs (< 1,000 outputs):** ~2-3 minutes - **Medium runs (1,000-5,000 outputs):** ~5-15 minutes - **Large runs (5,000+ outputs):** ~15-30 minutes Execution time varies based on filters, result volume, and how much information is returned per record. ### Compliance & Ethics #### Responsible Data Collection This actor collects publicly available job posting information from for legitimate business purposes. Common use cases include labor market research and market analysis, recruiting intelligence and benchmarking, and job monitoring or reporting workflows. Users are responsible for ensuring their collection, storage, and use of data complies with applicable laws, regulations, and platform terms. This section is informational and not legal advice. - **Labor market** research and market analysis - **Recruiting intelligence** and benchmarking - **Job monitoring** and reporting workflows #### Best Practices - Use collected data in accordance with applicable laws, regulations, and the target site's terms - Respect individual privacy and personal information - Use data responsibly and avoid disruptive or excessive collection - Do not use this actor for spamming, harassment, or other harmful purposes - Follow relevant data protection requirements where applicable (e.g., GDPR, CCPA) ### Support For help, use the Issues tab or the actor page on Apify and include the input you used with sensitive values redacted, the run ID, a short description of expected versus actual behavior, and an optional small output sample that shows the problem clearly. # Actor input Schema ## `queries` (type: `array`): Enter job titles, skills, or hiring phrases such as "data analyst", "cariste", or "assistant comptable". Add one term per line to run separate searches for different roles, specialties, or hiring needs. ## `location` (type: `string`): Enter a city, department, region, or postal area to narrow every search to that place. Leave this empty if you want results from across France. ## `published_date` (type: `string`): Choose a publication window to keep only jobs posted within the last day, week, or month, depending on how quickly you want to react. ## `contract_type` (type: `array`): Choose the contract types you want to include, such as permanent roles, fixed-term jobs, temporary assignments, apprenticeships, or other employment arrangements. ## `contract_duration` (type: `array`): Choose whether to include full-time roles, part-time roles, or listings where the working time is not specified. ## `job_category` (type: `array`): Choose one or more professional domains to focus the search on fields such as IT, healthcare, logistics, hospitality, or construction. ## `min_salary` (type: `integer`): Enter the minimum monthly gross salary you want to accept to filter out lower-paying offers before they are saved. ## `experience` (type: `array`): Choose the experience levels you want to include, from entry-level roles to jobs that ask for several years of experience. ## `seniority` (type: `array`): Choose whether to include executive, non-executive, or unspecified qualification levels in your saved results. ## `only_france_travail` (type: `boolean`): Turn this on to keep only jobs published directly on France Travail. Leave it off if you also want job offers contributed by partner sites and employers. ## `early_application` (type: `boolean`): Turn this on to highlight offers with a lower application count, which can be useful if you want fresher opportunities and a better chance to apply early. ## `inclusive_employer` (type: `boolean`): Turn this on to keep only jobs from employers that display the Handi-engage commitment on France Travail. ## `adapted_company` (type: `boolean`): Turn this on to keep only listings from adapted companies, which may be helpful when you are looking for more accessible working environments. ## `sort_by` (type: `string`): Choose whether to sort results by match quality or by publication date, depending on how you prefer to review opportunities. ## `maximize_coverage` (type: `boolean`): France Travail may show only part of the available results when a search is very broad, often around 900 to 1,000 listings. Turn this on to help recover more matching job offers from large result sets while still respecting your selected filters. ## `limit` (type: `integer`): Choose the maximum number of listings to save for each query. Use a smaller limit for testing and sampling, or a larger one when you want a fuller dataset. ## `proxyConfiguration` (type: `object`): Choose proxy and connection options when you need more stable access, different routing, or better reliability for larger runs. Most users can keep the defaults. ## Actor input object example ```json { "only_france_travail": false, "early_application": false, "inclusive_employer": false, "adapted_company": false, "maximize_coverage": true, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } ``` # Actor output Schema ## `results` (type: `string`): No description # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = {}; // Run the Actor and wait for it to finish const run = await client.actor("fatihtahta/france-travail-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = {} # Run the Actor and wait for it to finish run = client.actor("fatihtahta/france-travail-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{}' | apify call fatihtahta/france-travail-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=fatihtahta/france-travail-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "France Travail Scraper | $0.8 / 1k | Fast & Reliable", "description": "Extract structured France Travail job listings with titles, salaries, contract details, employer data, locations, and skills. Built for enterprise-grade hiring intelligence, labor market analysis, and automated recruiting or analytics pipelines.", "version": "1.0", "x-build-id": "lIsmFFAlvo7r9cVqG" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/fatihtahta~france-travail-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-fatihtahta-france-travail-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/fatihtahta~france-travail-scraper/runs": { "post": { "operationId": "runs-sync-fatihtahta-france-travail-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/fatihtahta~france-travail-scraper/run-sync": { "post": { "operationId": "run-sync-fatihtahta-france-travail-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "queries": { "title": "Add Search Keywords", "type": "array", "description": "Enter job titles, skills, or hiring phrases such as \"data analyst\", \"cariste\", or \"assistant comptable\". Add one term per line to run separate searches for different roles, specialties, or hiring needs.", "items": { "type": "string" } }, "location": { "title": "Choose a Search Location", "type": "string", "description": "Enter a city, department, region, or postal area to narrow every search to that place. Leave this empty if you want results from across France." }, "published_date": { "title": "Choose How Recent Listings Should Be", "enum": [ "Last 24 hours", "Last 3 Days", "Last Week", "Last 2 Weeks", "Last Month" ], "type": "string", "description": "Choose a publication window to keep only jobs posted within the last day, week, or month, depending on how quickly you want to react." }, "contract_type": { "title": "Select Contract Types", "type": "array", "description": "Choose the contract types you want to include, such as permanent roles, fixed-term jobs, temporary assignments, apprenticeships, or other employment arrangements.", "items": { "type": "string", "enum": [ "Permanent contract (CDI) | CDI", "Fixed-term contract (CDD) | CDD", "Temporary work (Interim) | Intérim", "Permanent temp contract | CDI Intérimaire", "Seasonal work | Saisonnier", "Apprenticeship contract | Contrat apprentissage", "Professional training contract | Cont. professionnalisation", "Pre-employment training program | Prépa.opérationnel.emploi", "Project-based permanent contract | CDI de chantier ou d'opération", "Educational engagement contract | Contrat d'Engagement Educatif", "Intermittent contract | Contrat intermittent", "PACTE contract | Contrat pacte", "Usage-based contract | Contrat d'usage", "Subsidized employment contract (CAE) | CUI - CAE", "Subsidized employment contract (CIE) | CUI - CIE", "Military reserve service commitment | Engagement à servir dans la réserve", "Franchise / self-employed license | Franchise", "Economic integration program | Insertion par l'activ.éco.", "Umbrella company employment | Portage salarial", "Commercial profession | Profession commerciale", "Liberal profession / independent professional | Profession libérale", "Business takeover | Reprise d'entreprise" ] } }, "contract_duration": { "title": "Choose Working Time", "type": "array", "description": "Choose whether to include full-time roles, part-time roles, or listings where the working time is not specified.", "items": { "type": "string", "enum": [ "Full-time | Temps plein", "Part-time | Temps partiel", "Not specified | Non renseignée" ] } }, "job_category": { "title": "Pick Job Categories", "type": "array", "description": "Choose one or more professional domains to focus the search on fields such as IT, healthcare, logistics, hospitality, or construction.", "items": { "type": "string", "enum": [ "Procurement | Achats, Comptabilité, Gestion", "Arts | Arts, Artisanat d'art", "Finance | Banque, Assurance", "Construction | Bâtiment, Travaux Publics", "Sales | Commerce, Vente", "Communication | Communication, Multimédia", "Consulting | Conseil, Etudes", "Management | Direction d'entreprise", "Agriculture | Espaces verts et naturels, Agriculture, Pêche, Soins aux animaux", "Hospitality | Hôtellerie - Restauration, Tourisme, Animation", "Real estate | Immobilier", "Industry | Industrie", "IT | Informatique, Télécommunication", "Maintenance | Installation, Maintenance", "Marketing | Marketing, Stratégie commerciale", "HR | Ressources Humaines", "Healthcare | Santé", "Administrative | Secrétariat, Assistanat", "Services | Services à la personne, à la collectivité", "Entertainment | Spectacle", "Sports | Sport", "Logistics | Transport, Logistique" ] } }, "min_salary": { "title": "Set a Minimum Salary", "minimum": 1, "type": "integer", "description": "Enter the minimum monthly gross salary you want to accept to filter out lower-paying offers before they are saved." }, "experience": { "title": "Choose Experience Levels", "type": "array", "description": "Choose the experience levels you want to include, from entry-level roles to jobs that ask for several years of experience.", "items": { "type": "string", "enum": [ "Entry-level | Moins de 1 an", "Mid-level | De 1 à 3 ans", "Senior | Plus de 3 ans", "Not specified | Non renseignée" ] } }, "seniority": { "title": "Choose Qualification Levels", "type": "array", "description": "Choose whether to include executive, non-executive, or unspecified qualification levels in your saved results.", "items": { "type": "string", "enum": [ "Executive | Cadre", "Non-executive | Non cadre", "Not specified | Non renseignée" ] } }, "only_france_travail": { "title": "Keep Only France Travail Listings", "type": "boolean", "description": "Turn this on to keep only jobs published directly on France Travail. Leave it off if you also want job offers contributed by partner sites and employers.", "default": false }, "early_application": { "title": "Prioritize Lower-Competition Jobs", "type": "boolean", "description": "Turn this on to highlight offers with a lower application count, which can be useful if you want fresher opportunities and a better chance to apply early.", "default": false }, "inclusive_employer": { "title": "Find Disability-Inclusive Employers", "type": "boolean", "description": "Turn this on to keep only jobs from employers that display the Handi-engage commitment on France Travail.", "default": false }, "adapted_company": { "title": "Focus on Adapted Companies", "type": "boolean", "description": "Turn this on to keep only listings from adapted companies, which may be helpful when you are looking for more accessible working environments.", "default": false }, "sort_by": { "title": "Choose How to Sort Results", "enum": [ "Most relevant | Pertinence", "Newest | Date" ], "type": "string", "description": "Choose whether to sort results by match quality or by publication date, depending on how you prefer to review opportunities." }, "maximize_coverage": { "title": "Expand Search Coverage", "type": "boolean", "description": "France Travail may show only part of the available results when a search is very broad, often around 900 to 1,000 listings. Turn this on to help recover more matching job offers from large result sets while still respecting your selected filters.", "default": true }, "limit": { "title": "Set a Listing Limit Per Search", "minimum": 1, "type": "integer", "description": "Choose the maximum number of listings to save for each query. Use a smaller limit for testing and sampling, or a larger one when you want a fuller dataset." }, "proxyConfiguration": { "title": "Set Up Connection Options", "type": "object", "description": "Choose proxy and connection options when you need more stable access, different routing, or better reliability for larger runs. Most users can keep the defaults.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```