{ "openapi": "3.0.1", "info": { "title": "Google Jobs Scraper: Salaries, Descriptions, Apply Links", "description": "Scrape Google Jobs listings for any job search and place in 43 countries: title, company, location, source site, posted age, employment type, salary, full description, highlights and direct apply links. Up to ~80 jobs per search, date and job-type filters, no browser. $2 per 1,000 jobs.", "version": "0.1", "x-build-id": "SbjVjWxg97P7ngl6o" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/datagleaner~google-jobs-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-datagleaner-google-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/datagleaner~google-jobs-scraper/runs": { "post": { "operationId": "runs-sync-datagleaner-google-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/datagleaner~google-jobs-scraper/run-sync": { "post": { "operationId": "run-sync-datagleaner-google-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": { "queries": { "title": "Job searches", "type": "array", "description": "What you would type into Google Jobs: a job title or skill (nurse, data analyst, python developer), optionally with a place (warehouse jobs London). One row per job posting found.", "items": { "type": "string" } }, "location": { "title": "Location", "type": "string", "description": "City, region or 'remote', added to every search (Chicago, IL / Berlin / Toronto, ON). Leave empty when your searches already name the place." }, "country": { "title": "Country", "enum": [ "us", "uk", "ca", "au", "nz", "ie", "de", "fr", "es", "it", "nl", "be", "at", "ch", "se", "no", "dk", "fi", "pl", "cz", "pt", "gr", "tr", "in", "jp", "kr", "sg", "hk", "tw", "my", "id", "ph", "th", "vn", "ae", "sa", "il", "za", "br", "mx", "ar", "cl", "co" ], "type": "string", "description": "The Google country the search runs in. It decides which job boards and employers Google shows when the search names no place. The search is placed in the country's largest city.", "default": "us" }, "language": { "title": "Language", "type": "string", "description": "Google interface language as a code (en, de, fr, es...). It changes labels such as 'Posted 3 days ago' and helps Google read filter words; job descriptions stay in the language they were written in.", "default": "en" }, "maxJobsPerQuery": { "title": "Max jobs per search", "minimum": 1, "maximum": 150, "type": "integer", "description": "Stop each search after this many distinct jobs. Google Jobs shows 10 jobs per results page; past 10 the Actor runs narrower searches of the same query (date windows, Google's own filter chips, employment types) and merges them without duplicates. Busy searches reach about 40 to 80 distinct jobs; niche ones fewer.", "default": 50 }, "datePosted": { "title": "Date posted", "enum": [ "any", "today", "3days", "week", "month" ], "type": "string", "description": "Only jobs posted in this window. Google's date filter is used, and any job whose posted age is older is dropped before it is saved (and not charged).", "default": "any" }, "employmentType": { "title": "Employment type", "enum": [ "any", "fullTime", "partTime", "contractor", "internship" ], "type": "string", "description": "Only this kind of job, using Google Jobs' own employment-type matching.", "default": "any" }, "expandSearch": { "title": "Go past the first 10 jobs", "type": "boolean", "description": "On: reach up to Max jobs per search with narrower searches of the same query. Off: only the 10 jobs on Google's first page (cheapest and fastest). Rows found by a narrower search say which in searchVariant.", "default": true }, "maxConcurrency": { "title": "Parallel searches", "minimum": 1, "maximum": 10, "type": "integer", "description": "How many searches run at once. Each Google page takes 5-70 seconds, so more parallel searches finish a long list sooner.", "default": 3 }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Keep the default: Apify Proxy's Google SERP group, which is included in the price. Google sends other datacenter IPs a JavaScript page with no jobs.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "GOOGLE_SERP" ] } } } }, "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 } } } } } } } } } }