{ "openapi": "3.0.1", "info": { "title": "Talent.com Jobs Scraper [Just ๐Ÿ’ฐ$1.25] - 62 Countries", "description": "Scrape Talent.com jobs from 62 country sites in one run: many countries, keywords and locations at once. Get title, company, salary range, job type, remote flag, city & coordinates, O*NET code, apply link and full description. Quick Apply & salary-only filters, incremental monitoring, alerts.", "version": "0.1", "x-build-id": "HLtykFOX8pfEiOXJ1" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/corvuslab~talent-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-corvuslab-talent-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/corvuslab~talent-scraper/runs": { "post": { "operationId": "runs-sync-corvuslab-talent-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/corvuslab~talent-scraper/run-sync": { "post": { "operationId": "run-sync-corvuslab-talent-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": { "searchTerms": { "title": "๐Ÿ”‘ Search terms", "type": "array", "description": "Job titles, skills or company names, e.g. \"registered nurse\", \"python developer\", \"warehouse\". Without a search term Talent.com lists only a few dozen jobs per country, so add one. Outside English-speaking countries a job title in the local language works best.", "items": { "type": "string" } }, "countries": { "title": "๐ŸŒ Countries", "type": "array", "description": "Which Talent.com country sites to search โ€” each has its own job inventory. Defaults to the United States.", "items": { "type": "string", "enum": [ "us", "ca", "gb", "ie", "au", "nz", "de", "fr", "es", "it", "nl", "be", "ch", "at", "lu", "pt", "pl", "cz", "hu", "ro", "gr", "se", "no", "dk", "fi", "tr", "in", "pk", "sg", "my", "id", "th", "vn", "ph", "hk", "tw", "jp", "kr", "ae", "sa", "qa", "kw", "bh", "om", "eg", "ma", "ng", "ke", "za", "mx", "br", "ar", "cl", "co", "pe", "ec", "uy", "ve", "cr", "pa", "gt", "pr" ], "enumTitles": [ "๐Ÿ‡บ๐Ÿ‡ธ United States", "๐Ÿ‡จ๐Ÿ‡ฆ Canada", "๐Ÿ‡ฌ๐Ÿ‡ง United Kingdom", "๐Ÿ‡ฎ๐Ÿ‡ช Ireland", "๐Ÿ‡ฆ๐Ÿ‡บ Australia", "๐Ÿ‡ณ๐Ÿ‡ฟ New Zealand", "๐Ÿ‡ฉ๐Ÿ‡ช Germany", "๐Ÿ‡ซ๐Ÿ‡ท France", "๐Ÿ‡ช๐Ÿ‡ธ Spain", "๐Ÿ‡ฎ๐Ÿ‡น Italy", "๐Ÿ‡ณ๐Ÿ‡ฑ Netherlands", "๐Ÿ‡ง๐Ÿ‡ช Belgium", "๐Ÿ‡จ๐Ÿ‡ญ Switzerland", "๐Ÿ‡ฆ๐Ÿ‡น Austria", "๐Ÿ‡ฑ๐Ÿ‡บ Luxembourg", "๐Ÿ‡ต๐Ÿ‡น Portugal", "๐Ÿ‡ต๐Ÿ‡ฑ Poland", "๐Ÿ‡จ๐Ÿ‡ฟ Czechia", "๐Ÿ‡ญ๐Ÿ‡บ Hungary", "๐Ÿ‡ท๐Ÿ‡ด Romania", "๐Ÿ‡ฌ๐Ÿ‡ท Greece", "๐Ÿ‡ธ๐Ÿ‡ช Sweden", "๐Ÿ‡ณ๐Ÿ‡ด Norway", "๐Ÿ‡ฉ๐Ÿ‡ฐ Denmark", "๐Ÿ‡ซ๐Ÿ‡ฎ Finland", "๐Ÿ‡น๐Ÿ‡ท Turkey", "๐Ÿ‡ฎ๐Ÿ‡ณ India", "๐Ÿ‡ต๐Ÿ‡ฐ Pakistan", "๐Ÿ‡ธ๐Ÿ‡ฌ Singapore", "๐Ÿ‡ฒ๐Ÿ‡พ Malaysia", "๐Ÿ‡ฎ๐Ÿ‡ฉ Indonesia", "๐Ÿ‡น๐Ÿ‡ญ Thailand", "๐Ÿ‡ป๐Ÿ‡ณ Vietnam", "๐Ÿ‡ต๐Ÿ‡ญ Philippines", "๐Ÿ‡ญ๐Ÿ‡ฐ Hong Kong", "๐Ÿ‡น๐Ÿ‡ผ Taiwan", "๐Ÿ‡ฏ๐Ÿ‡ต Japan", "๐Ÿ‡ฐ๐Ÿ‡ท South Korea", "๐Ÿ‡ฆ๐Ÿ‡ช United Arab Emirates", "๐Ÿ‡ธ๐Ÿ‡ฆ Saudi Arabia", "๐Ÿ‡ถ๐Ÿ‡ฆ Qatar", "๐Ÿ‡ฐ๐Ÿ‡ผ Kuwait", "๐Ÿ‡ง๐Ÿ‡ญ Bahrain", "๐Ÿ‡ด๐Ÿ‡ฒ Oman", "๐Ÿ‡ช๐Ÿ‡ฌ Egypt", "๐Ÿ‡ฒ๐Ÿ‡ฆ Morocco", "๐Ÿ‡ณ๐Ÿ‡ฌ Nigeria", "๐Ÿ‡ฐ๐Ÿ‡ช Kenya", "๐Ÿ‡ฟ๐Ÿ‡ฆ South Africa", "๐Ÿ‡ฒ๐Ÿ‡ฝ Mexico", "๐Ÿ‡ง๐Ÿ‡ท Brazil", "๐Ÿ‡ฆ๐Ÿ‡ท Argentina", "๐Ÿ‡จ๐Ÿ‡ฑ Chile", "๐Ÿ‡จ๐Ÿ‡ด Colombia", "๐Ÿ‡ต๐Ÿ‡ช Peru", "๐Ÿ‡ช๐Ÿ‡จ Ecuador", "๐Ÿ‡บ๐Ÿ‡พ Uruguay", "๐Ÿ‡ป๐Ÿ‡ช Venezuela", "๐Ÿ‡จ๐Ÿ‡ท Costa Rica", "๐Ÿ‡ต๐Ÿ‡ฆ Panama", "๐Ÿ‡ฌ๐Ÿ‡น Guatemala", "๐Ÿ‡ต๐Ÿ‡ท Puerto Rico" ] }, "default": [ "us" ] }, "locations": { "title": "๐Ÿ“ Locations", "type": "array", "description": "Cities, states or regions inside the chosen country, e.g. \"New York\", \"Austin, TX\", \"Toronto\". Leave empty to search the whole country.", "items": { "type": "string" } }, "startUrls": { "title": "๐Ÿ“‹ Start URLs", "type": "array", "description": "Optional. Paste Talent.com search URLs (filters in the URL are kept) or job URLs (โ€ฆ/view?id=โ€ฆ) from any country site. When set, these replace the search form above.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "maxResults": { "title": "๐Ÿ”ข Max results", "minimum": 0, "type": "integer", "description": "Maximum number of jobs to return across all searches. Set 0 for no limit. Talent.com shows up to roughly 130 jobs per search โ€” add more search terms or locations to collect more.", "default": 25 }, "maxResultsPerSearch": { "title": "โš–๏ธ Max results per search", "minimum": 0, "type": "integer", "description": "Optional. Cap each single search (one country ร— search term ร— location ร— job type) so a multi-country or multi-keyword run comes back balanced. 0 = no per-search cap.", "default": 0 }, "postedWithin": { "title": "๐Ÿ“… Posted within", "enum": [ "any", "1", "3", "7", "14" ], "type": "string", "description": "Only jobs posted recently.", "default": "any" }, "jobTypes": { "title": "๐Ÿ’ผ Job types", "type": "array", "description": "Only jobs of these types. Several types run as separate searches and are merged. Available on the United States, Canada, United Kingdom and France sites.", "items": { "type": "string", "enum": [ "full-time", "part-time", "permanent", "temporary", "internship" ], "enumTitles": [ "Full-time", "Part-time", "Permanent", "Temporary", "Internship" ] } }, "radius": { "title": "๐Ÿ“ Distance from location", "enum": [ "5", "10", "15", "25", "50", "100" ], "type": "string", "description": "How far around each location to search. Talent.com's own default is 25 km (15 mi). In the United States the site uses miles: 5 km = 2 mi, 10 = 5 mi, 15 = 10 mi, 25 = 15 mi, 50 = 30 mi, 100 = 60 mi." }, "remoteOnly": { "title": "๐Ÿ  Remote jobs only", "type": "boolean", "description": "Only remote jobs. Available on the US, Canada, UK, India, Switzerland, Spain, Netherlands, Italy, Germany and France sites.", "default": false }, "quickApplyOnly": { "title": "โšก Quick Apply only", "type": "boolean", "description": "Only jobs you can apply to directly on Talent.com with Quick Apply.", "default": false }, "salaryOnly": { "title": "๐Ÿ’ฐ Only jobs with a salary", "type": "boolean", "description": "Skip jobs that do not publish a pay range. Skipped jobs are not charged.", "default": false }, "includeDetails": { "title": "๐Ÿ”ฌ Full job descriptions", "type": "boolean", "description": "Open every job to add its full description (text, HTML and Markdown) plus any emails, phone numbers and links written in it. Turn off for the fastest runs โ€” records then carry a short snippet.", "default": true }, "descriptionFormat": { "title": "๐Ÿ“ Description format", "enum": [ "all", "text", "html", "markdown" ], "type": "string", "description": "Which representation(s) of the job description to include.", "default": "all" }, "descriptionMaxLength": { "title": "โœ‚๏ธ Description max length", "minimum": 0, "type": "integer", "description": "Cut descriptions to this many characters. 0 = full length.", "default": 0 }, "compact": { "title": "๐Ÿ“ฆ Compact records", "type": "boolean", "description": "Emit only the core fields (title, company, location, salary, job type, link, snippet). Ideal for AI agents and MCP clients.", "default": false }, "excludeEmptyFields": { "title": "๐Ÿงน Drop empty fields", "type": "boolean", "description": "Remove null, empty-string and empty-list fields from each record.", "default": false }, "incrementalMode": { "title": "โ™ป๏ธ Incremental mode", "type": "boolean", "description": "Track jobs between runs and tag every record NEW / UPDATED / UNCHANGED / EXPIRED. Unchanged jobs are skipped and not charged.", "default": false }, "stateKey": { "title": "๐Ÿ—๏ธ State key", "type": "string", "description": "Stable name for the tracked search. Leave empty to derive one automatically from your search settings." }, "emitUnchanged": { "title": "๐Ÿ” Include unchanged jobs", "type": "boolean", "description": "Also emit jobs that have not changed since the previous run.", "default": false }, "emitExpired": { "title": "๐Ÿ—‘๏ธ Include expired jobs", "type": "boolean", "description": "Emit jobs that were open last run but are gone now. Needs a run that reads the whole search (Max results 0 or above the number of matches).", "default": false }, "skipReposts": { "title": "โ™ป๏ธ Skip re-posted jobs", "type": "boolean", "description": "Leave out jobs that an employer took down and posted again under a new link (same title, company and location as a job already tracked). They are not charged. Every new job still carries isRepost either way.", "default": false }, "telegramToken": { "title": "๐Ÿ’ฌ Telegram bot token", "type": "string", "description": "Bot token from @BotFather." }, "telegramChatId": { "title": "๐Ÿ†” Telegram chat ID", "type": "string", "description": "Chat or channel ID, e.g. \"-100123456789\" or \"@yourchannel\"." }, "slackWebhookUrl": { "title": "๐Ÿ’ผ Slack webhook URL", "type": "string", "description": "Slack incoming-webhook URL." }, "discordWebhookUrl": { "title": "๐ŸŽฎ Discord webhook URL", "type": "string", "description": "Discord incoming-webhook URL." }, "webhookUrl": { "title": "๐Ÿช Webhook URL", "type": "string", "description": "Any HTTPS endpoint. Receives a JSON POST with the matched jobs โ€” works with n8n, Make and Zapier." }, "webhookHeaders": { "title": "๐Ÿงพ Webhook headers", "type": "object", "description": "Extra headers for the webhook request, e.g. {\"Authorization\": \"Bearer xyz\"}." }, "notificationLimit": { "title": "๐Ÿ”ข Jobs per notification", "minimum": 1, "maximum": 20, "type": "integer", "description": "How many jobs to include in each notification message.", "default": 5 }, "notifyOnlyChanges": { "title": "๐ŸŽฏ Alert only on changes", "type": "boolean", "description": "In incremental mode, alerts list only new, updated and reappeared jobs, even when Include unchanged jobs is on.", "default": false }, "proxyConfiguration": { "title": "๐ŸŒ Proxy configuration", "type": "object", "description": "Optional. Not needed โ€” the actor works without a proxy. Enable it only if your runs get refused.", "default": { "useApifyProxy": false } }, "ignoreUrlFailures": { "title": "โญ๏ธ Ignore URL failures", "type": "boolean", "description": "Skip start URLs that cannot be interpreted instead of failing the whole run.", "default": true }, "maxRequestRetries": { "title": "๐Ÿ”„ Max request retries", "minimum": 0, "maximum": 10, "type": "integer", "description": "How many times to retry a failed request before giving up on it.", "default": 3 } } }, "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 } } } } } } } } } }