{ "openapi": "3.0.1", "info": { "title": "ZipRecruiter Jobs & Salary Scraper", "description": "Scrape ZipRecruiter job listings by keyword and location, or from any search URL. Get job title, company, location, salary, employment type, posting date and the full job description. Every detail page is opened, and incomplete rows are flagged instead of silently returned empty.", "version": "1.0", "x-build-id": "SHqNgtkBOFKIqJDPd" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/rainminer~ziprecruiter-jobs-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-rainminer-ziprecruiter-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/rainminer~ziprecruiter-jobs-scraper/runs": { "post": { "operationId": "runs-sync-rainminer-ziprecruiter-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/rainminer~ziprecruiter-jobs-scraper/run-sync": { "post": { "operationId": "run-sync-rainminer-ziprecruiter-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": { "startUrls": { "title": "Start URLs", "type": "array", "description": "ZipRecruiter search-result URLs. Any filters already present in each URL are preserved. When provided, search and location are ignored.", "items": { "type": "string" } }, "search": { "title": "Search keyword", "type": "string", "description": "Job keyword, title, skill, or company. Combined with location when startUrls is empty." }, "location": { "title": "Location", "type": "string", "description": "City, state, or ZIP code to combine with search. Ignored when startUrls is provided." }, "jobType": { "title": "Job type", "enum": [ "any", "full_time", "part_time", "contract", "internship", "temporary" ], "type": "string", "description": "Employment type filter. Only applied when search is used to build the URL.", "default": "any" }, "daysPosted": { "title": "Posted within (days)", "minimum": 0, "maximum": 30, "type": "integer", "description": "Only include jobs posted within the last N days. 0 means any date. Only applied when search is used.", "default": 0 }, "radiusMiles": { "title": "Search radius (miles)", "minimum": 0, "maximum": 100, "type": "integer", "description": "Geographic radius around location. 0 uses ZipRecruiter's default. Only applied when search is used.", "default": 0 }, "remoteOnly": { "title": "Remote only", "type": "boolean", "description": "Restrict results to remote-eligible positions. Only applied when search is used.", "default": false }, "maxItems": { "title": "Maximum items", "minimum": 1, "maximum": 500, "type": "integer", "description": "Maximum number of jobs to return per start URL. Pagination stops automatically once this limit is reached.", "default": 50 }, "fetchFullDescription": { "title": "Fetch full job descriptions", "type": "boolean", "description": "Open each job's detail page to extract the complete description. Turn off for a faster, list-only run (descriptions may be truncated or missing).", "default": true }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "ZipRecruiter is protected by Cloudflare, so US residential proxies are required for reliable results.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "US" } } } }, "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 } } } } } } } } } }