{
"openapi": "3.0.1",
"info": {
"title": "Google Jobs Scraper | Jobs by City, Apply Links, Full Coverage",
"description": "Scrape Google Jobs without a browser or SerpApi: the jobs of the city you ask (not the proxy's), salary, every apply link and the full description. Complete coverage goes past Google's 10 per request; duplicates and jobs outside your filters are never charged. New-jobs-only mode and webhook.",
"version": "0.1",
"x-build-id": "8UzCmi3R4xgbQePic"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/alexmorain~google-jobs-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-alexmorain-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/alexmorain~google-jobs-scraper/runs": {
"post": {
"operationId": "runs-sync-alexmorain-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/alexmorain~google-jobs-scraper/run-sync": {
"post": {
"operationId": "run-sync-alexmorain-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 titles or keywords",
"type": "array",
"description": "One search per line, as you would type it in Google: software engineer, registered nurse, warehouse operative. Each line is searched in each location. The words jobs in and the location are added for you.",
"items": {
"type": "string"
}
},
"locations": {
"title": "Locations",
"type": "array",
"description": "Cities or regions, one per line: Austin, TX, Manchester, Berlin. Always fill this in. The location is written into the Google query. Without it Google uses the IP address of the proxy and two identical runs return different jobs.",
"items": {
"type": "string"
}
},
"country": {
"title": "Country",
"enum": [
"us",
"gb",
"ca",
"au",
"ie",
"nz",
"in",
"sg",
"za",
"ae",
"de",
"at",
"ch",
"fr",
"be",
"es",
"mx",
"it",
"nl",
"pt",
"br",
"pl",
"se"
],
"type": "string",
"description": "Which Google to ask: it sets the domain (google.com, google.co.uk, google.de...) and the country of the results. Match it with your location.",
"default": "us"
},
"language": {
"title": "Language",
"type": "string",
"description": "Interface language of Google, a two-letter code such as en, de, fr. Empty uses the main language of the country. The date and job type filters were checked in English, German and French; in other languages they are applied to what each job shows."
},
"datePosted": {
"title": "Posted within",
"enum": [
"any",
"today",
"3days",
"week",
"month"
],
"type": "string",
"description": "Only jobs posted in this window. Google gets the filter as part of the search, then every job's age is checked again before you pay: a job older than the window is dropped, not charged. Today means up to 24 hours old.",
"default": "any"
},
"employmentTypes": {
"title": "Job types",
"type": "array",
"description": "Keep only these types. Google's own filter only leans towards a type (a search for internships returns full-time jobs too), so the type shown on each job is checked and a job showing another type is dropped, not charged. A job that shows no type is kept. Empty keeps all.",
"items": {
"type": "string",
"enum": [
"fulltime",
"parttime",
"contractor",
"internship"
],
"enumTitles": [
"Full-time",
"Part-time",
"Contractor",
"Internship"
]
}
},
"remoteOnly": {
"title": "Remote only",
"type": "boolean",
"description": "Keep only jobs Google marks as Work from home. Jobs without that mark are dropped, not charged.",
"default": false
},
"completeCoverage": {
"title": "Complete coverage",
"type": "boolean",
"description": "On: ask Google many variations of each search (dates, job types, seniority, then the companies and titles it finds) until nothing new comes back, up to Max requests per search. Off: one request, the 10 jobs Google ranks first.",
"default": true
},
"startUrls": {
"title": "Google Jobs URLs",
"type": "array",
"description": "Optional. Google Jobs search URLs, such as https://www.google.com/search?q=nurse+jobs+in+leeds&udm=8 (or ibp=htl;jobs). The query, hl and gl are read from the URL. Put the place in the query.",
"items": {
"type": "string"
}
},
"maxItems": {
"title": "Max jobs",
"minimum": 1,
"type": "integer",
"description": "Total jobs returned by the run, across all searches.",
"default": 100
},
"maxRequestsPerSearch": {
"title": "Max requests per search",
"minimum": 1,
"maximum": 1000,
"type": "integer",
"description": "Budget of Google requests for each search (each returns up to 10 jobs). The Actor stops earlier when new requests stop finding new jobs.",
"default": 60
},
"maxConcurrency": {
"title": "Parallel requests",
"minimum": 1,
"maximum": 16,
"type": "integer",
"description": "Google requests in flight at once, 1 to 16.",
"default": 10
},
"newOnly": {
"title": "New jobs only",
"type": "boolean",
"description": "Remembers the jobs returned by earlier runs and returns only jobs not delivered before. The first run returns everything that matches. Schedule it daily with Posted within: Past 24 hours for a feed of fresh jobs that never repeats.",
"default": false
},
"monitorName": {
"title": "Monitor name (New jobs only)",
"type": "string",
"description": "Without a name, the memory of delivered jobs belongs to this exact set of searches. With a name, every run using that name shares it, even if you change the searches."
},
"webhookUrl": {
"title": "Webhook URL",
"type": "string",
"description": "If set, the Actor POSTs a small JSON summary to this URL at the end of the run, only when at least one job was returned: actor, runId, datasetId, offers, newOnly and one line per search. Use the final URL: a redirect is not followed, except a 307 or 308. An unreachable webhook is logged and never fails the run. Stored encrypted."
}
}
},
"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
}
}
}
}
}
}
}
}
}
}