{
"openapi": "3.0.1",
"info": {
"title": "Welcome to the Jungle Scraper (WTTJ) - Jobs + Apply URLs",
"description": "Scrape Welcome to the Jungle job listings through the official search API. Full job details, direct ATS apply URLs, company data, 15+ filters, exports beyond the 1000-result limit.",
"version": "0.1",
"x-build-id": "ajoAweKWnD9xXFAJ0"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/alexmorain~wttj-jobs-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-alexmorain-wttj-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/alexmorain~wttj-jobs-scraper/runs": {
"post": {
"operationId": "runs-sync-alexmorain-wttj-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/alexmorain~wttj-jobs-scraper/run-sync": {
"post": {
"operationId": "run-sync-alexmorain-wttj-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": {
"query": {
"title": "Search query",
"type": "string",
"description": "Free-text search across the whole listing: job title, skill, keyword, company name. comptable, data engineer, product designer.
Leave it empty to browse the entire corpus and rely on the filters below instead. That is the right move for lead generation, where you want every company hiring in a sector rather than one role."
},
"searchOnlyInJobTitle": {
"title": "Search only in job title",
"type": "boolean",
"description": "Restricts the search above to job titles only, instead of the full text of the listing.
Turn it on when a common word floods your results: searching python across full text returns every listing that mentions it in passing, while the title-only search returns the roles actually about it.",
"default": false
},
"resultsLanguage": {
"title": "Results language",
"enum": [
"fr",
"en",
"es",
"cs",
"sk"
],
"type": "string",
"description": "Language used for the localized labels in the results: profession names, skills, sectors.
It does not filter anything and does not translate the jobs, which keep the language they were written in. To filter on the language of the listing itself, use Job listing language further down.",
"default": "fr"
},
"sortBy": {
"title": "Sort by",
"enum": [
"relevance",
"newest"
],
"type": "string",
"description": "Relevance uses the Welcome to the Jungle ranking, best when you have a keyword. Newest first sorts by publication date, which is what you want for a recurring run that feeds a job board or an alert.",
"default": "relevance"
},
"publishedWithinDays": {
"title": "Date posted",
"enum": [
"any",
"1",
"3",
"7",
"14",
"30"
],
"type": "string",
"description": "Keeps only jobs published within the window.
One thing to know: Welcome to the Jungle refreshes the publication date when an employer renews a listing, so Last 24 hours still returns a healthy volume and is the natural setting for a daily scheduled run. Leave on Any time for a full export.",
"default": "any"
},
"countryCodes": {
"title": "Countries (ISO codes)",
"type": "array",
"description": "Filter by the country of the office, using ISO 3166-1 alpha-2 codes: FR, US, GB, DE, ES, BE, NL, CH, CA, IT, PT, PL, IE, CZ...
Leave empty to search every country. The corpus is mostly French, with real volume across Europe and the US.",
"items": {
"type": "string"
}
},
"cities": {
"title": "Cities",
"type": "array",
"description": "Filter by the city of the office, matched exactly on the name as Welcome to the Jungle writes it: Paris, Lyon, Marseille, Bordeaux.
Exact match means a misspelling returns nothing rather than an approximation. When in doubt, prefer the GPS radius below, which catches the whole urban area including suburbs listed under their own name.",
"items": {
"type": "string"
}
},
"aroundLatLng": {
"title": "Around GPS point",
"type": "string",
"description": "Search around a point, format lat, lng. Paris is 48.8566, 2.3522, Lyon 45.7640, 4.8357. Any map tool gives you these.
Combine with the radius below. This is the reliable way to cover a labour market: it catches the surrounding towns that a city name filter would miss."
},
"aroundRadiusKm": {
"title": "Radius (km)",
"minimum": 1,
"type": "integer",
"description": "Radius in kilometres around the GPS point. Ignored when no GPS point is set; defaults to 20 km when one is.
Rules of thumb: 20 km for a city and its inner suburbs, 50 km for a commuting area, 100 km for a region."
},
"contractTypes": {
"title": "Contract types",
"type": "array",
"description": "Filter by contract type. Tick as many as you like; leave empty for all of them.
Note that Permanent contract covers the French CDI, and Work-study / Apprenticeship is the alternance, which is a large share of the French corpus.",
"items": {
"type": "string",
"enum": [
"full_time",
"part_time",
"temporary",
"fixed_term",
"internship",
"apprenticeship",
"freelance",
"vie",
"graduate_program",
"volunteer",
"other"
],
"enumTitles": [
"Permanent contract",
"Part-time",
"Temporary",
"Fixed-term",
"Internship",
"Work-study / Apprenticeship",
"Freelance",
"International Corporate Volunteer (VIE)",
"Graduate program",
"Volunteer",
"Other"
]
}
},
"remote": {
"title": "Remote policy",
"type": "array",
"description": "Filter by remote work policy, as declared by the employer. Leave empty for all.
Not specified is a real and frequent value, not an error: many employers simply do not fill the field. Excluding it when you filter on Fully remote is what makes a remote-jobs feed clean.",
"items": {
"type": "string",
"enum": [
"fulltime",
"partial",
"punctual",
"no",
"unknown"
],
"enumTitles": [
"Fully remote",
"Partial remote",
"Occasional remote",
"No remote",
"Not specified"
]
}
},
"jobLanguages": {
"title": "Job listing language",
"type": "array",
"description": "Filter on the language the listing is written in, which is a decent proxy for the working language of the team. Leave empty for all.
Different from Results language above, which only controls the labels in the output.",
"items": {
"type": "string",
"enum": [
"fr",
"en",
"de",
"es",
"it",
"pt",
"nl",
"cs",
"pl",
"zh",
"sv",
"no",
"da",
"fi",
"ja"
],
"enumTitles": [
"French",
"English",
"German",
"Spanish",
"Italian",
"Portuguese",
"Dutch",
"Czech",
"Polish",
"Chinese",
"Swedish",
"Norwegian",
"Danish",
"Finnish",
"Japanese"
]
}
},
"maxExperienceRequired": {
"title": "Max years of experience required",
"minimum": 0,
"type": "integer",
"description": "Keeps only jobs asking for at most this many years of experience. 0 keeps only jobs open to complete beginners, 2 keeps the junior-friendly market.
Leave empty to keep every seniority level. Jobs that do not declare an experience level are kept."
},
"educationLevels": {
"title": "Education levels",
"type": "array",
"description": "Filter on the required education level, expressed in the French system where Bac is the end of secondary school and Bac +5 a master's degree. Leave empty for all.",
"items": {
"type": "string",
"enum": [
"no_diploma",
"cap",
"bep",
"bac",
"bac_1",
"bac_2",
"bac_3",
"bac_4",
"bac_5",
"phd"
],
"enumTitles": [
"No diploma",
"CAP",
"BEP",
"Bac",
"Bac +1",
"Bac +2",
"Bac +3",
"Bac +4",
"Bac +5",
"PhD"
]
}
},
"salaryYearlyMin": {
"title": "Minimum yearly salary",
"minimum": 0,
"type": "integer",
"description": "Keeps only jobs with a declared yearly salary of at least this amount, in the local currency, usually EUR. The Actor normalizes monthly and daily rates to a yearly figure before comparing.
Careful: a job without published salary data is excluded by this filter, and many are. Use it for salary research, not for exhaustive collection."
},
"sectors": {
"title": "Company sectors",
"type": "array",
"description": "Filter on the industry sector of the company. Leave empty for all.
This is the main lever for lead generation: pick the sectors you sell to, and the output gives you every company in them that is currently hiring, with its website, LinkedIn and headcount.",
"items": {
"type": "string",
"enum": [
"tech-1",
"industry-1",
"distribution-1",
"banking-insurance-finance",
"consulting-audit",
"health-social-environment",
"culture-media-entertainment",
"food-and-beverage",
"public-administration-1",
"advertising-marketing-agency",
"education-training-recruitment",
"engineering-1",
"real-estate",
"mobility-transport",
"fashion-luxury-beauty-lifestyle",
"hotel-tourism-leisure",
"corporate-services",
"nonprofit-association",
"architecture-1",
"legal-law"
],
"enumTitles": [
"Tech",
"Industry",
"Retail & Distribution",
"Banking, Insurance, Finance",
"Consulting & Audit",
"Health, Social, Environment",
"Culture, Media, Entertainment",
"Food & Beverage",
"Public administration",
"Advertising & Marketing",
"Education, Training, Recruitment",
"Engineering",
"Real estate",
"Mobility & Transport",
"Fashion, Luxury, Beauty",
"Hotels, Tourism, Leisure",
"Corporate services",
"Nonprofit",
"Architecture",
"Legal"
]
}
},
"professionCategories": {
"title": "Profession categories",
"type": "array",
"description": "Filter on the profession family of the job itself, which is not the same as the company sector: a developer at a bank is Tech & Engineering in Banking. Leave empty for all.",
"items": {
"type": "string",
"enum": [
"sales-customer-service-5MzIw",
"tech-engineering-3NjUy",
"business-finance-1MjQ4",
"project-product-management-xYmEw",
"hr-people-iZGMy",
"maintenance-repair-lZDUy",
"communication-marketing-advertising-wNDg5",
"transport-logistics-lMDVm",
"craftsmanship-and-manual-labor-yNGQw",
"fashion-5MzY5",
"healthcare-yMjNi",
"hospitality-4ZTdj",
"construction-jNzEz",
"consulting-strategy-iNDRl",
"legal-zYjg3",
"agriculture-agri-food-4YmNh",
"security-defense-jMzJm",
"research-development-0OGVm",
"education-wNTkx",
"culture-arts-wOTc2"
],
"enumTitles": [
"Sales & Customer service",
"Tech & Engineering",
"Business & Finance",
"Project & Product management",
"HR & People",
"Maintenance & Repair",
"Communication, Marketing, Advertising",
"Transport & Logistics",
"Craftsmanship & Manual labor",
"Fashion",
"Healthcare",
"Hospitality",
"Construction",
"Consulting & Strategy",
"Legal",
"Agriculture & Agri-food",
"Security & Defense",
"Research & Development",
"Education",
"Culture & Arts"
]
}
},
"companySizeMin": {
"title": "Company size min (employees)",
"minimum": 0,
"type": "integer",
"description": "Keeps only companies with at least this many employees. Leave empty for no lower bound."
},
"companySizeMax": {
"title": "Company size max (employees)",
"minimum": 0,
"type": "integer",
"description": "Keeps only companies with at most this many employees. Leave empty for no upper bound.
Combined with the minimum, this is how you target a segment: 20 to 200 for scale-ups, 1000 and above for large accounts."
},
"companySlugs": {
"title": "Specific companies",
"type": "array",
"description": "Export every job of specific companies, whatever the other filters. One per line, using the slug from the company URL (welcometothejungle.com/fr/companies/alan) or the exact company name.
This is competitive hiring intelligence: watch what your competitors, your prospects or your portfolio are recruiting for.",
"items": {
"type": "string"
}
},
"maxItems": {
"title": "Max jobs",
"minimum": 0,
"type": "integer",
"description": "Maximum number of jobs returned.
0 exports every matching job, and it really means every one: the search API caps any single query at 1,000 results, and the Actor detects that ceiling and splits the export by publication date to walk past it. Set a number instead to keep a first run short and predictable, since you pay per job returned.",
"default": 100
},
"includeDetails": {
"title": "Include full job details",
"type": "boolean",
"description": "Fetches the full listing of every job, which adds the complete description, the candidate profile, the recruitment process, the skills and tools, the required application fields, and above all the direct apply URL on the employer's own ATS plus the company website and LinkedIn.
On by default because those fields are the point of the Actor. Turn it off for a fast inventory of what exists: the search fields alone (title, company, city, contract, salary, dates) come back in one pass, thousands of jobs per minute. It does not change the price.",
"default": true
},
"proxyConfiguration": {
"title": "Proxy",
"type": "object",
"description": "Leave this off. The search API needs no proxy and the job detail requests rarely need one; when a detail request is rate-limited the Actor retries by itself. Set a residential proxy only if a large run shows repeated detail failures in the log."
}
}
},
"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
}
}
}
}
}
}
}
}
}
}