{ "openapi": "3.0.1", "info": { "title": "Google Jobs Scraper", "description": "Google Jobs scraper to extract job listings, company names, job titles, locations, salaries (when available), posting dates, and other publicly available job details from Google Jobs πŸ’ΌπŸ“Š Perfect for job market research, recruitment, lead generation, and employment trend analysis.", "version": "0.1", "x-build-id": "P5mdUT7G3Fb01peD6" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapers-hub~google-jobs-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapers-hub-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/scrapers-hub~google-jobs-scraper/runs": { "post": { "operationId": "runs-sync-scrapers-hub-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/scrapers-hub~google-jobs-scraper/run-sync": { "post": { "operationId": "run-sync-scrapers-hub-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": { "query": { "title": "Search query", "type": "string", "description": "What to search for, e.g. \"Software Engineer\". Ignored if a direct URL is given.", "default": "Software Engineer" }, "url": { "title": "Direct Google Jobs URL (optional)", "type": "string", "description": "A ready-made Google Jobs / Google search URL. Overrides the query when set." }, "location": { "title": "Location", "type": "string", "description": "City / state / country to bias the search, e.g. \"San Francisco, CA\"." }, "country": { "title": "Country", "enum": [ "us", "ca", "uk", "de", "fr", "au", "jp", "in", "br", "mx" ], "type": "string", "description": "Google country code (gl).", "default": "us" }, "language": { "title": "Language", "type": "string", "description": "Interface language code (hl), e.g. \"en\".", "default": "en" }, "googleDomain": { "title": "Google domain", "type": "string", "description": "Google domain to hit, e.g. \"google.com\" or \"google.ca\".", "default": "google.com" }, "maxItems": { "title": "Max items", "minimum": 10, "maximum": 1000, "type": "integer", "description": "Maximum number of jobs to collect (10-1000).", "default": 100 }, "maxPagination": { "title": "Max pagination (scroll rounds)", "minimum": 0, "type": "integer", "description": "0 = scroll until maxItems (or no more results).", "default": 0 }, "includeLrad": { "title": "Enable location-radius filter", "type": "boolean", "description": "Apply a location-radius (lrad) filter.", "default": false }, "lradValue": { "title": "Location radius (km)", "type": "string", "description": "Radius in km; only used when the location-radius filter is enabled.", "default": "5" }, "maxDelay": { "title": "Max delay between scrolls (seconds)", "minimum": 0, "maximum": 10, "type": "integer", "description": "Pause between scroll rounds (0-10).", "default": 1 }, "engine": { "title": "Engine", "enum": [ "auto", "browser", "requests" ], "type": "string", "description": "Rendering engine. \"browser\" (Playwright) is the real path for udm=8; \"requests\" is legacy.", "default": "auto" }, "debug": { "title": "Debug", "type": "boolean", "description": "Dump debug HTML/screenshots to the key-value store.", "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 } } } } } } } } } }