{ "openapi": "3.0.1", "info": { "title": "Google Jobs Scraper", "description": "Extract public Google Jobs listings by query and location. Export titles, companies, locations, source sites, dates, snippets, salaries, and apply links.", "version": "0.1", "x-build-id": "pSco2cUQVFXLnj9Jy" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/fetch_cat~google-jobs-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-fetch_cat-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/fetch_cat~google-jobs-scraper/runs": { "post": { "operationId": "runs-sync-fetch_cat-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/fetch_cat~google-jobs-scraper/run-sync": { "post": { "operationId": "run-sync-fetch_cat-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": { "acquisitionMode": { "title": "Acquisition mode", "enum": [ "auto", "provider", "browser" ], "type": "string", "description": "Auto uses provider-managed Google Jobs acquisition on supported English routes up to 20 jobs. Larger accepted limits, direct access, custom proxy groups and other unsupported settings retain browser acquisition. Provider mode rejects incompatible settings before charging start rather than overriding them. Experimental 21–40 provider expansion is disabled even with approved active fees; pending prices, input flags and environment variables do not enable it.", "default": "auto" }, "queries": { "title": "Job search queries", "minItems": 1, "type": "array", "description": "One or more job search phrases. Use the same wording you would type into Google Jobs.", "items": { "type": "string" } }, "location": { "title": "Location", "type": "string", "description": "City, region, country, or remote-work phrase appended to each query.", "default": "New York, NY" }, "country": { "title": "Country / Google market", "minLength": 2, "maxLength": 2, "type": "string", "description": "Two-letter country code for Google results and proxy geotargeting.", "default": "US" }, "language": { "title": "Language", "minLength": 2, "maxLength": 5, "type": "string", "description": "Two-letter language code for Google result labels.", "default": "en" }, "maxItems": { "title": "Maximum jobs", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Maximum total listings across all queries. Provider acquisition supports up to 20; larger accepted limits select the unchanged browser route in Auto, without truncation. Searches can return fewer results. The current-price provider repair charges only start and saved listings. A shared acquisition deadline (45–90 seconds when funded at current prices; 45 seconds with active search-page pricing) and operating allowance can cause an explicit error before another query. Current-priced runs charge only start and saved listings; approved active search-page pricing uses the disclosed page charges.", "default": 20 }, "datePosted": { "title": "Date posted", "enum": [ "any", "past_24_hours", "past_3_days", "past_week", "past_month" ], "type": "string", "description": "Optional Google Jobs date filter. The actor applies it when Google exposes the matching filter chip.", "default": "any" }, "employmentType": { "title": "Employment type", "enum": [ "any", "full_time", "part_time", "contractor", "internship" ], "type": "string", "description": "Optional Google Jobs employment-type filter. The actor applies it when Google exposes the matching filter chip.", "default": "any" }, "useProxy": { "title": "Use Apify Proxy", "type": "boolean", "description": "False always selects direct browser access, never provider-managed egress. True permits Auto provider acquisition on validated routes; on the browser route it enables the selected Apify Proxy groups.", "default": true }, "proxyGroups": { "title": "Proxy groups", "type": "array", "description": "Default RESIDENTIAL permits Auto provider acquisition, which uses the provider's own network and no Apify Proxy. Custom group selections always use the browser route and retain their groups. Browser RESIDENTIAL may recover once through UNBLOCKER, adding metered usage.", "default": [ "RESIDENTIAL" ], "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 } } } } } } } } } }