{ "openapi": "3.0.1", "info": { "title": "Google Jobs Scraper - Job Postings API", "description": "Google Jobs and job postings scraper: get job title, company, location, posted date, salary, full description and every apply link for any search. Deduped with a stable job id. US, UK, Canada, India, Singapore, Brazil, Mexico.", "version": "0.6", "x-build-id": "p3zChdQkiBZP8Og5o" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/redomic~google-jobs/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-redomic-google-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/redomic~google-jobs/runs": { "post": { "operationId": "runs-sync-redomic-google-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/redomic~google-jobs/run-sync": { "post": { "operationId": "run-sync-redomic-google-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": { "query": { "title": "Job search", "type": "string", "description": "What you would type into Google Jobs, for example: software engineer, registered nurse, data analyst. Used when queries is empty.", "default": "software engineer" }, "queries": { "title": "Job searches (multiple)", "maxItems": 10, "type": "array", "description": "Up to 10 job searches run in order in one run, for example: ['software engineer', 'data analyst']. Leave empty to use the single query field. All searches share the location, country and filters below, share one time budget, and a job found by an earlier search is not returned again under a later one. maxJobs applies per search, and you pay per job row delivered. One status row is written per search.", "items": { "type": "string" }, "default": [] }, "location": { "title": "Location", "type": "string", "description": "City, region or 'remote', as plain text. Leave empty to search the whole country.", "default": "" }, "country": { "title": "Country", "enum": [ "US", "GB", "CA", "IN", "SG", "BR", "MX" ], "type": "string", "description": "Which Google edition to search. Google has turned the jobs view off in the EU and EEA, and on 2026-10-30 Australia and Japan did not serve it either, so those countries are not offered.", "default": "US" }, "datePosted": { "title": "Date posted", "enum": [ "any", "today", "3days", "week", "month" ], "type": "string", "description": "Only jobs posted in this window.", "default": "any" }, "jobType": { "title": "Job type", "enum": [ "any", "fulltime", "parttime", "contract", "internship" ], "type": "string", "description": "Only jobs of this employment type.", "default": "any" }, "maxJobs": { "title": "Max jobs", "minimum": 1, "maximum": 200, "type": "integer", "description": "Upper limit on job rows (and on what you pay). Default 50, maximum 200. Google shows about 10 jobs per search; the Actor adds refined searches (up to about 23, so about 230 jobs before overlap, typically far fewer after duplicates are removed) only while they keep finding new jobs.", "default": 50 }, "timeBudgetSecs": { "title": "Time budget (seconds)", "minimum": 60, "maximum": 3600, "type": "integer", "description": "The search stops at this time and keeps what it found, with a 'partial' status row.", "default": 120 }, "includeContactNames": { "title": "Keep recruiter and contact names", "type": "boolean", "description": "Off by default: names of recruiters or contact people and personal email addresses inside job descriptions are replaced with [name removed] or [email removed]. Turn on only if you have a lawful reason to process them.", "default": false }, "onlyNewJobs": { "title": "Only new jobs (monitor)", "type": "boolean", "description": "Return and charge only jobs that earlier runs of this same search (query, location, country and filters) have not delivered yet. Schedule it daily to get just what is new. The history is kept in a named key-value store in your account.", "default": false }, "remoteOnly": { "title": "Remote jobs only", "type": "boolean", "description": "Return only remote jobs (location 'Anywhere' or 'Remote' in the title or location). Off by default.", "default": false }, "jobIds": { "title": "Job details lookup (job ids or Google Jobs URLs)", "type": "array", "description": "Detail lookup instead of a search: Google job ids (jobId from an earlier run) or full Google Jobs URLs containing them. Returns only those jobs, with the full description and every apply link, without re-running the search. Leave empty (default) for search mode.", "default": [], "items": { "type": "string" } } } }, "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 } } } } } } } } } }