{ "openapi": "3.0.1", "info": { "title": "Hirist & IIMJobs Jobs Scraper - India Tech & Management Jobs", "description": "Scrape Hirist (tech) and IIMJobs (MBA, finance, consulting) jobs in one run: title, company, AmbitionBox rating, city, experience, salary in INR, skills, applicants, posted date and full description. Filter by keyword, city, experience and date. Only-new-jobs mode. No login.", "version": "0.1", "x-build-id": "3QuC0n7PNjchEsQ6T" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/rjmacarthy~hirist-iimjobs-jobs-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-rjmacarthy-hirist-iimjobs-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/rjmacarthy~hirist-iimjobs-jobs-scraper/runs": { "post": { "operationId": "runs-sync-rjmacarthy-hirist-iimjobs-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/rjmacarthy~hirist-iimjobs-jobs-scraper/run-sync": { "post": { "operationId": "run-sync-rjmacarthy-hirist-iimjobs-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": { "sites": { "title": "Job boards", "type": "array", "description": "Which boards to search. Both run in parallel and share one output schema; the \"site\" field tells you where each job came from.", "items": { "type": "string", "enum": [ "hirist", "iimjobs" ], "enumTitles": [ "Hirist (hirist.tech) - tech jobs", "IIMJobs (iimjobs.com) - MBA, finance, consulting & management jobs" ] }, "default": [ "hirist", "iimjobs" ] }, "keywords": { "title": "Keywords (skills, titles, companies)", "type": "array", "description": "Each entry is a separate search on every selected board, e.g. \"python\", \"product manager\", \"investment banking\", \"chartered accountant\". Results are ranked by relevance. Leave empty to get the LATEST jobs of each board (all categories, newest first). A job found by several keywords is output (and charged) once.", "items": { "type": "string" } }, "locations": { "title": "Locations", "type": "array", "description": "Optional city, state or country names as used on the sites, e.g. \"Bangalore\", \"Mumbai\", \"Delhi NCR\", \"Gurgaon\", \"Pune\", \"Hyderabad\", \"Remote\", \"Dubai\". A job matches if any of its locations matches. Leave empty for all of India and overseas.", "items": { "type": "string" } }, "experienceMin": { "title": "Experience from (years)", "minimum": 0, "maximum": 50, "type": "integer", "description": "Optional. Keep jobs whose experience range overlaps this range (the sites' own filter)." }, "experienceMax": { "title": "Experience to (years)", "minimum": 0, "maximum": 50, "type": "integer", "description": "Optional. Upper end of the experience range in years." }, "postedWithinDays": { "title": "Posted within (days)", "minimum": 0, "maximum": 30, "type": "integer", "description": "Only jobs posted in the last 1, 3, 7, 15 or 30 days. 0 = any time.", "default": 0 }, "includeDescription": { "title": "Include full description", "type": "boolean", "description": "Fetch each job's detail record for the full description (plain text and HTML) and the exact applicant count. Included in the per-job price. Turn off for faster list-only runs (description fields are then null).", "default": true }, "maxItems": { "title": "Max jobs per site and keyword", "minimum": 0, "type": "integer", "description": "Stop each search (one keyword on one board) after this many jobs. 0 = no limit.", "default": 100 }, "onlyNew": { "title": "Only new jobs", "type": "boolean", "description": "Output (and pay for) only jobs not output by an earlier run with the same \"Monitor name\". The first run outputs everything and becomes the baseline. Ideal for scheduled job alerts and feeding a job board.", "default": false }, "stateKey": { "title": "Monitor name", "type": "string", "description": "Name of the \"only new jobs\" memory. Use a different name for each separate alert/schedule.", "default": "default" }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Usually not needed: the Hirist and IIMJobs APIs answer Apify's IPs directly. If you get HTTP 403/429, enable Apify Proxy (datacenter). Residential proxies are not supported; a RESIDENTIAL group automatically falls back to datacenter proxy.", "default": { "useApifyProxy": 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 } } } } } } } } } }