{ "openapi": "3.0.1", "info": { "title": "Google Jobs Scraper for Job Search, Listings and Salaries", "description": "Scrape Google Jobs in 36 supported countries for job search and job postings: titles, companies, locations, available salary figures, descriptions, highlights and direct apply links. Includes new-job monitoring. Pay per saved job, no start fee. Maintained by CleanScrape.", "version": "0.1", "x-build-id": "IgxUCz6ttbRLIglEm" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/cleanscrape~google-jobs-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-cleanscrape-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/cleanscrape~google-jobs-scraper/runs": { "post": { "operationId": "runs-sync-cleanscrape-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/cleanscrape~google-jobs-scraper/run-sync": { "post": { "operationId": "run-sync-cleanscrape-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 titles or keywords", "type": "array", "description": "One per line, such as \"registered nurse\" or \"python developer\". Outside English-speaking countries, type them in the local language (\"Buchhalter\" in Germany). You can also paste a Google Jobs or Google search link.", "items": { "type": "string" } }, "locations": { "title": "Locations", "type": "array", "description": "Optional. One per line: a city, state or region, or \"remote\". Every title is searched in every location. Leave empty to search the whole country.", "items": { "type": "string" } }, "country": { "title": "Country", "enum": [ "us", "ar", "at", "br", "ca", "cl", "co", "dk", "eg", "fr", "de", "gr", "hk", "in", "id", "it", "jp", "ke", "my", "mx", "ng", "pk", "pe", "ph", "pt", "qa", "sa", "sg", "za", "es", "ch", "tw", "th", "ae", "gb", "vn" ], "type": "string", "description": "The country of your locations. A location that names its country (\"Berlin, Germany\") is searched there anyway. Field names and labels are in English; titles and descriptions stay as posted.", "default": "us" }, "maxJobsPerSearch": { "title": "Jobs per search", "minimum": 1, "maximum": 300, "type": "integer", "description": "For each title in each location. Google shows 10 jobs per search; the Actor finds more by running close variations of it. Broad searches usually reach 100–200. 50 jobs cost about $0.10.", "default": 50 }, "postedWithin": { "title": "Posted within", "enum": [ "any", "today", "3days", "week", "month" ], "type": "string", "description": "Only jobs posted in this period.", "default": "any" }, "employmentType": { "title": "Job type", "enum": [ "any", "fulltime", "parttime", "contractor", "internship" ], "type": "string", "description": "Only jobs of this type. Jobs whose type Google does not show are left out.", "default": "any" }, "includeDescription": { "title": "Full job description", "type": "boolean", "description": "Turn off for smaller exports. Highlights (qualifications, benefits, responsibilities) and apply links are kept either way.", "default": true }, "onlyNewJobs": { "title": "Only jobs not saved before", "type": "boolean", "description": "For scheduled runs: skips jobs that earlier runs already saved, so each run gives only new jobs. Skipped jobs are not charged. Jobs are remembered for 90 days. From November 22, 2026, each search checked in a monitoring run costs $6 per 1,000 searches (less on paid plans).", "default": false }, "watchName": { "title": "Watch name (optional)", "maxLength": 80, "type": "string", "description": "Leave empty, and runs with the same searches share one history. Or give a name, such as \"Nurse jobs Chicago\", to keep the history when you change the searches." } } }, "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 } } } } } } } } } }