{ "openapi": "3.0.1", "info": { "title": "Google Jobs Search Scraper", "description": "Scrape job listings from Google Jobs (via Google Search) by keyword and location with country and language targeting. Extracts job title, company, location, salary range, job type, date posted, and application URL — perfect for job market research and recruitment intelligence.", "version": "0.0", "x-build-id": "2OFEudfAcluaWk3fM" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/jobsapi~google-jobs-search-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-jobsapi-google-jobs-search-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/jobsapi~google-jobs-search-scraper/runs": { "post": { "operationId": "runs-sync-jobsapi-google-jobs-search-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/jobsapi~google-jobs-search-scraper/run-sync": { "post": { "operationId": "run-sync-jobsapi-google-jobs-search-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": [ "query" ], "properties": { "query": { "title": "Job Search Query", "type": "string", "description": "Job title or keywords to search for", "default": "software engineer" }, "queries": { "title": "Multiple Job Queries", "type": "array", "description": "Optional additional job queries processed in order.", "items": { "type": "string" } }, "location": { "title": "Location", "type": "string", "description": "Job location (city, state, country)", "default": "United States" }, "maxItems": { "title": "Maximum Items", "minimum": 1, "maximum": 500, "type": "integer", "description": "Maximum number of job listings to scrape", "default": 50 }, "gl": { "title": "Country", "type": "string", "description": "Country code for localized results", "default": "us" }, "hl": { "title": "Language", "type": "string", "description": "Language code", "default": "en" }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Optionally, use Apify Proxy or custom HTTP proxy to avoid IP address-based blocking.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "GOOGLE_SERP" ], "apifyProxyCountry": "US" } }, "experienceLevel": { "title": "Experience Level", "enum": [ "", "entry", "mid", "senior", "executive", "director" ], "type": "string", "description": "Filter by minimum experience level required for the position.", "default": "" }, "salaryMin": { "title": "Minimum Salary", "minimum": 0, "type": "integer", "description": "Minimum salary filter (in local currency). Only show jobs paying at least this amount." }, "salaryMax": { "title": "Maximum Salary", "minimum": 0, "type": "integer", "description": "Maximum salary filter (in local currency). Only show jobs paying at most this amount." }, "remoteFilter": { "title": "Remote / On-site / Hybrid", "enum": [ "", "remote", "hybrid", "onsite" ], "type": "string", "description": "Filter by work location type.", "default": "" }, "educationLevel": { "title": "Education Level", "enum": [ "", "high_school", "associate", "bachelor", "master", "doctorate" ], "type": "string", "description": "Filter by minimum education level required.", "default": "" }, "debugMode": { "title": "Debug Mode", "type": "boolean", "description": "Enable to save screenshots, HTML snapshots, and network logs to the Key-Value Store for troubleshooting.", "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 } } } } } } } } } }