{ "openapi": "3.0.1", "info": { "title": "Google Jobs Scraper", "description": "Scrape Google Jobs listings by keyword and location. Get job title, company, salary range, job type, posted date, remote flag, full description, qualifications, benefits and direct apply links from LinkedIn, Indeed and employer sites.", "version": "0.1", "x-build-id": "JYebWzzDi24pXVCyk" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/cirkit~google-jobs-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-cirkit-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/cirkit~google-jobs-scraper/runs": { "post": { "operationId": "runs-sync-cirkit-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/cirkit~google-jobs-scraper/run-sync": { "post": { "operationId": "run-sync-cirkit-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", "minItems": 1, "type": "array", "description": "What to search for on Google Jobs, one search per line, for example \"software engineer\" or \"registered nurse\". Each search is run separately and postings are deduped across all of them.", "items": { "type": "string" } }, "location": { "title": "Location", "type": "string", "description": "City, region or country to search in, for example \"New York, NY\", \"Austin, Texas\", \"London\" or \"Germany\". Leave empty to let Google choose from the proxy location, which is random, so setting this is strongly recommended." }, "maxResultsPerQuery": { "title": "Max postings per search", "minimum": 1, "maximum": 300, "type": "integer", "description": "Upper limit of unique postings for each search. Google shows ten postings per page, so the actor walks Google's own filter chips (full time, part time, contract, posted this week, and so on) to go deeper. Expect roughly 50 to 100 unique postings per search at most; add more searches or locations for more volume.", "default": 50 }, "maxItems": { "title": "Max postings in total", "minimum": 0, "type": "integer", "description": "Hard cap on rows across every search, and therefore on what the run can cost. Leave empty for no cap." }, "datePosted": { "title": "Date posted", "enum": [ "any", "today", "3days", "week", "month" ], "type": "string", "description": "Only postings published within this window.", "default": "any" }, "employmentType": { "title": "Employment type", "enum": [ "any", "FULLTIME", "PARTTIME", "CONTRACTOR", "INTERN" ], "type": "string", "description": "Only postings of this schedule type.", "default": "any" }, "remoteOnly": { "title": "Remote jobs only", "type": "boolean", "description": "Only postings Google classifies as remote or work from home.", "default": false }, "country": { "title": "Google country", "type": "string", "description": "Two-letter Google country code (gl), for example us, gb, ca, de or in. Sets the Google market and the salary currency. Use Location to target a city.", "default": "us" }, "language": { "title": "Language", "type": "string", "description": "Google interface language code (hl), for example en, de, fr or es.", "default": "en" }, "resolveApplyLinks": { "title": "Resolve apply links", "type": "boolean", "description": "Turn Google's redirect links into the employer's or job board's real URL (one extra lightweight request per apply option). Turn off to keep Google's links and run slightly faster.", "default": true }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "This actor requires the Apify GOOGLE_SERP proxy group, the supported route to Google search pages. The default is correct for almost every run. Datacenter and residential groups return a JavaScript shell with no postings in it.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "GOOGLE_SERP" ] } } } }, "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 } } } } } } } } } }