{ "openapi": "3.0.1", "info": { "title": "HiringCafe Jobs Scraper — Salaries, Company Data, Apply Links", "description": "Scrape HiringCafe jobs by keyword and location: salary, seniority, remote/hybrid, posting date, the employer's own apply link, views and applies, company headcount, funding and ticker, plus the full description. Filters for pay, experience and company size. No login.", "version": "0.1", "x-build-id": "MnWr55M4JuDr4rkIX" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/yugenox~hiringcafe-jobs-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-yugenox-hiringcafe-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/yugenox~hiringcafe-jobs-scraper/runs": { "post": { "operationId": "runs-sync-yugenox-hiringcafe-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/yugenox~hiringcafe-jobs-scraper/run-sync": { "post": { "operationId": "run-sync-yugenox-hiringcafe-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": { "searchQueries": { "title": "Job titles or keywords", "type": "array", "description": "What to search for, e.g. \"data analyst\", \"registered nurse\", \"backend engineer Go\". Each keyword is searched in every location below.", "items": { "type": "string" } }, "locations": { "title": "Locations", "type": "array", "description": "Cities, states/provinces or countries, e.g. \"Toronto, ON\", \"Austin, TX\", \"California\", \"United Kingdom\". Add the state or province to be precise (\"London, ON\" vs \"London\"). Use \"remote\" for remote jobs. Leave empty to search worldwide.", "items": { "type": "string" } }, "maxItems": { "title": "Max jobs per search", "minimum": 1, "maximum": 100000, "type": "integer", "description": "Maximum jobs to return for each keyword + location combination.", "default": 100 }, "includeDescription": { "title": "Include full job description", "type": "boolean", "description": "Adds the complete job description text to every job (slightly slower).", "default": true }, "startUrls": { "title": "HiringCafe URLs (optional)", "type": "array", "description": "Paste search URLs copied from hiringcafe.com (with all the filters you set on the site), or individual job links (hiringcafe.com/job/...).", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "workplaceTypes": { "title": "Workplace", "type": "array", "description": "Remote, hybrid and/or on-site. Leave empty for any.", "items": { "type": "string", "enum": [ "Remote", "Hybrid", "Onsite" ] } }, "employmentTypes": { "title": "Employment type", "type": "array", "description": "Leave empty for any.", "items": { "type": "string", "enum": [ "Full Time", "Part Time", "Contract", "Internship", "Temporary", "Seasonal", "Volunteer" ] } }, "seniorityLevels": { "title": "Seniority", "type": "array", "description": "Leave empty for any.", "items": { "type": "string", "enum": [ "No Prior Experience Required", "Entry Level", "Mid Level", "Senior Level" ] } }, "postedWithinDays": { "title": "Posted within", "enum": [ "1", "3", "7", "14", "30", "90", "180", "365", "any" ], "type": "string", "description": "Only jobs posted in this window.", "default": "90" }, "roleType": { "title": "Role type", "enum": [ "Individual Contributor", "People Manager" ], "type": "string", "description": "Individual contributor or people manager roles. Leave empty for both." }, "departments": { "title": "Department", "type": "array", "description": "Job function. Leave empty for any.", "items": { "type": "string", "enum": [ "Engineering", "Software Development", "Information Technology", "Data and Analytics", "Design", "Creative and Art Services", "Project and Program Management", "Product Management", "Business Operations", "Legal and Compliance", "Finance and Accounting", "Human Resources", "Administrative & Clerical Support", "Sales", "Marketing", "Communications and Public Affairs", "Business Development" ] } }, "minSalary": { "title": "Minimum pay", "minimum": 0, "type": "integer", "description": "Only jobs whose pay starts at or above this amount (in the pay period and currency below)." }, "salaryFrequency": { "title": "Pay period", "enum": [ "Yearly", "Monthly", "Weekly", "Daily", "Hourly" ], "type": "string", "description": "Period for the minimum pay.", "default": "Yearly" }, "salaryCurrency": { "title": "Pay currency", "type": "string", "description": "Three-letter currency code for the minimum pay, e.g. USD, CAD, GBP, EUR.", "default": "USD" }, "postedSalaryOnly": { "title": "Only jobs with a published salary", "type": "boolean", "description": "Skip postings where the employer did not publish a pay range.", "default": false }, "maxYearsExperience": { "title": "Max years of experience required", "minimum": 0, "maximum": 20, "type": "integer", "description": "Only roles asking for at most this many years of experience (great for new grads and career changers)." }, "companyNames": { "title": "Only these companies", "type": "array", "description": "Restrict results to these employers.", "items": { "type": "string" } }, "excludeCompanyNames": { "title": "Exclude companies", "type": "array", "description": "Leave these employers out (e.g. staffing agencies, your current employer).", "items": { "type": "string" } }, "minEmployees": { "title": "Company size: min employees", "minimum": 1, "type": "integer", "description": "Only companies with at least this many employees." }, "maxEmployees": { "title": "Company size: max employees", "minimum": 1, "type": "integer", "description": "Only companies with at most this many employees (e.g. 200 for startups)." }, "organizationTypes": { "title": "Company type", "type": "array", "description": "Public, private, non-profit, government or cooperative employers.", "items": { "type": "string", "enum": [ "public", "private", "non-profit", "government", "cooperative / mutual" ] } }, "benefits": { "title": "Benefits", "type": "array", "description": "Only jobs that mention these benefits.", "items": { "type": "string", "enum": [ "visa_sponsorship", "relocation_assistance", "four_day_work_week", "401k_matching", "retirement_plan", "generous_paid_time_off", "generous_parental_leave", "tuition_reimbursement" ] } }, "radiusMiles": { "title": "Search radius (miles)", "minimum": 1, "maximum": 300, "type": "integer", "description": "Distance around a city. Ignored for states and countries.", "default": 50 }, "sortBy": { "title": "Sort by", "enum": [ "default", "date", "compensation_desc", "experience_asc" ], "type": "string", "description": "Result order. (Complete mode only; Quick mode returns relevance order.)", "default": "default" }, "engine": { "title": "Mode", "enum": [ "auto", "full", "fast" ], "type": "string", "description": "Complete: every matching job with the employer's own apply link, views/applies/saves and company funding data (recommended). Quick: a lighter, faster sample of roughly one job per employer. Auto uses Complete and switches to Quick if Complete is unavailable.", "default": "auto" }, "expandCompanyCards": { "title": "Include every job per company", "type": "boolean", "description": "HiringCafe groups several jobs of the same company into one card. When on, every matching job of those companies is returned, not only the first few.", "default": true }, "includeAllLocations": { "title": "One row per location", "type": "boolean", "description": "HiringCafe folds the same role posted for several locations into one listing. When on, each location’s posting is returned as its own row with its own apply link.", "default": true }, "concurrency": { "title": "Concurrency", "minimum": 1, "maximum": 12, "type": "integer", "description": "Parallel requests. Higher is faster.", "default": 6 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Proxy for the job details and location lookups. The default works well.", "default": { "useApifyProxy": true } }, "_noUnblocker": { "title": "Run without the UNBLOCKER proxy", "type": "boolean", "description": "Internal (canaries): behave exactly like an account without the UNBLOCKER proxy group.", "default": false } } }, "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 } } } } } } } } } }