{ "openapi": "3.0.1", "info": { "title": "Hiring.Cafe Jobs Scraper - Search 2.8M ATS Jobs", "description": "Search Hiring.Cafe by keyword, location, remote, seniority, salary and date. Get title, company, salary, skills, description and apply link for each job. Export to CSV, Excel, JSON or XML.", "version": "0.1", "x-build-id": "Z7qIncO5hapeiF29x" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/parseforge~hiring-cafe-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-parseforge-hiring-cafe-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~hiring-cafe-scraper/runs": { "post": { "operationId": "runs-sync-parseforge-hiring-cafe-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~hiring-cafe-scraper/run-sync": { "post": { "operationId": "run-sync-parseforge-hiring-cafe-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", "type": "array", "description": "Job titles or keywords, one search per line (for example data engineer or registered nurse). Leave empty to browse every job that matches the filters below.", "items": { "type": "string" } }, "startUrls": { "title": "Hiring.Cafe search URLs", "type": "array", "description": "Optional. Paste a hiring.cafe search page (the address contains ?searchState=...) and the Actor reads exactly that search, filters included. Single job pages are not supported.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "maxItems": { "title": "Max Items", "minimum": 1, "maximum": 1000000, "type": "integer", "description": "Free users: Limited to 10 items (preview). Paid users: Optional, max 1,000,000" }, "maxItemsPerSearch": { "title": "Max items per search", "minimum": 1, "maximum": 1000000, "type": "integer", "description": "Optional cap for each keyword or URL, so one broad search cannot use the whole Max Items budget. Empty means no per-search cap." }, "locations": { "title": "Locations", "type": "array", "description": "Where the job is. Use City, Country (Berlin, Germany), a state (Texas), a country (United States), a continent (Europe) or a ZIP code (94107). A two-letter country code such as US also works. Empty searches the whole world.", "items": { "type": "string" } }, "radiusMiles": { "title": "Search radius (miles)", "minimum": 1, "maximum": 500, "type": "integer", "description": "For a city or ZIP code: how far around it to look. The website default is 50.", "default": 50 }, "exactLocationOnly": { "title": "Exact city only", "type": "boolean", "description": "For a city or ZIP code: only jobs in that exact place, ignoring the radius.", "default": false }, "includeRemoteFromWiderRegions": { "title": "Include remote jobs open to the region", "type": "boolean", "description": "Like the website: a search for a state, country or continent also returns remote jobs that accept candidates from anywhere inside a wider region (for example a remote job open to all of North America when you search Texas).", "default": true }, "workplaceTypes": { "title": "Workplace types", "type": "array", "description": "Only these kinds of workplace.", "items": { "type": "string", "enum": [ "Remote", "Hybrid", "Onsite", "Field" ], "enumTitles": [ "Remote", "Hybrid", "On-site", "Field work" ] } }, "commitmentTypes": { "title": "Employment types", "type": "array", "description": "Only these kinds of commitment.", "items": { "type": "string", "enum": [ "Full Time", "Part Time", "Contract", "Internship", "Temporary", "Seasonal", "Volunteer" ], "enumTitles": [ "Full time", "Part time", "Contract", "Internship", "Temporary", "Seasonal", "Volunteer" ] } }, "seniorityLevels": { "title": "Seniority", "type": "array", "description": "Only these seniority levels.", "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" ] } }, "roleTypes": { "title": "Role type", "type": "array", "description": "Individual contributor or people manager.", "items": { "type": "string", "enum": [ "Individual Contributor", "People Manager" ], "enumTitles": [ "Individual contributor", "People manager" ] } }, "postedWithinDays": { "title": "Posted within (days)", "minimum": 1, "maximum": 365, "type": "integer", "description": "Only jobs published in the last N days (counted back from today, UTC). Empty uses the website default window of 3 months." }, "postedFrom": { "title": "Posted from", "type": "string", "description": "Only jobs published on or after this date, YYYY-MM-DD. Overrides Posted within. Reaches back beyond 3 months." }, "postedTo": { "title": "Posted until", "type": "string", "description": "Only jobs published on or before this date, YYYY-MM-DD." }, "sortBy": { "title": "Sort by", "enum": [ "default", "date", "compensation_desc", "compensation_asc", "experience_asc", "experience_desc" ], "type": "string", "description": "Order of the results.", "default": "default" }, "jobTitleQuery": { "title": "Job title contains", "type": "string", "description": "Match this text in the job title only. Supports AND / OR / NOT." }, "jobDescriptionQuery": { "title": "Description contains", "type": "string", "description": "Match this text in the job description. Supports AND / OR / NOT (kubernetes AND terraform)." }, "technologyKeywordsQuery": { "title": "Technologies", "type": "string", "description": "Match the tools and technologies extracted from the posting (python OR go)." }, "requirementsKeywordsQuery": { "title": "Requirements contain", "type": "string", "description": "Match the requirements extracted from the posting (CPA, clearance)." }, "minYearsExperience": { "title": "Min years of experience", "minimum": 0, "maximum": 20, "type": "integer", "description": "Only jobs that state a minimum experience of at least this many years. Jobs that state none are left out." }, "maxYearsExperience": { "title": "Max years of experience", "minimum": 0, "maximum": 20, "type": "integer", "description": "Only jobs that state a minimum experience of at most this many years. Jobs that state none are left out." }, "securityClearances": { "title": "Security clearance", "type": "array", "description": "Only jobs asking for one of these clearances.", "items": { "type": "string", "enum": [ "None", "Confidential", "Secret", "Top Secret", "Top Secret/SCI", "Public Trust", "Interim Clearances", "Other" ], "enumTitles": [ "None", "Confidential", "Secret", "Top Secret", "Top Secret/SCI", "Public Trust", "Interim Clearances", "Other" ] } }, "minSalary": { "title": "Minimum salary", "minimum": 1, "type": "integer", "description": "Only jobs whose salary range reaches at least this amount, in the interval and currency below." }, "maxSalary": { "title": "Maximum salary", "minimum": 1, "type": "integer", "description": "Only jobs whose salary range starts at or below this amount, in the interval and currency below." }, "salaryInterval": { "title": "Salary interval", "enum": [ "Yearly", "Monthly", "Weekly", "Daily", "Hourly" ], "type": "string", "description": "The pay period the two amounts above are in.", "default": "Yearly" }, "salaryCurrency": { "title": "Salary currency", "type": "string", "description": "Currency code of the amounts, for example USD, EUR or GBP. Empty keeps every currency." }, "onlyTransparentSalaries": { "title": "Only jobs with a printed salary", "type": "boolean", "description": "Leave out every job that does not show a salary.", "default": false }, "companyNames": { "title": "Only these companies", "type": "array", "description": "Company names as Hiring.Cafe writes them. Subsidiaries are included.", "items": { "type": "string" } }, "excludedCompanyNames": { "title": "Exclude companies", "type": "array", "description": "Leave out jobs from these companies.", "items": { "type": "string" } }, "industries": { "title": "Only these industries", "type": "array", "description": "Industry names as Hiring.Cafe lists them, for example Healthcare, Software & SaaS, Banking.", "items": { "type": "string" } }, "excludedIndustries": { "title": "Exclude industries", "type": "array", "description": "Leave out jobs at companies in these industries.", "items": { "type": "string" } }, "companyKeywords": { "title": "Company profile keywords", "type": "array", "description": "Only employers whose name or profile contains one of these words (bank, clinic, robotics).", "items": { "type": "string" } }, "companyHqCountries": { "title": "Company HQ countries", "type": "array", "description": "Two-letter codes of the country where the employer is headquartered (US, DE, GB).", "items": { "type": "string" } }, "organizationTypes": { "title": "Company type", "type": "array", "description": "Only employers of these types.", "items": { "type": "string", "enum": [ "private", "public", "non-profit", "government", "cooperative / mutual" ], "enumTitles": [ "Private", "Public", "Non-profit", "Government", "Cooperative / mutual" ] } }, "includeDescription": { "title": "Include full descriptions", "type": "boolean", "description": "Fetch the full job description (HTML and plain text) for every job. Turn off for a faster run that returns the structured fields only.", "default": true }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Apify proxy settings.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } } }, "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 } } } } } } } } } }