{ "openapi": "3.0.1", "info": { "title": "Google Jobs Scraper - Salary, Boards & Descriptions", "description": "Scrape the Google Jobs vertical by keyword and location. Returns title, company, location, source board (LinkedIn, Stepstone, XING, company careers), posted date, salary and full description. Monitor mode returns only jobs you haven't seen. Null-honest output. Export CSV/JSON.", "version": "1.0", "x-build-id": "roySdKtZk4wio1fWe" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/webdatalabs~google-jobs-intelligence/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-webdatalabs-google-jobs-intelligence", "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/webdatalabs~google-jobs-intelligence/runs": { "post": { "operationId": "runs-sync-webdatalabs-google-jobs-intelligence", "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/webdatalabs~google-jobs-intelligence/run-sync": { "post": { "operationId": "run-sync-webdatalabs-google-jobs-intelligence", "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": "What to search for on Google Jobs. Each entry runs its own search, e.g. \"software engineer\" or \"registered nurse\".", "items": { "type": "string" } }, "locations": { "title": "Locations", "type": "array", "description": "Cities, regions or countries to search in, e.g. \"Berlin\", \"Munich\", \"United States\". Every job title is searched in every location, so adding locations is how you get more results.", "items": { "type": "string" } }, "maxJobs": { "title": "Maximum jobs", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Upper limit on unique jobs returned. Google shows about 10 jobs per search, so the realistic maximum is roughly (job titles x locations x 10).", "default": 100 }, "postedWithin": { "title": "Posted within", "enum": [ "any", "today", "3days", "week", "month" ], "type": "string", "description": "Only return jobs published in this time window.", "default": "any" }, "employmentType": { "title": "Employment type", "type": "array", "description": "Only return jobs matching these employment types. Leave empty for all types.", "items": { "type": "string", "enum": [ "fulltime", "parttime", "contractor", "internship" ], "enumTitles": [ "Full-time", "Part-time", "Contract", "Internship" ] }, "default": [] }, "monitorMode": { "title": "Only return jobs I haven't seen before", "type": "boolean", "description": "Remembers jobs across runs and returns only newly posted ones. Ideal for a scheduled job alert - you are never charged twice for the same posting.", "default": false }, "country": { "title": "Country", "enum": [ "us", "gb", "de", "at", "ch", "ca", "au", "ie", "nl", "fr", "es", "it", "in", "sg" ], "type": "string", "description": "Which country's Google results to use. Controls which local job boards appear.", "default": "us" }, "remoteOnly": { "title": "Remote jobs only", "type": "boolean", "description": "Only return jobs Google flags as remote or work-from-home.", "default": false }, "includeDescription": { "title": "Include full job description", "type": "boolean", "description": "Include the complete job description text. Costs nothing extra - Google returns it with the listing.", "default": true }, "debug": { "title": "Debug logging", "type": "boolean", "description": "Log extra diagnostics, including per-field extraction rates.", "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 } } }, "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 } } } } } } } } } }