{ "openapi": "3.0.1", "info": { "title": "Google Jobs Scraper: Salaries, Apply Links & API", "description": "Google Jobs scraper and API: every job Google shows for your searches, up to 200 per search, with full description, all apply links, salary normalised to yearly and hourly, posting date and remote flag. Failed searches are free.", "version": "1.0", "x-build-id": "H23S7sLyRspqKYEbK" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/meridianlabs~google-jobs-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-meridianlabs-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/meridianlabs~google-jobs-scraper/runs": { "post": { "operationId": "runs-sync-meridianlabs-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/meridianlabs~google-jobs-scraper/run-sync": { "post": { "operationId": "run-sync-meridianlabs-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": "One search per line, the way you would type it into Google Jobs: a job title or keywords, e.g. 'registered nurse', 'python developer', 'warehouse night shift'.", "items": { "type": "string" } }, "locations": { "title": "Locations", "type": "array", "description": "Cities, states or countries, one per line, e.g. 'Austin, TX', 'Manchester, UK', 'Toronto', 'Germany'. Every search runs in every location. Google Jobs covers 76 countries including the US, UK, Canada, India, most of Europe and the Gulf; it does not run in Australia, New Zealand or Ireland. Ambiguous names go to the biggest city (London means London, England); write 'London, Ontario' for another one. Each row of results shows the exact place searched.", "default": [ "United States" ], "items": { "type": "string" } }, "maxJobsPerQuery": { "title": "Max jobs per search", "minimum": 1, "maximum": 200, "type": "integer", "description": "Up to 200 (the most Google Jobs shows for one search). Broad searches usually have 150-200; narrow ones fewer. You are only charged for jobs saved.", "default": 100 }, "datePosted": { "title": "Date posted", "enum": [ "any", "today", "3days", "week", "month" ], "type": "string", "description": "Keep only jobs posted in this window. Google shows a date on most jobs but not all; jobs without one are left out when this is set. Removed jobs are not charged.", "default": "any" }, "employmentTypes": { "title": "Employment type", "type": "array", "description": "Keep only these types (empty = all). With one type picked, its words are also added to the search so Google returns more of them. Removed jobs are not charged.", "items": { "type": "string", "enum": [ "fulltime", "parttime", "contractor", "intern" ], "enumTitles": [ "Full-time", "Part-time", "Contractor", "Internship" ] }, "default": [] }, "remoteOnly": { "title": "Remote jobs only", "type": "boolean", "description": "Adds 'remote' to each search and keeps only jobs Google marks as work from home or 'Anywhere'.", "default": false }, "radiusKm": { "title": "Search radius (km)", "minimum": 1, "maximum": 300, "type": "integer", "description": "Optional: how far around a city to search (for miles, multiply by 1.609). Empty = Google's default for that place." }, "language": { "title": "Language", "type": "string", "description": "Language code for Google's page, e.g. en, de, fr, es. English works everywhere.", "default": "en" }, "includeDescription": { "title": "Include full description", "type": "boolean", "description": "Turn off for smaller rows. Highlights (qualifications, benefits, responsibilities) are always included.", "default": true }, "dedupe": { "title": "Remove duplicates across searches", "type": "boolean", "description": "A job found by two of your searches is saved and charged once.", "default": true }, "failOnErrors": { "title": "Fail the run if any search fails", "type": "boolean", "description": "Useful for schedules: the run is marked failed (so Apify can alert you) if a search could not be completed. Failed searches are never charged.", "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 } } } } } } } } } }