{ "openapi": "3.0.1", "info": { "title": "Hirist & IIMJobs Jobs Scraper 💼 (India tech + MBA jobs)", "description": "Jobs from hirist.tech (IT, tech) and iimjobs.com (MBA, finance, sales, HR, consulting) in one run, by keyword, category, city, experience or posting date: company, salary in LPA, skills, AmbitionBox rating and full description. Only-new monitor mode. No login.", "version": "0.1", "x-build-id": "anHI4VRVP8k2Bv6hh" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/tagadanar~hirist-iimjobs-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-tagadanar-hirist-iimjobs-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/tagadanar~hirist-iimjobs-scraper/runs": { "post": { "operationId": "runs-sync-tagadanar-hirist-iimjobs-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/tagadanar~hirist-iimjobs-scraper/run-sync": { "post": { "operationId": "run-sync-tagadanar-hirist-iimjobs-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": { "sites": { "title": "Sites", "enum": [ "both", "hirist", "iimjobs" ], "type": "string", "description": "hirist.tech lists IT and tech jobs; iimjobs.com lists MBA, finance, sales, HR, consulting and other management jobs. Both = every search runs on each site.", "default": "both" }, "keywords": { "title": "Keywords", "type": "array", "description": "What you would type in the sites' search box: a role, skill or title (for example Data Analyst, Python, Product Manager, Chartered Accountant). One per line; each line is its own search on each site. Leave empty to list every job (optionally narrowed by category, city, experience and date).", "items": { "type": "string" } }, "categories": { "title": "Categories", "type": "array", "description": "The sites' own job categories. A hirist category only searches hirist.tech and an iimjobs category only iimjobs.com. Several categories in one run are combined (any of them).", "items": { "type": "string", "enum": [ "hirist-backend-development", "hirist-frontend-development", "hirist-full-stack", "hirist-mobile-applications", "hirist-ai-ml", "hirist-data-engineering", "hirist-data-analytics-bi", "hirist-devops-sre", "hirist-cybersecurity", "hirist-quality-assurance", "hirist-product-management", "hirist-ui-design", "hirist-business-analysis-project-management", "hirist-platform-engineering-sap-oracle", "hirist-semiconductor-vlsi-eda", "hirist-emerging-technologies", "hirist-others", "iimjobs-banking-finance", "iimjobs-sales-marketing", "iimjobs-consulting-general-mgmt", "iimjobs-hr-ir", "iimjobs-it-systems", "iimjobs-scm-operations", "iimjobs-legal", "iimjobs-bpo", "iimjobs-genai" ], "enumTitles": [ "hirist: Backend Development", "hirist: Frontend Development", "hirist: Full Stack", "hirist: Mobile Applications", "hirist: AI/ML", "hirist: Data Engineering", "hirist: Data Analytics & BI", "hirist: DevOps/SRE", "hirist: CyberSecurity", "hirist: Quality Assurance", "hirist: Product Management", "hirist: UI & Design", "hirist: Business Analysis and Project Management", "hirist: Platform Engineering/SAP/Oracle", "hirist: Semiconductor/VLSI/EDA", "hirist: Emerging Technologies", "hirist: Others", "iimjobs: Banking & Finance", "iimjobs: Sales & Marketing", "iimjobs: Consulting", "iimjobs: HR & IR", "iimjobs: IT & Systems", "iimjobs: SCM & Operations", "iimjobs: Legal", "iimjobs: BPO", "iimjobs: GenAI" ] } }, "locations": { "title": "Locations", "type": "array", "description": "Indian cities or regions, one per line (for example Bangalore, Mumbai, Delhi NCR, Pune, Hyderabad, Chennai, Gurgaon, Noida) or Remote. Bengaluru, Gurugram, NCR and WFH are understood; Delhi NCR includes Gurgaon, Noida, Ghaziabad, Faridabad and Greater Noida. A job in several cities matches if any of them is yours.", "items": { "type": "string" } }, "experienceMin": { "title": "Experience (years), from", "minimum": 0, "maximum": 50, "type": "integer", "description": "Only jobs whose experience range overlaps yours. 5 and 8 returns jobs asking for, say, 3-6 or 7-12 years. Either end alone works." }, "experienceMax": { "title": "Experience (years), up to", "minimum": 0, "maximum": 50, "type": "integer", "description": "Upper end of your experience range." }, "postedWithin": { "title": "Posted within", "enum": [ "any", "3", "7", "15", "30", "90" ], "type": "string", "description": "Only jobs posted in this window (the sites' own date filter, re-checked on every row).", "default": "any" }, "maxResults": { "title": "Max jobs per search", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Stop each search (each keyword on each site, or each pasted listing URL) after this many jobs. You only pay for jobs delivered. The sites list at most 10,000 jobs per search.", "default": 100 }, "includeDetails": { "title": "Include full job description", "type": "boolean", "description": "Open every job for its full description (plain text) and fill company facts the list leaves out. One extra request per job, so slower on big runs; same price per job.", "default": false }, "onlyNew": { "title": "Only jobs not delivered before (monitor mode)", "type": "boolean", "description": "Skip any job an earlier run of this scraper already delivered to your account, so a scheduled daily run returns only new listings. The memory is a key-value store named hirist-iimjobs-jobs-seen in your account; delete it to start over.", "default": false }, "startUrls": { "title": "hirist.tech / iimjobs.com URLs", "type": "array", "description": "Paste job pages (https://www.iimjobs.com/j/head-marketing-1738663), search pages (https://www.hirist.tech/search/python), skill pages (https://www.hirist.tech/k/python-jobs), category pages (https://www.iimjobs.com/c/banking-finance-jobs) or city pages (https://www.hirist.tech/it-jobs-in-pune). Works together with the fields above.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } } } }, "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 } } } } } } } } } }