{ "openapi": "3.0.1", "info": { "title": "Google Jobs Scraper: Job Listings by Keyword and City", "description": "Scrape Google Jobs for any keyword and city in 30 countries. Get title, company, location, posted date, salary when shown, job type, full description and the apply link. Several search wordings per keyword return 60 to 70 unique jobs. No login, no API key. Pay per job, $5 per 1,000.", "version": "0.1", "x-build-id": "7IFEMuoDDpSX7B69p" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/oski~google-jobs-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-oski-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/oski~google-jobs-scraper/runs": { "post": { "operationId": "runs-sync-oski-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/oski~google-jobs-scraper/run-sync": { "post": { "operationId": "run-sync-oski-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": { "keywords": { "title": "Job titles or keywords", "type": "array", "description": "What to search for, one per line, for example a job title or skill. Each keyword is searched in every location below. A Google search link pasted here also works.", "items": { "type": "string" } }, "locations": { "title": "Locations (optional)", "type": "array", "description": "Cities or regions in the country below, one per line. Leave empty to search the whole country.", "items": { "type": "string" } }, "country": { "title": "Country", "enum": [ "US", "GB", "CA", "AU", "NZ", "IE", "IN", "SG", "ZA", "AE", "DE", "FR", "ES", "IT", "NL", "BE", "CH", "AT", "SE", "DK", "NO", "FI", "PT", "MX", "BR", "PH", "MY", "HK", "JP", "IL" ], "type": "string", "description": "Which Google to search. Google shows a jobs panel in most countries listed; in Australia and Ireland it rarely does, and in Germany and France it shows short description previews.", "default": "US" }, "maxJobsPerSearch": { "title": "Max jobs per search", "minimum": 1, "maximum": 300, "type": "integer", "description": "Google shows 10 jobs per page, so for more the actor searches variations (posted today, part time, entry level and so on) and removes duplicates. About 60 to 75 unique jobs is a typical ceiling for one keyword and city.", "default": 50 }, "maxJobs": { "title": "Max jobs in total", "minimum": 0, "type": "integer", "description": "The run stops after this many jobs. About $5 for 1,000 jobs. 0 means no limit.", "default": 1000 }, "datePosted": { "title": "Date posted", "enum": [ "any", "today", "3days", "week", "month" ], "type": "string", "description": "Only jobs posted in this window. Past 24 hours suits a daily scheduled run.", "default": "any" }, "jobTypes": { "title": "Job types (optional)", "type": "array", "description": "Keep only these job types. Leave empty for all.", "items": { "type": "string", "enum": [ "Full-time", "Part-time", "Contract", "Internship", "Temporary" ], "enumTitles": [ "Full-time", "Part-time", "Contract", "Internship", "Temporary" ] } }, "remoteJobs": { "title": "Remote jobs", "enum": [ "include", "exclude", "only" ], "type": "string", "description": "Whether to include jobs marked remote or work from home.", "default": "include" }, "searchUrls": { "title": "Google search links (optional)", "type": "array", "description": "Paste Google Jobs search links to run their exact query and country. These run as one page each, without variations.", "items": { "type": "string" } }, "resolveApplyLinks": { "title": "Resolve apply links", "type": "boolean", "description": "Turn Google apply redirects into the real job page address (LinkedIn, Indeed, the employer site). On by default; it adds no cost.", "default": true }, "language": { "title": "Language", "type": "string", "description": "Google interface language code, for example en, de or fr. English gives the most consistent fields.", "default": "en" }, "concurrency": { "title": "Searches at once", "minimum": 1, "maximum": 10, "type": "integer", "description": "How many searches to run in parallel.", "default": 4 } } }, "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 } } } } } } } } } }