{ "openapi": "3.0.1", "info": { "title": "Google Jobs Scraper: Listings, Salaries & Apply Links", "description": "Scrape Google Jobs listings for any search and location: title, company, salary, full description, posted date and every apply link (LinkedIn, Indeed, company site). Pay only per job, never for empty pages.", "version": "0.1", "x-build-id": "gzrogAke2hVgVApZV" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/tidyscrape~google-jobs-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-tidyscrape-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/tidyscrape~google-jobs-scraper/runs": { "post": { "operationId": "runs-sync-tidyscrape-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/tidyscrape~google-jobs-scraper/run-sync": { "post": { "operationId": "run-sync-tidyscrape-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", "required": [ "queries" ], "properties": { "queries": { "title": "Job searches", "type": "array", "description": "What to search for, as you would type it into Google, e.g. \"software engineer\", \"registered nurse\" or \"barista part time\". Each search is run once per location. You can put the place in the search itself (\"data analyst jobs in Denver\") and leave Locations empty.", "items": { "type": "string" } }, "locations": { "title": "Locations", "type": "array", "description": "Optional places to search in, e.g. \"Austin, TX\", \"London\" or \"Berlin\". Each is added to every search the way Google's own location phrasing works (\"software engineer Austin, TX\"). Leave empty to search without a place: Google then picks jobs near the proxy's exit location, so add a location or country-wide place (\"United States\") for predictable results.", "items": { "type": "string" } }, "maxJobsPerQuery": { "title": "Max jobs per search and location", "minimum": 1, "maximum": 300, "type": "integer", "description": "Stop after this many unique jobs for each search × location. Google shows 10 jobs per search; for more, the Actor re-runs the search with Google's own filters (job type, date posted) and keeps only new jobs, which usually yields 50-100+ unique jobs for a broad search in a big city. You pay only per job returned, so this also caps cost.", "default": 50 }, "datePosted": { "title": "Date posted", "enum": [ "any", "today", "3days", "week", "month" ], "type": "string", "description": "Only jobs posted within this period. Jobs whose age Google shows as older are dropped (and not charged).", "default": "any" }, "employmentType": { "title": "Employment type", "enum": [ "any", "FULL_TIME", "PART_TIME", "CONTRACTOR", "INTERN" ], "type": "string", "description": "Only this type of job. Google's own filter is loose, so jobs that Google labels with a different type are dropped (and not charged), unless the title states the type (e.g. \"Software Engineer Intern\"). Jobs with no type label are kept.", "default": "any" }, "remoteOnly": { "title": "Remote / work from home", "type": "boolean", "description": "Apply Google's \"Remote\" (work from home) filter. Results then come from anywhere in the country, not only the locations above.", "default": false }, "country": { "title": "Country (gl)", "type": "string", "description": "2-letter country code Google searches from, e.g. \"us\", \"gb\", \"ca\", \"de\", \"in\". Match it to your locations.", "default": "us" }, "language": { "title": "Language (hl)", "type": "string", "description": "Google interface language, e.g. \"en\", \"de\", \"fr\". It sets the language of labels such as \"3 days ago\" and \"Full-time\"; the job texts stay in the language they were posted in. Filters are verified for \"en\" and \"de\".", "default": "en" }, "maxConcurrency": { "title": "Parallel requests", "minimum": 1, "maximum": 20, "type": "integer", "description": "How many Google requests run at once across all searches. Each takes 15-40 s through Google's SERP proxy, so parallel requests make large runs much faster.", "default": 5 }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Keep the default: Apify's GOOGLE_SERP proxy group, the only one that returns Google Jobs results (other proxies get a JavaScript-only page).", "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 } } } } } } } } } }