{ "openapi": "3.0.1", "info": { "title": "France Travail Jobs Scraper ($0.50/1K)", "description": "Scrape job postings from France Travail (ex Pôle emploi, candidat.francetravail.fr): title, employer, city, contract (CDI, CDD, intérim, alternance), date and partner board; salary, ROME code and full text with the add-on. Filter by keyword, city, radius, contract.", "version": "0.0", "x-build-id": "BI8OjjvhGuCjjnPnv" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/carabain-digital~francetravail-jobs/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-carabain-digital-francetravail-jobs", "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/carabain-digital~francetravail-jobs/runs": { "post": { "operationId": "runs-sync-carabain-digital-francetravail-jobs", "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/carabain-digital~francetravail-jobs/run-sync": { "post": { "operationId": "run-sync-carabain-digital-francetravail-jobs", "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": { "keyword": { "title": "Keyword", "type": "string", "description": "Job title or search term, French. Example: `vendeur`, `infirmier`, `développeur web`. Several words narrow the search. Needs a keyword or a location." }, "location": { "title": "Location", "type": "string", "description": "French city, postcode, department number or region. Example: `Lyon`, `69003`, `69` or `Occitanie`. Leave empty for all of France (then a keyword is required)." }, "radius_km": { "title": "Radius (km)", "minimum": 0, "maximum": 500, "type": "integer", "description": "Search radius around the city in kilometres, 0 to 100. Example: `25`. Needs a location. France Travail's own default is 10 km." }, "posted_since_days": { "title": "Posted in the last N days", "minimum": 1, "maximum": 3650, "type": "integer", "description": "Only jobs published in the last N days. Example: `7`. The site filters in steps of 1, 3, 7, 14 and 31 days; we then cut to the exact number of days. Leave empty for all." }, "ft_contract_types": { "title": "Contract types", "type": "array", "description": "Only these contract types. Example: `Apprentissage` for alternance. Leave empty for all types.", "items": { "type": "string", "enum": [ "CDI", "CDD", "MIS", "SAI", "E2", "FS" ], "enumTitles": [ "CDI", "CDD", "Intérim", "Saisonnier", "Contrat d'apprentissage", "Contrat de professionnalisation" ] } }, "ft_partner_offers": { "title": "Include partner offers", "type": "boolean", "description": "Also return offers that France Travail republishes from partner job boards (HelloWork, Meteojob, Cadremploi, ...). They make up most of the list. Switch off to get only France Travail's own offers.", "default": true }, "limit": { "title": "Max jobs", "minimum": 1, "maximum": 1150, "type": "integer", "description": "Stop after this many jobs (newest first). Example: `100`. France Travail shows at most 1,150 jobs per search.", "default": 100 }, "includeDetails": { "title": "Full details (paid add-on)", "type": "boolean", "description": "Also fetch each job's detail: the full job description, salary (min, max, period and original text), ROME occupation code, experience and training asked, skills, working hours, company website and last-modified date. Adds $1.00 per 1,000 jobs on top of the base price. One extra request per job.", "default": false }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "France Travail works without a proxy. Enable one only if runs get blocked." } } }, "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 }, "PROXY_UNBLOCKER_UNITS": { "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 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }