{ "openapi": "3.0.1", "info": { "title": "Google Jobs Scraper & API — Job Listings & Salaries", "description": "Scrape Google Jobs to JSON, CSV or Excel: title, company, location, salary range, dates, job type, benefits, full description, qualifications and every apply link. Search by keyword and location or paste Google Jobs URLs. Pay per job delivered plus a small start fee, no platform fees.", "version": "2.0", "x-build-id": "fPVPueenKfxbtPLzC" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/aaronoptimus~google-jobs-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-aaronoptimus-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/aaronoptimus~google-jobs-scraper/runs": { "post": { "operationId": "runs-sync-aaronoptimus-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/aaronoptimus~google-jobs-scraper/run-sync": { "post": { "operationId": "run-sync-aaronoptimus-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 or Google Jobs URLs", "type": "array", "description": "What you would type into Google, e.g. \"software engineer\" or \"nurse in Boston\". One search per line. You can also paste Google Jobs URLs (search on Google, open the Jobs tab, copy the address).", "items": { "type": "string" } }, "locations": { "title": "Locations", "type": "array", "description": "Optional. A city, state or region per line, e.g. \"Austin, TX\" or \"Remote\". Every search runs once for every location. Leave empty to search the whole country below.", "default": [], "items": { "type": "string" } }, "country": { "title": "Country", "enum": [ "US", "GB", "CA", "AU", "IN", "IE", "NZ", "SG", "ZA", "DE", "FR", "ES", "IT", "NL", "BE", "AT", "CH", "PT", "PL", "SE", "NO", "DK", "FI", "BR", "MX", "AR", "CO", "CL", "PE", "JP", "KR", "PH", "MY", "ID", "TH", "VN", "AE", "SA", "IL", "TR", "NG", "KE", "EG" ], "type": "string", "description": "Google shows jobs for this country (it sets Google's gl country parameter).", "default": "US" }, "language": { "title": "Language", "type": "string", "description": "Language of Google's page, e.g. en, de, fr, es, pt-BR. English gives the most complete parsing of dates and salary ranges; job texts stay in the language they were posted in.", "default": "en" }, "maxJobsPerSearch": { "title": "Max jobs per search", "minimum": 1, "maximum": 500, "type": "integer", "description": "Stop each search after this many jobs. Google Jobs returns about 10 results per search, so run several focused searches (by title, location or date) to cover more.", "default": 10 }, "datePosted": { "title": "Date posted", "enum": [ "any", "today", "3days", "week", "month" ], "type": "string", "description": "Only jobs posted recently.", "default": "any" }, "employmentType": { "title": "Job type", "enum": [ "any", "FULLTIME", "PARTTIME", "CONTRACTOR", "INTERN" ], "type": "string", "description": "Only this kind of job.", "default": "any" }, "remoteOnly": { "title": "Remote / work from home only", "type": "boolean", "description": "Only jobs Google marks as remote or work from home.", "default": false }, "deduplicateAcrossSearches": { "title": "Skip jobs already found by another search", "type": "boolean", "description": "When two searches find the same job, deliver (and charge) it once.", "default": true }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Google blocks automated access from most IPs. This Actor always uses Apify's Google Search proxy (the GOOGLE_SERP group), the reliable source for Google results; other proxy choices are replaced by it. A new IP is used on every retry.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "GOOGLE_SERP" ] } }, "maxConcurrency": { "title": "Parallel searches", "minimum": 1, "maximum": 10, "type": "integer", "description": "How many searches run at the same time.", "default": 3 }, "maxRetries": { "title": "Max retries per page", "minimum": 0, "maximum": 10, "type": "integer", "description": "When Google blocks a request (its \"unusual traffic\" check), it is retried with a new IP, up to this many times. CAPTCHAs are never solved, and jobs already delivered are never charged again.", "default": 6 }, "debugSnapshots": { "title": "Save page snapshots", "type": "boolean", "description": "For troubleshooting: saves the HTML and a screenshot of each search page to the run's key-value store.", "default": false } } }, "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 } } } } } } } } } }