{ "openapi": "3.0.1", "info": { "title": "IIMJobs Jobs Scraper: Search & Monitor Management Roles", "description": "Get IIMJobs job listings for any role or skill, filtered by city, category and years of experience. Returns title, company and rating, cities, skills, salary, applicants, posting date and full description. Monitor mode returns only new jobs. $1.80 per 1,000 jobs; failed searches free.", "version": "1.0", "x-build-id": "p756C3eBdGwfgs6Be" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/tenfoldfleet~iimjobs-jobs-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-tenfoldfleet-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/tenfoldfleet~iimjobs-jobs-scraper/runs": { "post": { "operationId": "runs-sync-tenfoldfleet-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/tenfoldfleet~iimjobs-jobs-scraper/run-sync": { "post": { "operationId": "run-sync-tenfoldfleet-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": { "keywords": { "title": "Keywords", "type": "array", "description": "Job titles, skills or roles to search, for example \"private equity\", \"product manager\" or \"CFA\". A broad keyword can return several thousand jobs. Leave empty to collect the latest jobs across the whole site (several broad searches merged, duplicates removed).", "items": { "type": "string" } }, "locations": { "title": "Cities", "type": "array", "description": "Optional. Keep only jobs in these cities, for example Mumbai, Bangalore, Gurgaon, Delhi, Pune. Partial names match (\"Gurgaon\" matches \"Gurgaon/Gurugram\"). Use \"Remote\" for work-from-home jobs.", "items": { "type": "string" } }, "functionalArea": { "title": "Job category", "type": "array", "description": "Optional. Keep only jobs in these IIMJobs categories.", "items": { "type": "string", "enum": [ "Banking & Finance", "Sales & Marketing", "Consulting", "HR & IR", "IT & Systems", "SCM & Operations", "Legal", "BPO", "GenAI" ] } }, "minExperience": { "title": "Minimum years of experience", "minimum": 0, "maximum": 60, "type": "integer", "description": "Optional. Keep jobs whose experience range reaches at least this many years." }, "maxExperience": { "title": "Maximum years of experience", "minimum": 0, "maximum": 60, "type": "integer", "description": "Optional. Keep jobs whose experience range starts at or below this many years." }, "maxJobs": { "title": "Max jobs", "minimum": 1, "type": "integer", "description": "Stop after this many jobs in total, across all keywords. 500 jobs cost about $0.90, so the Apify free plan's $5 monthly credit covers roughly 2,700 jobs.", "default": 500 }, "includeDetails": { "title": "Include full job description", "type": "boolean", "description": "Also load each job's page and return the full description as plain text. Same price per job; the run takes a little longer.", "default": false }, "monitorMode": { "title": "Monitor mode (new jobs only)", "type": "boolean", "description": "Remember the jobs returned for this exact search setup and, on later runs, return and charge only jobs not seen before. Schedule it daily for a feed of fresh postings.", "default": false }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Optional. The site works without a 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 } } } } } } } } } }