{ "openapi": "3.0.1", "info": { "title": "Welcome To The Jungle Jobs Scraper", "description": "Scrape Welcome to the Jungle job ads by keyword, city, country, contract, salary, sector or company: title, description, apply link, skills, salary, office GPS and company data. Export to JSON, CSV or Excel.", "version": "0.0", "x-build-id": "3fcmyLqwKoLgNExV2" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/nice_dev~welcometothejungle-jobs-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-nice_dev-welcometothejungle-jobs-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/nice_dev~welcometothejungle-jobs-scraper/runs": { "post": { "operationId": "runs-sync-nice_dev-welcometothejungle-jobs-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/nice_dev~welcometothejungle-jobs-scraper/run-sync": { "post": { "operationId": "run-sync-nice_dev-welcometothejungle-jobs-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": { "startUrls": { "title": "Start URLs", "maxItems": 1000, "type": "array", "description": "welcometothejungle.com search URLs (`https://www.welcometothejungle.com/fr/jobs?query=...`) or single job URLs (`https://www.welcometothejungle.com/fr/companies//jobs/`). When this list is not empty, **Search keyword** and **City** below are ignored; the filters below are added to a search URL that does not set them itself, and the caps and the monitoring still apply. A search URL is searched on the site of its own language (`https://www.welcometothejungle.com/en/jobs?query=data` = the English site): set **Site language** to the same one. Max 1 000 URLs.", "default": [], "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "query": { "title": "Search keyword", "maxLength": 200, "type": "string", "description": "Free-text search, exactly as typed on the site (e.g. `data engineer`). Empty = every job." }, "searchQueries": { "title": "More search keywords", "maxItems": 100, "uniqueItems": true, "type": "array", "description": "Several keywords in one run: one search per keyword (times each city below). Added to **Search keyword**; jobs found by several searches are saved once.", "default": [], "items": { "type": "string" } }, "location": { "title": "City", "maxLength": 200, "type": "string", "description": "Office city, spelled as the site does (e.g. `Paris`, `London`, `New York`). Empty = everywhere." }, "locations": { "title": "More cities", "maxItems": 100, "uniqueItems": true, "type": "array", "description": "Several cities in one run: every keyword is searched in every city (3 keywords × 4 cities = 12 searches, max 500). Added to **City**.", "default": [], "items": { "type": "string" } }, "maxItems": { "title": "Max jobs", "minimum": 0, "maximum": 200000, "type": "integer", "description": "Maximum number of jobs to save for the whole run (after deduplication and filters). 0 = no limit (the whole index is 90 000+ jobs).", "default": 100 }, "maxItemsPerQuery": { "title": "Max jobs per search", "minimum": 0, "maximum": 200000, "type": "integer", "description": "Cap for EACH search (keyword × city, or start URL), so that the first search cannot use up the whole **Max jobs** budget. 0 = no per-search cap.", "default": 0 }, "includeDetails": { "title": "Extract job details", "type": "boolean", "description": "Read each job page from the site API (1 extra request per job) for the full description, the apply link, the skills, the tools, the hiring process, the office address with ZIP code and GPS, and the application questions. Off = the search results alone: 68 of the 108 fields are still filled, for 1 request per 100 jobs — **same price**.", "default": true }, "includeCompanyDetails": { "title": "Extract company details", "type": "boolean", "description": "Read the company page for every office with its ZIP code and GPS, the headquarters flag and the date the company profile last changed. Works with or without **Extract job details**. Adds 1 request per company of the run, not per job: the jobs of a company share its page (measured on 2026-09-22: the 100 first jobs of the pre-filled search belong to 61 companies, the 100 newest jobs of the site to 28) — **same price**, a little slower. The company website, social accounts, open-job count, revenue and gender split already come with **Extract job details**.", "default": false }, "countryCodes": { "title": "Countries", "maxItems": 50, "uniqueItems": true, "type": "array", "description": "ISO country codes of the office (e.g. `FR`, `US`, `GB`, `CA`, `DE`, `ES`). 249 values. Empty = every country.", "default": [], "items": { "type": "string" } }, "states": { "title": "Regions", "maxItems": 50, "uniqueItems": true, "type": "array", "description": "Office region, spelled as the site does (e.g. `Ile-de-France`, `Auvergne-Rhone-Alpes`).", "default": [], "items": { "type": "string" } }, "districts": { "title": "Departments / districts", "maxItems": 50, "uniqueItems": true, "type": "array", "description": "Office department or district, spelled as the site does (e.g. `Hauts-de-Seine`, `Rhône`).", "default": [], "items": { "type": "string" } }, "contractTypes": { "title": "Contract types", "uniqueItems": true, "type": "array", "description": "Contract type as the site codes it.", "items": { "type": "string", "enum": [ "full_time", "part_time", "temporary", "internship", "apprenticeship", "freelance", "vie", "graduate_program", "volunteer", "idv", "other" ], "enumTitles": [ "Permanent (CDI / full time)", "Part time", "Fixed term (CDD)", "Internship", "Apprenticeship", "Freelance", "VIE", "Graduate program", "Volunteering", "IDV", "Other" ] }, "default": [] }, "remoteTypes": { "title": "Remote policy", "uniqueItems": true, "type": "array", "description": "How much remote work the job allows.", "items": { "type": "string", "enum": [ "fulltime", "partial", "punctual", "no", "unknown" ], "enumTitles": [ "Fully remote", "Partial remote", "Occasional remote", "No remote", "Not stated" ] }, "default": [] }, "experienceMin": { "title": "Minimum experience (years)", "minimum": 0, "maximum": 30, "type": "integer", "description": "Only jobs asking for at least this many years of experience (site field `experience_level_minimum`)." }, "experienceMax": { "title": "Maximum experience (years)", "minimum": 0, "maximum": 30, "type": "integer", "description": "Only jobs asking for at most this many years of experience." }, "educationLevels": { "title": "Education levels", "uniqueItems": true, "type": "array", "description": "Required diploma as the site codes it (French `bac` scale). Every value the site holds, read from its own counters.", "items": { "type": "string", "enum": [ "no_diploma", "cap", "bep", "bac", "bac_1", "bac_2", "bac_3", "bac_4", "bac_5", "phd" ], "enumTitles": [ "No diploma required", "CAP", "BEP", "High school (bac)", "bac +1", "bac +2", "bac +3 (bachelor)", "bac +4", "bac +5 (master)", "PhD" ] }, "default": [] }, "salaryMin": { "title": "Minimum yearly salary", "minimum": 0, "maximum": 10000000, "type": "integer", "description": "Only jobs whose stated yearly minimum salary is at least this amount (site field `salary_yearly_minimum`). Only about a quarter of the jobs show a salary (26 % counted on the site on 2026-09-22): setting this drops the others." }, "salaryMax": { "title": "Maximum yearly salary", "minimum": 0, "maximum": 10000000, "type": "integer", "description": "Only jobs whose stated yearly minimum salary is at most this amount." }, "salaryCurrencies": { "title": "Salary currencies", "maxItems": 50, "uniqueItems": true, "type": "array", "description": "Currency of the stated salary (`EUR`, `USD`, `GBP`).", "default": [], "items": { "type": "string" } }, "sectors": { "title": "Sectors", "maxItems": 50, "uniqueItems": true, "type": "array", "description": "Company sector, by site reference (e.g. `software-1`, `e-commerce-1`, `finance-2`) or by name in any of the site languages (`Software`, `Logiciels`): a name is turned into its reference, whatever **Site language** is. 112 values.", "default": [], "items": { "type": "string" } }, "professionCategories": { "title": "Job categories", "maxItems": 50, "uniqueItems": true, "type": "array", "description": "Job family, by site reference (e.g. `tech-engineering-3NjUy`, `sales-customer-service-5MzIw`) or by name in any of the site languages (`Tech & Engineering`, `Technologie et ingénierie`): a name is turned into its reference, whatever **Site language** is. 20 values.", "default": [], "items": { "type": "string" } }, "professionSubCategories": { "title": "Job sub-categories", "maxItems": 50, "uniqueItems": true, "type": "array", "description": "Job sub-family, by site reference (e.g. `software-web-development-iMzA4`) or by name in any of the site languages (`Accounting`, `Comptabilité`): a name is turned into its reference, whatever **Site language** is. 179 values.", "default": [], "items": { "type": "string" } }, "companies": { "title": "Companies", "maxItems": 100, "uniqueItems": true, "type": "array", "description": "Only these companies, by site slug (e.g. `carrefour`, `thales`) or by exact name. The slug is the part after `/companies/` in a job URL.", "default": [], "items": { "type": "string" } }, "companyLabels": { "title": "Company labels", "maxItems": 50, "uniqueItems": true, "type": "array", "description": "Employer labels as the site codes them (e.g. `happy-trainees`, `great-place-to-work`, `ecovadis-gold`, `qualiopi`). 52 values.", "default": [], "items": { "type": "string" } }, "companyCommitments": { "title": "Company commitments", "uniqueItems": true, "type": "array", "description": "Employer commitments as the site codes them.", "items": { "type": "string", "enum": [ "commitment-for-employees", "social-commitment", "environmental-impact" ], "enumTitles": [ "Commitment for employees", "Social commitment", "Environmental impact" ] }, "default": [] }, "companySizeMin": { "title": "Minimum company size", "minimum": 0, "maximum": 5000000, "type": "integer", "description": "Only companies with at least this many employees (site field `organization.nb_employees`)." }, "companySizeMax": { "title": "Maximum company size", "minimum": 0, "maximum": 5000000, "type": "integer", "description": "Only companies with at most this many employees." }, "benefits": { "title": "Benefits", "maxItems": 50, "uniqueItems": true, "type": "array", "description": "Benefits as the site words them IN THE SITE LANGUAGE chosen below: `RTT / Jour de repos` on the French site, `Reduction of working time (RTT)` on the English one. 83 values. A label written in another language matches no job at all.", "default": [], "items": { "type": "string" } }, "jobLanguages": { "title": "Job languages", "maxItems": 50, "uniqueItems": true, "type": "array", "description": "Language the job ad is written in (`fr`, `en`, `de`, `es`, `it`, `pt`…). 13 values. Different from **Site language** below.", "default": [], "items": { "type": "string" } }, "postedWithinDays": { "title": "Posted within (days)", "minimum": 1, "maximum": 3650, "type": "integer", "description": "Only jobs published in the last N days (filter applied by the site, so nothing older is downloaded). Counted on the site on 2026-09-22: ≈ 2 900 jobs in the last 24 h and ≈ 16 700 in the last 7 days, out of ≈ 90 000 — a fresh day changes those numbers." }, "latitude": { "title": "Latitude", "maxLength": 32, "type": "string", "description": "Decimal latitude of the centre, e.g. `48.8566` for Paris." }, "longitude": { "title": "Longitude", "maxLength": 32, "type": "string", "description": "Decimal longitude of the centre, e.g. `2.3522` for Paris." }, "radiusKm": { "title": "Radius (km)", "minimum": 1, "maximum": 20000, "type": "integer", "description": "Distance around the point. Counted on the site on 2026-09-22: 10 km around Paris ≈ 17 200 jobs." }, "siteLanguage": { "title": "Site language", "enum": [ "fr", "en", "es", "cs", "sk" ], "type": "string", "description": "Which country site is searched — it sets the language of the site labels, not the language of the job ad (see **Job languages**). A search URL pasted in **Start URLs** is searched on the site of its own language.", "default": "fr" }, "sortBy": { "title": "Sort by", "enum": [ "relevance", "date" ], "type": "string", "description": "`Relevance` uses the site's own ranking (best with a keyword). `Publication date` returns the newest jobs first and lets the run stop as soon as it goes past **Posted after**.", "default": "relevance" }, "searchInTitleOnly": { "title": "Search in job title only", "type": "boolean", "description": "Match the keyword against the job title only, instead of the whole ad (title, summary, profile, company).", "default": false }, "postedAfter": { "title": "Posted after", "type": "string", "description": "Only jobs published on or after this date (a UTC day, as the **Published on (day)** column gives it): `2026-09-01`, or a period before now such as `7 days`, `2 weeks`, `1 month` (`24 hours` and full ISO date-times work too)." }, "postedBefore": { "title": "Posted before", "type": "string", "description": "Only jobs published on or before this date (the whole UTC day is included), or older than a period such as `30 days`." }, "excludeKeywords": { "title": "Exclude keywords", "maxItems": 50, "uniqueItems": true, "type": "array", "description": "Drop the jobs whose title or summary contains one of these words (case and accents ignored).", "default": [], "items": { "type": "string" } }, "excludeCompanies": { "title": "Exclude companies", "maxItems": 100, "uniqueItems": true, "type": "array", "description": "Drop the jobs of these companies, by site slug or exact name (e.g. staffing agencies you do not want).", "default": [], "items": { "type": "string" } }, "onlyWithSalary": { "title": "Only jobs with a salary", "type": "boolean", "description": "Drop the jobs that do not state a salary. Only about a quarter of the jobs do (26 % counted on the site on 2026-09-22).", "default": false }, "onlyWithApplyUrl": { "title": "Only jobs with an external apply link", "type": "boolean", "description": "Keep only the jobs that point to the employer's own application system (ATS). Needs **Extract job details**.", "default": false }, "onlyWithApplicationQuestions": { "title": "Only jobs with application questions", "type": "boolean", "description": "Keep only the jobs whose application form asks extra questions (screening questions). Needs **Extract job details**.", "default": false }, "onlyNew": { "title": "Only new jobs", "type": "boolean", "description": "Skip the jobs that a previous run (same **Memory key**) already delivered: they are not saved and not charged, and their job page is not even read. First run = everything is new. A job the employer republished since then comes back once, with `isRepost: true` (tick **Skip reposted jobs** to drop it).", "default": false }, "skipReposts": { "title": "Skip reposted jobs", "type": "boolean", "description": "Drop the jobs that were already delivered and have been republished since (employers republish to get back on top): without this box they come back once, with `isRepost: true`. Needs **Only new jobs** to be on, since the memory of the previous runs is what tells a repost.", "default": false }, "stateKey": { "title": "Memory key", "pattern": "^[a-zA-Z0-9_-]{1,64}$", "maxLength": 64, "type": "string", "description": "Name of the memory used by **Only new jobs**. Give each schedule / task its own key (e.g. `paris-data-jobs`) so that they do not share their memory. Letters, digits, `-` and `_`.", "default": "default" }, "resetState": { "title": "Reset the memory", "type": "boolean", "description": "Forget everything remembered under this **Memory key** before the run: this run returns (and charges) every job again. Untick it afterwards.", "default": false }, "excludeEmptyFields": { "title": "Remove empty fields", "type": "boolean", "description": "Drop the keys whose value is null or an empty list from each item (the required keys stay). Smaller JSON, ragged columns in CSV.", "default": false }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Apify Proxy or your own proxies. Keep the default: it is included in the price. The residential Apify proxy is not available in this Actor — it would cost you money without returning a single job more.", "default": { "useApifyProxy": true } }, "maxConcurrency": { "title": "Max concurrency", "minimum": 1, "maximum": 50, "type": "integer", "description": "Maximum number of requests processed in parallel.", "default": 5 }, "maxRequestsPerMinute": { "title": "Max requests per minute", "minimum": 10, "maximum": 2000, "type": "integer", "description": "Global request rate. Lower it if the site answers HTTP 429 / 403 in the log. With **Extract job details**, a job page and its company page count as one request.", "default": 240 }, "maxRequestRetries": { "title": "Max request retries", "minimum": 0, "maximum": 20, "type": "integer", "description": "Retries per request before it is marked as failed.", "default": 5 }, "debugLog": { "title": "Debug log", "type": "boolean", "description": "Include debug messages in the run log.", "default": false } } }, "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 } } } } } } } } } }