{ "openapi": "3.0.1", "info": { "title": "Welcome to the Jungle Scraper - WTTJ Jobs & Salary", "description": "💰 $0.45/1K - Scrape Welcome to the Jungle (WTTJ) jobs with filters for location, salary, remote, contract type and experience. 76 fields incl. full description, company info, apply URLs and benefits. Incremental change tracking. Export JSON, CSV or Excel.", "version": "0.1", "x-build-id": "S3tIGh1BqFI8eEpwb" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/blackfalcondata~wttj-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-blackfalcondata-wttj-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/blackfalcondata~wttj-scraper/runs": { "post": { "operationId": "runs-sync-blackfalcondata-wttj-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/blackfalcondata~wttj-scraper/run-sync": { "post": { "operationId": "run-sync-blackfalcondata-wttj-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", "required": [ "query" ], "properties": { "query": { "title": "🔍 Search Term(s)", "type": "string", "description": "Job search keywords, e.g. \"software engineer\"." }, "language": { "title": "🌐 Language / Market", "enum": [ "fr", "en", "de", "es", "cs" ], "type": "string", "description": "WTTJ Algolia index language. Determines which market to search.", "default": "fr" }, "countryCode": { "title": "🌍 Country Code Filter", "type": "string", "description": "Optional ISO 3166-1 alpha-2 country code to filter results, e.g. \"FR\", \"DE\", \"GB\"." }, "location": { "title": "📍 Location", "type": "string", "description": "Optional city name to filter results, e.g. \"Paris\"." }, "contractType": { "title": "Contract type", "type": "array", "description": "Filter by contract type. Leave empty for all.", "items": { "type": "string", "enum": [ "FULL_TIME", "APPRENTICESHIP", "TEMPORARY", "INTERNSHIP", "FREELANCE", "PART_TIME", "OTHER" ], "enumTitles": [ "Permanent (CDI)", "Apprenticeship", "Fixed-term (CDD)", "Internship", "Freelance", "Part-time", "Other" ] } }, "remote": { "title": "Remote policy", "type": "array", "description": "Filter by remote work policy.", "items": { "type": "string", "enum": [ "fulltime", "partial", "punctual", "no", "unknown" ], "enumTitles": [ "Full remote", "Partial / hybrid", "Occasional", "No remote", "Unknown" ] } }, "sector": { "title": "Sector(s)", "type": "array", "description": "Filter by sector name as shown on WTTJ in your chosen language, e.g. \"Tech\", \"Banques / Assurances / Finance\".", "items": { "type": "string" } }, "educationLevel": { "title": "Minimum education level", "enum": [ "NO_DIPLOMA", "BAC", "BAC_2", "BAC_3", "BAC_4", "BAC_5", "PHD" ], "type": "string", "description": "Filter by required education level." }, "experienceMin": { "title": "Minimum experience (years)", "minimum": 0, "type": "integer", "description": "Only jobs requiring at least this many years of experience." }, "experienceMax": { "title": "Maximum experience (years)", "minimum": 0, "type": "integer", "description": "Only jobs requiring at most this many years of experience." }, "salaryMin": { "title": "Minimum yearly salary", "minimum": 0, "type": "integer", "description": "Only jobs disclosing a yearly salary at or above this value." }, "onlyWithSalary": { "title": "Only jobs with salary disclosed", "type": "boolean", "description": "Restrict to jobs that publish a salary range.", "default": false }, "companySize": { "title": "Company size", "enum": [ "0-15", "15-50", "50-250", "250-2000", "2000+" ], "type": "string", "description": "Filter by company headcount band." }, "companySizeMin": { "title": "Company size - min employees", "minimum": 0, "type": "integer", "description": "Advanced: exact minimum headcount (overrides the band above)." }, "companySizeMax": { "title": "Company size - max employees", "minimum": 0, "type": "integer", "description": "Advanced: exact maximum headcount (overrides the band above)." }, "publishedSince": { "title": "Published since", "type": "string", "description": "Recency window: \"24h\", \"7d\", \"30d\", or an ISO date (e.g. \"2026-06-01\"). Forces newest-first ordering." }, "sortBy": { "title": "Sort by", "enum": [ "relevance", "date" ], "type": "string", "description": "Result ordering. \"date\" returns the newest jobs first.", "default": "relevance" }, "radiusKm": { "title": "Radius (km)", "minimum": 1, "type": "integer", "description": "Return jobs within this many kilometers of the location. Origin is resolved from the Location field (or use explicit coordinates below)." }, "radiusMiles": { "title": "Radius (miles)", "minimum": 1, "type": "integer", "description": "Alternative to radius in km. If both are set, km wins." }, "originLat": { "title": "Origin latitude", "type": "string", "description": "Explicit origin latitude for radius search, e.g. \"48.8566\" (optional; otherwise resolved from the Location field)." }, "originLng": { "title": "Origin longitude", "type": "string", "description": "Explicit origin longitude for radius search, e.g. \"2.3522\"." }, "includeDetails": { "title": "🔎 Fetch full details", "type": "boolean", "description": "Fetch each job's full HTML description, apply URL, candidate profile, and deep company data (industry, website, socials, headquarters). Adds one request per job - slower but far richer.", "default": false }, "maxResults": { "title": "💯 Max Results", "minimum": 0, "maximum": 10000, "type": "integer", "description": "Maximum total results to return. 0 = unlimited.", "default": 50 }, "descriptionMaxLength": { "title": "✂️ Description Max Length", "minimum": 0, "type": "integer", "description": "Truncate job description to N characters. 0 = no truncation.", "default": 0 }, "compact": { "title": "📦 Compact Output", "type": "boolean", "description": "Return core fields only (ideal for AI-agent / MCP workflows).", "default": false }, "incrementalMode": { "title": "♻️ Incremental Mode", "type": "boolean", "description": "Only emit new or changed jobs compared to the previous run.", "default": false }, "stateKey": { "title": "🔑 State Key", "type": "string", "description": "Optional stable identifier for the tracked search universe. Leave empty to auto-derive a stable identifier from your search inputs — different keyword/location/filter combinations get isolated state automatically." }, "skipReposts": { "title": "🚫 Skip Reposts", "type": "boolean", "description": "When enabled, suppress jobs that appear to be reposts of previously seen (and now expired) jobs based on their content.", "default": false }, "telegramToken": { "title": "🤖 Telegram Bot Token", "type": "string", "description": "Telegram bot token from @BotFather. Required for Telegram notifications." }, "telegramChatId": { "title": "💬 Telegram Chat ID", "type": "string", "description": "Telegram chat or channel ID where alerts are sent (e.g. \"-100123456789\" for a private group, or \"@yourchannel\")." }, "discordWebhookUrl": { "title": "🎮 Discord Webhook URL", "type": "string", "description": "Discord incoming webhook URL. Get one from Server Settings → Integrations → Webhooks." }, "slackWebhookUrl": { "title": "💼 Slack Webhook URL", "type": "string", "description": "Slack incoming webhook URL. Create at api.slack.com/messaging/webhooks." }, "whatsappPhoneNumberId": { "title": "📱 WhatsApp Phone Number ID", "type": "string", "description": "WhatsApp Business phone number ID from Meta Business Manager (NOT the phone number itself — the numeric ID shown next to your business number). Free service-conversation messages within 24 hours of last user-initiated contact." }, "whatsappAccessToken": { "title": "🔐 WhatsApp Access Token", "type": "string", "description": "Meta Cloud API access token with `whatsapp_business_messaging` scope. Get a permanent token from a system user in Meta Business Manager." }, "whatsappTo": { "title": "📨 WhatsApp Recipient", "type": "string", "description": "Recipient phone in E.164 format (e.g. +919876543210). Recipient must have messaged your business number within the last 24 hours — outside that window, free-form text is rejected by Meta." }, "webhookUrl": { "title": "🪝 Generic Webhook URL", "type": "string", "description": "Generic webhook URL that receives a JSON POST with the full job payload + run metadata. Universal escape hatch for n8n / Make / Zapier / your own backend." }, "webhookHeaders": { "title": "🔑 Webhook Headers", "type": "object", "description": "Optional headers (e.g. {\"Authorization\": \"Bearer xyz\"}) sent with the webhook POST." }, "notificationLimit": { "title": "📊 Max Jobs Per Notification", "minimum": 1, "maximum": 20, "type": "integer", "description": "Maximum number of jobs included in each notification message (1–20). Excess jobs are still in the dataset; notifications get a summary line.", "default": 5 }, "notifyOnlyChanges": { "title": "🔄 Notify Only New/Updated", "type": "boolean", "description": "When Incremental Mode is on, only send notifications for NEW / UPDATED / REAPPEARED jobs. Has no effect outside incremental mode.", "default": false }, "descriptionFormat": { "title": "Description format", "enum": [ "all", "text", "html", "markdown" ], "type": "string", "description": "Pick a single description representation. `all` keeps every variant; `text` / `html` / `markdown` drop the others.", "default": "all" }, "excludeEmptyFields": { "title": "Exclude empty fields from output", "type": "boolean", "description": "Drop null, empty-string, and empty-array fields from each record before push. Smaller payloads for AI agents and dashboards.", "default": false }, "appConnector": { "title": "Send results to Notion (or another connected app)", "type": "string", "description": "Optional. Pick a connected app under Settings → API & Integrations to receive your results. Notion is supported today (a run-summary page); other MCP connectors are best-effort as Apify expands its catalog." }, "mcpIssueTeam": { "title": "Issue tracker team", "type": "string", "description": "Only when the connected app is an issue tracker: the team (name or ID) the summary issue is created under, if that app requires one." } } }, "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 } } } } } } } } } }