{ "openapi": "3.0.1", "info": { "title": "Google Jobs Scraper", "description": "The most advanced Google Jobs Scraper available! Built with enterprise-grade flexibility, lightning-fast performance, and comprehensive customization options. Extract detailed job data, application links, company information, and full job descriptions. Unlimited usage, no monthly rental fees.", "version": "0.0", "x-build-id": "HvBGQ07cgyRufoelO" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/johnvc~Google-Jobs-Scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-johnvc-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/johnvc~Google-Jobs-Scraper/runs": { "post": { "operationId": "runs-sync-johnvc-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/johnvc~Google-Jobs-Scraper/run-sync": { "post": { "operationId": "run-sync-johnvc-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": [ "query" ], "properties": { "query": { "title": "Job Search Query", "minLength": 1, "type": "string", "description": "The job search query (e.g., 'Software Engineer', 'Data Scientist', 'Marketing Manager')" }, "location": { "title": "Job Location", "type": "string", "description": "Job location (city, state, or country). We recommend specifying a location at the city level for best results. If left empty and a Country Code is selected, the country name is used as the location automatically. If Google returns no results for a location-targeted search, the actor automatically retries with the location merged into the query." }, "country": { "title": "Country Code", "enum": [ "None", "dz", "as", "ai", "ag", "ar", "at", "bs", "bh", "be", "bz", "bo", "br", "ca", "co", "cr", "cu", "dk", "dm", "do", "ec", "eg", "sv", "gm", "de", "gh", "gr", "gt", "gy", "hn", "hk", "in", "id", "iq", "it", "ci", "jm", "jp", "jo", "kw", "ly", "my", "mu", "mx", "ma", "na", "nl", "ni", "ng", "om", "pk", "ps", "pa", "py", "pe", "ph", "pt", "pr", "qa", "ru", "rw", "vc", "sa", "sl", "sg", "za", "es", "lk", "sr", "ch", "tw", "th", "tt", "tn", "vi", "ug", "ae", "uk", "us", "uy", "ve", "vn", "zm", "zw" ], "type": "string", "description": "Country the search targets - this is what drives regional results (Google's gl parameter), and when Job Location is empty the country's name is used as the location automatically. If unset, it is derived from the Google Domain (e.g. google.nl -> nl) and the actor logs a warning. Only countries where Google Jobs actually serves listings are selectable; a run targeting an unsupported country stops immediately with a clear message and charges no page fee.", "default": "None" }, "language": { "title": "Language Code", "enum": [ "None", "en", "es", "fr", "de", "it", "pt", "ja", "ko", "zh", "ru", "ar", "bg", "bn", "ca", "cs", "da", "nl", "et", "fi", "el", "gu", "he", "hi", "hr", "hu", "id", "is", "kn", "lt", "lv", "mk", "mg", "ms", "ml", "mt", "mv", "mi", "mr", "mfe", "mo", "mn", "sr-me", "my", "ne", "pcm", "nso", "no", "nn", "oc", "or", "om", "ps", "fa", "xx-pirate", "pl", "pt-br", "pt-pt", "pa", "qu", "ro", "rm", "nyn", "gd", "sr", "sh", "st", "tn", "crs", "sn", "sd", "si", "sk", "sl", "so", "es-419", "su", "sw", "sv", "tg", "ta", "tt", "te", "th", "ti", "to", "lua", "tum", "tr", "tk", "tw", "ug", "uk", "ur", "uz", "vu", "vi", "cy", "wo", "xh", "yi", "yo", "zu" ], "type": "string", "description": "Interface language for the search (Google's hl parameter). Optional and usually best left unset: Google then uses the language that matches the country, which is required in many non-English markets - explicitly setting English (en) makes countries such as the Netherlands, Germany, Spain, Brazil, or Japan return zero results. Set it only when you specifically need a given interface language.", "default": "None" }, "google_domain": { "title": "Google Domain", "enum": [ "google.com", "google.co.uk", "google.ca", "google.de", "google.fr", "google.com.au", "google.co.jp", "google.ad", "google.ae", "google.al", "google.am", "google.as", "google.at", "google.az", "google.ba", "google.be", "google.bf", "google.bg", "google.bi", "google.bj", "google.bs", "google.by", "google.cd", "google.cf", "google.cg", "google.ch", "google.ci", "google.cl", "google.cm", "google.co.bw", "google.co.ck", "google.co.cr", "google.co.id", "google.co.il", "google.co.in", "google.co.ke", "google.co.kr", "google.co.ls", "google.co.ma", "google.co.mz", "google.co.nz", "google.co.th", "google.co.tz", "google.co.ug", "google.co.uz", "google.co.ve", "google.co.vi", "google.co.za", "google.co.zm", "google.co.zw", "google.com.af", "google.com.ag", "google.com.ai", "google.com.ar", "google.com.bd", "google.com.bh", "google.com.bn", "google.com.bo", "google.com.br", "google.com.bz", "google.com.co", "google.com.cu", "google.com.cy", "google.com.do", "google.com.ec", "google.com.eg", "google.com.et", "google.com.fj", "google.com.gh", "google.com.gi", "google.com.gt", "google.com.hk", "google.com.jm", "google.com.kh", "google.com.kw", "google.com.lb", "google.com.ly", "google.com.mm", "google.com.mt", "google.com.mx", "google.com.my", "google.com.na", "google.com.ng", "google.com.ni", "google.com.om", "google.com.pa", "google.com.pe", "google.com.pg", "google.com.ph", "google.com.pk", "google.com.pr", "google.com.py", "google.com.qa", "google.com.sa", "google.com.sb", "google.com.sg", "google.com.sl", "google.com.sv", "google.com.tj", "google.com.tr", "google.com.tw", "google.com.ua", "google.com.uy", "google.com.vc", "google.com.vn", "google.cv", "google.cz", "google.dj", "google.dk", "google.dm", "google.dz", "google.ee", "google.es", "google.fi", "google.fm", "google.ga", "google.ge", "google.gl", "google.gm", "google.gp", "google.gr", "google.gy", "google.hn", "google.hr", "google.ht", "google.hu", "google.ie", "google.iq", "google.is", "google.it", "google.je", "google.jo", "google.kg", "google.ki", "google.kz", "google.la", "google.li", "google.lk", "google.lt", "google.lu", "google.lv", "google.md", "google.mg", "google.mk", "google.ml", "google.mn", "google.ms", "google.mu", "google.mv", "google.mw", "google.ne", "google.nl", "google.no", "google.nr", "google.nu", "google.pl", "google.ps", "google.pt", "google.ro", "google.rs", "google.ru", "google.rw", "google.sc", "google.se", "google.sh", "google.si", "google.sk", "google.sm", "google.sn", "google.so", "google.sr", "google.td", "google.tg", "google.tk", "google.tl", "google.tm", "google.tn", "google.to", "google.tt", "google.vg", "google.vu", "google.ws" ], "type": "string", "description": "Google domain to use for search. Also determines the default country when the Country Code input is unset (e.g. google.de -> de). Domains of countries where Google Jobs is unavailable stop the run with a clear message and no page fee.", "default": "google.com" }, "posted_within": { "title": "Posted Within", "enum": [ "any", "24h", "3d", "7d", "30d" ], "type": "string", "description": "Only return jobs posted within this window. Great for daily scheduled runs: set 'Last 24 hours' to avoid re-collecting listings you already scraped. Default 'Any time' applies no date filter (existing runs and tasks are unaffected).", "default": "any" }, "num_results": { "title": "Number of Results", "minimum": 10, "maximum": 1000, "type": "integer", "description": "Maximum number of job results to return", "default": 100 }, "max_pagination": { "title": "Maximum Pages", "minimum": 0, "maximum": 100, "type": "integer", "description": "Maximum number of pages to fetch (each page has ~10 results). Set to 0 for unlimited pagination (fetch all available pages).", "default": 0 }, "include_lrad": { "title": "Include Location Radius", "type": "boolean", "description": "Whether to include location radius filtering", "default": false }, "lrad_value": { "title": "Location Radius Value", "pattern": "^[0-9]+$", "type": "string", "description": "Location radius value in km (e.g., '2', '5', '10'). Only used when include_lrad is true." }, "max_delay": { "title": "Request Delay", "minimum": 0, "maximum": 10, "type": "integer", "description": "Delay between API requests in seconds (to avoid rate limiting)", "default": 1 }, "output_file": { "title": "Output Filename", "type": "string", "description": "Custom filename for saving results. Leave empty for auto-generated filename." } } }, "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 } } } } } } } } } }