{ "openapi": "3.0.1", "info": { "title": "Google Jobs Scraper & Job Alerts ($2/1k): Salaries, Apply Links", "description": "Google Jobs scraper and job alerts API: 50–300 jobs per search with full description, parsed salary, posted date and every resolved apply link. Filter by date, hours, job type, remote, company, job board, salary and title words. Only-new mode for daily alerts. $2 per 1,000 jobs.", "version": "1.0", "x-build-id": "dVp4VQejU0VisBaJ5" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/automationnation~google-jobs-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-automationnation-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/automationnation~google-jobs-scraper/runs": { "post": { "operationId": "runs-sync-automationnation-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/automationnation~google-jobs-scraper/run-sync": { "post": { "operationId": "run-sync-automationnation-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", "type": "array", "description": "What to search for, one search per line, e.g. \"software engineer\", \"registered nurse\", \"marketing manager\". Each search runs separately and jobs found by several searches are returned once.", "items": { "type": "string" } }, "location": { "title": "Location", "type": "string", "description": "City, region or area to search in, e.g. \"New York\", \"London\", \"Austin, TX\". Leave empty to search the whole country selected below." }, "country": { "title": "Country", "enum": [ "us", "uk", "ca", "in", "sg", "za", "ae", "ph", "my", "ng", "pk", "hk", "gh", "qa", "sa", "eg", "de", "ch", "es", "mx", "ar", "co", "pe", "it", "br", "jp", "gb" ], "type": "string", "description": "Google country to search in. All listed countries were verified to return Google Jobs listings. Google Jobs is not offered in Australia, New Zealand, Austria, the Netherlands, Portugal and most of Europe. \"gb\" works as well as \"uk\".", "default": "us" }, "maxJobsPerQuery": { "title": "Max jobs per search", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Stop each search after this many jobs. Google usually lists 50–300 jobs per search; you are charged only for jobs returned.", "default": 50 }, "datePosted": { "title": "Date posted", "enum": [ "any", "today", "3days", "week", "month" ], "type": "string", "description": "Only jobs posted within this period.", "default": "any" }, "employmentType": { "title": "Employment type", "enum": [ "any", "fulltime", "parttime", "contractor", "internship" ], "type": "string", "description": "Only jobs of this type.", "default": "any" }, "remoteOnly": { "title": "Remote jobs only", "type": "boolean", "description": "Only remote / work-from-home jobs.", "default": false }, "companies": { "title": "Only these companies", "type": "array", "description": "Keep only jobs at these employers (part of the name is enough, e.g. \"Google\" also matches \"Google LLC\"). Tip: also put the company in your search, e.g. \"software engineer Stripe\", so Google lists more of its jobs.", "items": { "type": "string" } }, "excludeCompanies": { "title": "Exclude companies", "type": "array", "description": "Skip jobs at these employers, e.g. staffing agencies or your current employer. Part of the name is enough.", "items": { "type": "string" } }, "jobBoards": { "title": "Only these job boards", "type": "array", "description": "Keep only jobs listed on at least one of these sites, e.g. \"LinkedIn\", \"Indeed\", \"Glassdoor\", \"ZipRecruiter\", or an employer careers site like \"greenhouse\".", "items": { "type": "string" } }, "excludeJobBoards": { "title": "Exclude job boards", "type": "array", "description": "Skip jobs whose only apply options are on these sites, e.g. \"Indeed\". Jobs also listed elsewhere (such as the employer's own site) are kept.", "items": { "type": "string" } }, "salaryOnly": { "title": "Only jobs with a salary", "type": "boolean", "description": "Skip jobs that don't show pay.", "default": false }, "minYearlySalary": { "title": "Minimum yearly salary", "minimum": 0, "type": "integer", "description": "Skip jobs whose top of the pay range, converted to a yearly amount, is below this (in the local currency, e.g. 100000). Jobs without a salary are skipped when this is set." }, "postedWithinHours": { "title": "Posted within (hours)", "minimum": 1, "maximum": 2000, "type": "integer", "description": "Only jobs posted in the last N hours, e.g. 24 or 6. Stricter than \"Date posted\"; jobs with no posted date are skipped." }, "excludeTitleKeywords": { "title": "Exclude title keywords", "type": "array", "description": "Skip jobs whose title contains any of these words, e.g. \"senior\", \"intern\", \"sales\". Matches whole words, case-insensitive.", "items": { "type": "string" } }, "onlyNewJobs": { "title": "Only new jobs (for scheduled runs)", "type": "boolean", "description": "Return only jobs this Actor hasn't returned for the same search in your earlier runs (remembered for 120 days). Schedule the Actor daily to get a feed of new postings — you pay only for the new jobs.", "default": false }, "language": { "title": "Language", "type": "string", "description": "Optional Google interface language code, e.g. \"en\", \"pt\", \"es\". Leave empty to use the country's main language." }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Google blocks datacenter IPs, so residential proxies are used by default. Change only if you know you need to.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } } }, "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 } } } } } } } } } }