{ "openapi": "3.0.1", "info": { "title": "Google Jobs Scraper: Job Listings, Salaries & Apply Links", "description": "Scrape Google Jobs: job listings from LinkedIn, Indeed, ZipRecruiter, Monster and company sites in one search, with salary ranges as numbers, employment type, qualifications, full description and every apply link. Filters by date and type, daily alerts with only new jobs. Pay per job.", "version": "1.0", "x-build-id": "kFLbqtshQnLlrQQBC" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/fguiraud~google-jobs-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-fguiraud-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/fguiraud~google-jobs-scraper/runs": { "post": { "operationId": "runs-sync-fguiraud-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/fguiraud~google-jobs-scraper/run-sync": { "post": { "operationId": "run-sync-fguiraud-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": { "queries": { "title": "Job searches", "type": "array", "description": "What to search, one per line: a job title, skill or company ('python developer', 'registered nurse', 'data analyst at Google'). Add the place here or in 'Location'.", "items": { "type": "string" } }, "location": { "title": "Location", "type": "string", "description": "City, region or country added to every search, e.g. 'New York', 'London', 'Mexico City'. Empty = Google uses the country below." }, "maxJobsPerQuery": { "title": "Max jobs per search", "minimum": 1, "maximum": 50, "type": "integer", "description": "Google shows 10 jobs per search. Above 10, related searches (contract type, seniority, remote) are added and duplicates removed, up to about 50 jobs per search.", "default": 20 }, "maxDaysOld": { "title": "Posted within (days)", "minimum": 1, "maximum": 365, "type": "integer", "description": "Only jobs posted in the last N days (1 = today, 7 = last week). Jobs without a date are kept. Filtered jobs are not charged." }, "employmentTypes": { "title": "Employment types", "type": "array", "description": "Only these types. Empty = all. Filtered jobs are not charged.", "items": { "type": "string", "enum": [ "full-time", "part-time", "contractor", "internship", "temporary", "per diem", "volunteer" ], "enumTitles": [ "Full-time", "Part-time", "Contractor", "Internship", "Temporary", "Per diem", "Volunteer" ] } }, "remoteOnly": { "title": "Remote jobs", "type": "boolean", "description": "Add 'remote' to every search so Google returns work-from-home jobs.", "default": false }, "includeDescription": { "title": "Include full description", "type": "boolean", "description": "Turn off for smaller results (title, company, salary, highlights and apply links are always included).", "default": true }, "onlyNewJobs": { "title": "Only new jobs", "type": "boolean", "description": "For scheduled runs: remember the jobs already returned for each search (in a key-value store named 'google-jobs-monitor' in your account) and return only new ones. Ideal for daily job alerts.", "default": false }, "language": { "title": "Language", "type": "string", "description": "Google interface language (en, es, de, fr, pt...).", "default": "en" }, "country": { "title": "Country (Google edition)", "type": "string", "description": "2-letter country code of the Google edition: us, gb, ca, in, mx, es, de... Jobs come mostly from this country unless 'Location' says otherwise.", "default": "us" }, "maxConcurrency": { "title": "Searches in parallel", "minimum": 1, "maximum": 5, "type": "integer", "description": "How many searches run at the same time.", "default": 3 }, "failOnError": { "title": "Fail the run on errors", "type": "boolean", "description": "Mark the run as failed when an item fails or nothing is found. Useful for scheduled monitoring (Apify emails you on failed runs).", "default": false }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Google Jobs results are only rendered for Apify's Google SERP proxy, used by default (it is billed by Apify per page, included in the job price).", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "GOOGLE_SERP" ] } } } }, "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 } } } } } } } } } }