{ "openapi": "3.0.1", "info": { "title": "Google Jobs Scraper - Job Search Results by Query & Location", "description": "Search Google Jobs by keyword and location and get structured job results, source boards and apply links. Bulk query/location searches, deduplicated output, pay per job result.", "version": "1.0", "x-build-id": "Ss9a2AmFNWec0xfm5" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/sauliusautomatesit~google-jobs-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-sauliusautomatesit-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/sauliusautomatesit~google-jobs-scraper/runs": { "post": { "operationId": "runs-sync-sauliusautomatesit-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/sauliusautomatesit~google-jobs-scraper/run-sync": { "post": { "operationId": "run-sync-sauliusautomatesit-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": "Search queries", "type": "array", "description": "Job search keywords, e.g. \"software engineer\". Each query is combined with every location below.", "default": [], "items": { "type": "string" } }, "locations": { "title": "Locations", "type": "array", "description": "Cities or regions, e.g. \"London\". Leave empty to search without a location.", "default": [], "items": { "type": "string" } }, "searches": { "title": "Explicit query/location pairs (advanced)", "type": "array", "description": "Exact pairs instead of the query x location grid, e.g. [{\"query\":\"chef\",\"location\":\"Edinburgh\",\"countryCode\":\"gb\"}]. Each item may set its own countryCode.", "default": [] }, "countryCode": { "title": "Country", "enum": [ "us", "gb", "ca", "de", "in", "ie", "fr", "es", "it", "nl", "pl", "se", "br", "mx", "za", "sg", "ph", "nz", "jp", "au" ], "type": "string", "description": "Two-letter country code that selects the Google domain and locale. Verified coverage: us, gb, ca, de, in. Google serves no Jobs results for some countries (e.g. au).", "default": "us" }, "languageCode": { "title": "Language", "type": "string", "description": "Interface language passed to Google as hl, e.g. \"en\".", "default": "en" }, "maxResultsPerSearch": { "title": "Max results per search", "minimum": 1, "maximum": 40, "type": "integer", "description": "Google returns up to 10 jobs per query on the Jobs tab and offers no pagination. Values above 10 only take effect together with \"Extra date filters\".", "default": 10 }, "maxTotalResults": { "title": "Max total results", "minimum": 1, "type": "integer", "description": "Hard cap on unique job results across the whole run.", "default": 1000 }, "retryOnEmpty": { "title": "Retry empty searches once", "type": "boolean", "description": "Google intermittently serves a jobs-less page; one retry recovers it. Costs one extra SERP only when a search comes back empty.", "default": true }, "extraDateFilters": { "title": "Extra date filters (more results per query)", "type": "array", "description": "Google's Jobs tab has no pagination. Adding date-filtered views surfaces some extra jobs the default view omits. Each filter costs one additional Google SERP per search, so enable only if you need more than 10 results per query.", "items": { "type": "string", "enum": [ "today", "week", "month", "year" ], "enumTitles": [ "Past 24 hours", "Past week", "Past month", "Past year" ] }, "default": [] } } }, "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 } } }, "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 } } } } } } } } } }