{ "openapi": "3.0.1", "info": { "title": "Hiring.Cafe Jobs Scraper", "description": "Export public Hiring.Cafe job listings, companies, apply links, salaries, workplace fields, and requirements.", "version": "0.1", "x-build-id": "haTwORJcd8LKi6Avb" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/fetch_cat~hiring-cafe-jobs-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-fetch_cat-hiring-cafe-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/fetch_cat~hiring-cafe-jobs-scraper/runs": { "post": { "operationId": "runs-sync-fetch_cat-hiring-cafe-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/fetch_cat~hiring-cafe-jobs-scraper/run-sync": { "post": { "operationId": "run-sync-fetch_cat-hiring-cafe-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", "required": [ "maxItems" ], "properties": { "startUrls": { "title": "Hiring.Cafe URLs", "type": "array", "description": "Optional Hiring.Cafe search or /job/... URLs. Use search URLs for lists and job URLs for specific postings.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "query": { "title": "Keyword query", "type": "string", "description": "Keep jobs whose title, company, category, or requirements mention this text. Leave empty for broad, stable homepage exports." }, "location": { "title": "Location filter", "type": "string", "description": "Keep jobs whose location contains this city, state, or country text. Leave empty when you need a non-empty smoke test." }, "country": { "title": "Country code", "type": "string", "description": "Optional ISO country code filter, for example DE or US. Leave empty unless you need to enforce a country." }, "remoteOnly": { "title": "Remote only", "type": "boolean", "description": "Use Hiring.Cafe's Remote search filter and only export jobs marked Remote. Hybrid jobs are excluded.", "default": false }, "maxItems": { "title": "Maximum jobs", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Maximum number of job records to export.", "default": 20 }, "fetchDetails": { "title": "Fetch full descriptions", "type": "boolean", "description": "Try existing public employer routes first, then request full descriptions within the run cost budget. Jobs beyond that budget retain search-level data with skipped_cost_budget status and a warning; full descriptions are not guaranteed.", "default": true }, "maxPages": { "title": "Maximum search pages", "minimum": 1, "maximum": 100, "type": "integer", "description": "Safety cap for paginated discovery. Increase only when narrow local filters need more source pages.", "default": 20 }, "runBudgetSeconds": { "title": "Run work budget", "minimum": 60, "maximum": 270, "type": "integer", "description": "Maximum active work time before the Actor saves a resumable checkpoint and reserves time for cleanup.", "default": 240 }, "resumeFromCheckpoint": { "title": "Resume interrupted work", "type": "boolean", "description": "Resume idempotently from RUN_CHECKPOINT when the same run is resurrected after migration or timeout pressure.", "default": true }, "connectionMode": { "title": "Connection mode", "enum": [ "automatic", "direct" ], "type": "string", "description": "Automatic tries direct access first and can use a paid proxy if Hiring.Cafe blocks the request. Direct turns off paid proxy fallback, so some requests may fail. Normal run charges still apply in either mode. Saved proxy settings take precedence: a custom pool is tried before bounded Automatic fallback for search pages; optional descriptions retain their existing connections; saved Direct-only settings without a custom pool remain Direct-only." } } }, "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 } } } } } } } } } }