{ "openapi": "3.0.1", "info": { "title": "Adzuna Jobs Scraper", "description": "[💰 $0.55 / 1K] Extract job listings from Adzuna across 19 countries. Search by keyword, location, salary, contract type, and distance to get structured data including titles, companies, salaries, descriptions, categories, and direct apply links.", "version": "1.0", "x-build-id": "tbDkjOGlWxJY2DXLz" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/solidcode~adzuna-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-solidcode-adzuna-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/solidcode~adzuna-scraper/runs": { "post": { "operationId": "runs-sync-solidcode-adzuna-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/solidcode~adzuna-scraper/run-sync": { "post": { "operationId": "run-sync-solidcode-adzuna-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": { "searchQueries": { "title": "Search Keywords", "maxItems": 50, "type": "array", "description": "Job titles or keywords to search for, such as 'software engineer' or 'data scientist'. Each keyword runs a separate search and the results are merged and de-duplicated. Leave empty if you only want to use the direct search URLs below.", "items": { "type": "string" } }, "country": { "title": "Country", "enum": [ "us", "gb", "au", "de", "fr", "in", "ca", "nz", "za", "pl", "nl", "it", "es", "at", "be", "br", "mx", "sg", "ch" ], "type": "string", "description": "Which Adzuna country to search. Salaries are shown in that country's local currency.", "default": "us" }, "location": { "title": "Location", "type": "string", "description": "Where to search within the chosen country. Enter a city or region, such as 'London' or 'New York'. Leave empty to search the whole country." }, "startUrls": { "title": "Direct Adzuna Search URLs", "maxItems": 50, "type": "array", "description": "Paste full Adzuna search-result URLs (for example https://www.adzuna.com/search?q=software+engineer) to scrape them exactly as-is. Useful when you have already dialed in a search on the Adzuna website. Up to 50 URLs per run.", "items": { "type": "string" } }, "maxResults": { "title": "Max Results per Keyword", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Maximum number of jobs to collect for each search keyword. Use a small number for a quick scan or a higher number for deep research. The last page is always kept in full, so the final count can slightly overshoot this number.", "default": 100 }, "salaryMin": { "title": "Minimum Salary", "minimum": 0, "type": "integer", "description": "Only show jobs paying at least this amount per year, in the chosen country's local currency. Leave empty for any salary." }, "salaryMax": { "title": "Maximum Salary", "minimum": 0, "type": "integer", "description": "Only show jobs paying at most this amount per year, in the chosen country's local currency. Leave empty for any salary." }, "contractTime": { "title": "Hours", "enum": [ "", "full_time", "part_time" ], "type": "string", "description": "Filter by working hours. Leave on 'Any' for both.", "default": "" }, "contractType": { "title": "Contract", "enum": [ "", "permanent", "contract" ], "type": "string", "description": "Filter by contract arrangement. Leave on 'Any' for both.", "default": "" }, "distance": { "title": "Search Radius (miles)", "minimum": 1, "maximum": 500, "type": "integer", "description": "How far from the location to search, in miles. Ignored when the location is empty. Leave empty for the default radius." }, "maxDaysOld": { "title": "Posted Within", "enum": [ "", "1", "3", "7", "14", "30" ], "type": "string", "description": "Only show jobs posted within this time period.", "default": "" }, "sortBy": { "title": "Sort By", "enum": [ "relevance", "date", "salary" ], "type": "string", "description": "Order in which jobs are returned.", "default": "relevance" }, "fetchDescription": { "title": "Fetch Full Job Descriptions", "type": "boolean", "description": "Fetch the full job description from each listing's detail page. Leave on for the most complete data. Turn off to make runs faster — the description field will then contain only the short search-result snippet.", "default": true } } }, "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 } } } } } } } } } }