{ "openapi": "3.0.1", "info": { "title": "Hirist Jobs Scraper | Full Descriptions & Salary", "description": "Scrape tech and IT jobs from Hirist.tech with full descriptions, disclosed salaries, skills and recruiter details. Filter by city, category, experience and posting date. Export CSV, Excel or JSON, or use the API. $3 per 1,000 jobs, including descriptions.", "version": "0.3", "x-build-id": "fwkXHglyGh9s7cOHj" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/cauldo~hirist-jobs-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-cauldo-hirist-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/cauldo~hirist-jobs-scraper/runs": { "post": { "operationId": "runs-sync-cauldo-hirist-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/cauldo~hirist-jobs-scraper/run-sync": { "post": { "operationId": "run-sync-cauldo-hirist-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": [ "keyword" ], "properties": { "keyword": { "title": "Search keyword", "minLength": 1, "maxLength": 200, "type": "string", "description": "Search Hirist's public job feed, for example python or java developer." }, "locations": { "title": "Locations", "uniqueItems": true, "type": "array", "description": "Optional. Match at least one selected location. Delhi NCR, Metros, Anywhere in India and Overseas/International include Hirist's listed sublocations. Remote matches Hirist's Remote location tag. Leave empty for all locations.", "items": { "type": "string", "enum": [ "Metros", "Anywhere in India", "Overseas/International", "Abu Dhabi", "Afghanistan", "Africa", "Agra", "Ahmedabad", "Amritsar", "Andaman and Nicobar Island", "Andhra Pradesh", "Arunachal Pradesh", "Assam", "Aurangabad", "Australia", "Baddi", "Bahrain", "Bangalore", "Bangladesh", "Bhopal", "Bhubaneshwar", "Bhutan", "Bihar", "Canada", "Chandigarh", "Chennai", "Chhattisgarh", "China", "Cochin/Kochi", "Coimbatore", "Cuttack", "Dadra and Nagar Haveli", "Daman and Diu", "Dehradun", "Delhi", "Delhi NCR", "Dhaka", "Doha", "Dubai", "Egypt", "England", "Ethiopia", "EU", "Faridabad", "Gandhinagar", "Germany", "Ghaziabad", "Goa", "Greater Noida", "Gujarat", "Guntur", "Gurgaon/Gurugram", "Guwahati", "Gwalior", "Haridwar", "Haryana", "Himachal Pradesh", "Hong Kong", "Hosur", "Hubli", "Hyderabad", "Imphal", "Indore", "Indonesia", "Jaipur", "Jalandhar", "Jammu", "Jammu & Kashmir", "Jamnagar", "Jamshedpur", "Japan", "Jharkhand", "Jodhpur", "Kabul", "Kanpur", "Karnataka", "Kenya", "Kerala", "Kolkata", "Kozhikode", "Kuwait", "Lakshadweep", "London", "Lucknow", "Ludhiana", "Madurai", "Maharashtra", "Malaysia", "Manesar", "Mangalore", "Manipur", "Meghalaya", "Middle East", "Mizoram", "Mohali", "MP", "Mumbai", "Muscat", "Mysore", "Nagaland", "Nagpur", "Nairobi", "Nasik", "Navi Mumbai", "Nepal", "Nigeria", "Noida", "Odisha", "Oman", "Others", "Pakistan", "Panchkula", "Panipat", "Patiala", "Patna", "Philippines", "Pondicherry", "Pune", "Punjab", "Qatar", "Raipur", "Rajasthan", "Rajkot", "Ranchi", "Remote", "Riyadh", "Salem", "Saudi Arabia", "Secunderabad", "Shillong", "Shimla", "Sikkim", "Siliguri", "Silvassa", "Singapore", "Sonipat", "South Africa", "Sri Lanka", "Srinagar", "Surat", "Switzerland", "Tamil Nadu", "Tanzania", "Telangana", "Thane", "Tiruchirappalli", "Tirupati", "Tripura", "Trivandrum/Thiruvananthapuram", "Udaipur", "UK", "UP", "US", "Uttarakhand", "Vadodara/Baroda", "Vapi", "Varanasi/Banaras", "Vellore", "Vijayawada", "Vishakhapatnam/Vizag", "Warangal", "West Bengal", "Zambia", "Zimbabwe" ] }, "default": [] }, "categories": { "title": "Job categories", "uniqueItems": true, "type": "array", "description": "Optional. Match at least one selected Hirist category, such as Backend Development or AI/ML. If locations are also selected, each job must match both filters. Leave empty for all categories.", "items": { "type": "string", "enum": [ "Data Analytics & BI", "Mobile Applications", "DevOps/SRE", "Frontend Development", "Backend Development", "Emerging Technologies", "UI & Design", "Quality Assurance", "Product Management", "Platform Engineering/SAP/Oracle", "Semiconductor/VLSI/EDA", "Business Analysis and Project Management", "AI/ML", "Data Engineering", "Full Stack", "CyberSecurity", "Others" ] }, "default": [] }, "experienceMinYears": { "title": "Minimum experience (years)", "minimum": 0, "maximum": 50, "type": "integer", "description": "Keep jobs whose required experience range overlaps your selected range. For 3–5 years, a job asking for 2–7 years qualifies. Leave blank for no lower bound." }, "experienceMaxYears": { "title": "Maximum experience (years)", "minimum": 0, "maximum": 50, "type": "integer", "description": "Upper bound of your experience range. A job qualifies when its required range overlaps yours. Leave blank for no upper bound." }, "postedWithinDays": { "title": "Posted within days", "minimum": 1, "maximum": 365, "type": "integer", "description": "Keep jobs with a source posting timestamp within this many 24-hour periods before the run starts. Leave blank for all dates." }, "companyName": { "title": "Company name contains", "maxLength": 200, "type": "string", "description": "Optional case-insensitive match on the employer name, for example Infosys. Jobs without a matching employer name are skipped.", "default": "" }, "workFromHome": { "title": "Work-from-home jobs only", "type": "boolean", "description": "Require Hirist’s work-from-home flag. This is separate from selecting Remote under Locations. Leave off for all work arrangements.", "default": false }, "maxJobs": { "title": "Maximum jobs", "minimum": 1, "maximum": 500, "type": "integer", "description": "Maximum unique matching jobs delivered in this run, up to 500. Start with 10. Default run timeout is 15 minutes; large description runs can take several minutes.", "default": 10 }, "includeDescriptions": { "title": "Include complete descriptions", "type": "boolean", "description": "Fetch the public detail endpoint for every delivered job. Returns plain text and the original source HTML without a 4,000-character cap. Adds one request per job.", "default": true }, "maxPages": { "title": "Maximum search pages", "minimum": 1, "maximum": 200, "type": "integer", "description": "Safety limit on the number of search pages fetched. The summary states when this limit stops the search.", "default": 100 } } }, "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 } } } } } } } } } }