{ "openapi": "3.0.1", "info": { "title": "ZipRecruiter IE Jobs Scraper", "description": "Collect ZipRecruiter Ireland job listings in minutes with structured job data for recruiting, hiring research, and labor market analysis. Start from ready made search URLs or flexible filters, then export job details, apply links, coordinates, benefits, requirements, and useful metadata", "version": "1.0", "x-build-id": "wkFxoOPJiYKwZpBRL" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/parseforge~ziprecruiter-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-parseforge-ziprecruiter-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/parseforge~ziprecruiter-scraper/runs": { "post": { "operationId": "runs-sync-parseforge-ziprecruiter-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/parseforge~ziprecruiter-scraper/run-sync": { "post": { "operationId": "run-sync-parseforge-ziprecruiter-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": { "startUrls": { "title": "Start URLs", "type": "array", "description": "Paste one or more ZipRecruiter Ireland search URLs when you want to scrape exactly the filtered results already visible on the site.", "items": { "type": "object", "properties": { "url": { "title": "URL", "type": "string", "description": "Paste a ZipRecruiter Ireland search URL such as a keyword search, a location-based search, or a page with filters already applied." } } } }, "maxItems": { "title": "Max Items", "minimum": 1, "maximum": 1000000, "type": "integer", "description": "Set the maximum total jobs to collect across the whole run." }, "maxItemsPerStartUrl": { "title": "Max Items Per Start URL", "minimum": 1, "maximum": 1000000, "type": "integer", "description": "Set a separate cap for each URL inside startUrls while still respecting Max Items as the overall run limit." }, "query": { "title": "Query", "type": "string", "description": "Enter the job keyword to search for on ZipRecruiter Ireland, such as backend, python, nurse, or sales." }, "location": { "title": "Location", "type": "string", "description": "Limit results to a city, county, or region such as Dublin, Ireland or Cork, Ireland." }, "latitude": { "title": "Latitude", "type": "number", "description": "Optional latitude value used together with location-based ZipRecruiter Ireland searches." }, "longitude": { "title": "Longitude", "type": "number", "description": "Optional longitude value used together with location-based ZipRecruiter Ireland searches." }, "distance": { "title": "Distance", "minimum": 0, "maximum": 9999, "type": "integer", "description": "Choose the search radius in kilometres when ZipRecruiter Ireland uses distance-based location search." }, "workplace": { "title": "Workplace Filter", "enum": [ "on_site" ], "type": "string", "description": "Use the public workplace filter available on ZipRecruiter Ireland search results." }, "sortBy": { "title": "Sort By", "enum": [ "best_match", "published_at" ], "type": "string", "description": "Choose whether results should stay on best match or switch to newest jobs first." }, "includeDetails": { "title": "Include Details", "type": "boolean", "description": "Turn this on to open each job and collect JSON-LD, apply data, description, requirements, benefits, reference IDs, coordinates, and metadata." }, "externalApplyOnly": { "title": "External Apply Only", "type": "boolean", "description": "Turn this on to keep only jobs that send candidates to an external apply flow instead of a direct platform flow." }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Residential proxies are strongly recommended for ZipRecruiter Ireland because direct requests can trigger Cloudflare challenges." } } }, "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 } } } } } } } } } }