{ "openapi": "3.0.1", "info": { "title": "Hiring.Cafe Jobs Scraper", "description": "Scrape hiring.cafe job listings into structured records โ€” title, company, salary, seniority, workplace type, requirements, benefits and enriched company data โ€” with keyword/location/URL search, incremental monitoring and notifications.", "version": "0.1", "x-build-id": "97kLEsi98Xm399KuI" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/corvuslab~hiringcafe-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-corvuslab-hiringcafe-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/corvuslab~hiringcafe-scraper/runs": { "post": { "operationId": "runs-sync-corvuslab-hiringcafe-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/corvuslab~hiringcafe-scraper/run-sync": { "post": { "operationId": "run-sync-corvuslab-hiringcafe-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": { "query": { "title": "๐Ÿ”‘ Search keywords", "type": "string", "description": "Job title or keyword, e.g. \"registered nurse\" or \"python developer\". Separate multiple searches with commas โ€” each runs as its own search and results are merged and de-duplicated." }, "location": { "title": "๐Ÿ“ Location", "type": "string", "description": "City, region or country to search near, e.g. \"London\", \"New York\", \"Germany\". Resolved to the site's nearest match. Leave empty for a location-agnostic search (great with Remote)." }, "startUrls": { "title": "๐Ÿ“‹ Start URLs", "type": "array", "description": "Paste hiring.cafe search URLs (the ones with all your filters applied, e.g. https://hiringcafe.com/?searchState=...) or company pages. Every filter in the URL is preserved.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "maxResults": { "title": "๐Ÿ”ข Max results", "minimum": 0, "type": "integer", "description": "Maximum number of jobs to return. Set 0 for unlimited (bounded by how many the search has).", "default": 25 }, "ignoreUrlFailures": { "title": "โญ๏ธ Ignore URL failures", "type": "boolean", "description": "Skip start URLs that cannot be interpreted instead of failing the whole run.", "default": true }, "workplaceTypes": { "title": "๐Ÿข Workplace type", "type": "array", "description": "Remote, hybrid, onsite or field-based roles.", "items": { "type": "string", "enum": [ "Remote", "Hybrid", "Onsite", "Field" ], "enumTitles": [ "๐Ÿ  Remote", "๐Ÿ”€ Hybrid", "๐Ÿข Onsite", "๐Ÿšš Field" ] } }, "commitmentTypes": { "title": "โฑ๏ธ Commitment", "type": "array", "description": "Employment type.", "items": { "type": "string", "enum": [ "Full Time", "Part Time", "Contract", "Internship", "Temporary", "Seasonal", "Volunteer" ], "enumTitles": [ "Full Time", "Part Time", "Contract", "Internship", "Temporary", "Seasonal", "Volunteer" ] } }, "seniorityLevel": { "title": "๐Ÿงญ Seniority", "type": "array", "description": "Experience level required.", "items": { "type": "string", "enum": [ "No Prior Experience Required", "Entry Level", "Mid Level", "Senior Level" ], "enumTitles": [ "No Prior Experience Required", "Entry Level", "Mid Level", "Senior Level" ] } }, "companyKeywords": { "title": "๐Ÿญ Company", "type": "string", "description": "Restrict to companies matching these keywords (comma-separated), e.g. \"Siemens\", \"Google\"." }, "dateFetchedPastNDays": { "title": "๐Ÿ“… Posted within (days)", "minimum": 0, "type": "integer", "description": "Only jobs added in the last N days. Leave empty (or 0) for any time." }, "sortBy": { "title": "โ†•๏ธ Sort by", "enum": [ "relevance", "date", "compensation_desc", "compensation_asc", "experience_desc" ], "type": "string", "description": "Result ordering.", "default": "relevance" }, "searchStateOverrides": { "title": "๐Ÿ› ๏ธ Advanced search state (JSON)", "type": "object", "description": "Power users: extra raw search-state keys merged on top of the filters above (e.g. salary bounds, industries, benefits). Leave empty unless you know the field names." }, "includeDetails": { "title": "๐Ÿ”ฌ Fetch full description", "type": "boolean", "description": "Fetch each job's full description and extract contacts. Turn off for the fastest, cheapest runs (the structured fields still come through).", "default": true }, "descriptionFormat": { "title": "๐Ÿ“ Description format", "enum": [ "all", "text", "html", "markdown" ], "type": "string", "description": "Which representation(s) of the job description to include.", "default": "all" }, "descriptionMaxLength": { "title": "โœ‚๏ธ Description max length", "minimum": 0, "type": "integer", "description": "Truncate each description to this many characters. Leave empty for the full text." }, "compact": { "title": "๐Ÿ“ฆ Compact records", "type": "boolean", "description": "Emit only the core fields (title, company, location, salary, apply URL, โ€ฆ). Ideal for AI agents and MCP clients.", "default": false }, "excludeEmptyFields": { "title": "๐Ÿงน Drop empty fields", "type": "boolean", "description": "Remove null, empty-string and empty-array fields from each record.", "default": false }, "incrementalMode": { "title": "โ™ป๏ธ Incremental mode", "type": "boolean", "description": "Track state between runs and tag every job with a changeType (NEW / UPDATED / UNCHANGED / EXPIRED), with repost detection.", "default": false }, "stateKey": { "title": "๐Ÿ—๏ธ State key", "type": "string", "description": "Stable name for the tracked search. Leave empty to derive one automatically from your search settings." }, "emitUnchanged": { "title": "๐Ÿ” Include unchanged jobs", "type": "boolean", "description": "Also emit jobs that have not changed since the previous run.", "default": false }, "emitExpired": { "title": "๐Ÿ—‘๏ธ Include expired jobs", "type": "boolean", "description": "Emit jobs that were present last run but are gone now.", "default": false }, "telegramToken": { "title": "๐Ÿ’ฌ Telegram bot token", "type": "string", "description": "Bot token from @BotFather." }, "telegramChatId": { "title": "๐Ÿ†” Telegram chat ID", "type": "string", "description": "Chat or channel ID, e.g. \"-100123456789\" or \"@yourchannel\"." }, "slackWebhookUrl": { "title": "๐Ÿ’ผ Slack webhook URL", "type": "string", "description": "Slack incoming-webhook URL." }, "discordWebhookUrl": { "title": "๐ŸŽฎ Discord webhook URL", "type": "string", "description": "Discord incoming-webhook URL." }, "webhookUrl": { "title": "๐Ÿช Webhook URL", "type": "string", "description": "Any HTTPS endpoint. Receives a JSON POST with the matched jobs โ€” works with n8n, Make and Zapier." }, "webhookHeaders": { "title": "๐Ÿงพ Webhook headers", "type": "object", "description": "Extra headers for the webhook request, e.g. {\"Authorization\": \"Bearer xyz\"}." }, "notificationLimit": { "title": "๐Ÿ”ข Jobs per notification", "minimum": 1, "maximum": 20, "type": "integer", "description": "How many jobs to include in each notification message.", "default": 5 }, "proxyConfiguration": { "title": "๐ŸŒ Proxy configuration", "type": "object", "description": "Optional. Runs start over a direct connection and switch to Apify Proxy automatically if the site refuses it, so you normally leave this off. Set it only to pick specific proxy groups or to spread very high volume across IPs.", "default": { "useApifyProxy": false } }, "detailConcurrency": { "title": "โšก Detail concurrency", "minimum": 1, "maximum": 16, "type": "integer", "description": "How many full descriptions to fetch in parallel.", "default": 8 }, "maxRequestRetries": { "title": "๐Ÿ”„ Max request retries", "minimum": 0, "maximum": 10, "type": "integer", "description": "How many times to retry a failed request before giving up on it.", "default": 3 } } }, "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 } } } } } } } } } }