{ "openapi": "3.0.1", "info": { "title": "IIMJobs Scraper: MBA, CA, CFA Jobs India with Recruiter Data", "description": "Scrape IIMJobs.com MBA, CA, CFA and management jobs across India with recruiter name, company rating and salary included free, no extra requests. Filter by role, city, industry, experience, diversity. Free company lead list plus new-job monitoring. Sheets, Airtable, n8n ready. $0.0039 per job.", "version": "1.1", "x-build-id": "0gLMOjht11qAF0wxw" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/getascraper~iimjobs-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-getascraper-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/getascraper~iimjobs-scraper/runs": { "post": { "operationId": "runs-sync-getascraper-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/getascraper~iimjobs-scraper/run-sync": { "post": { "operationId": "run-sync-getascraper-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": { "jobTitle": { "title": "Job Title / Keyword", "type": "string", "description": "A single job role, designation, or keyword to search for (e.g., 'Product Manager', 'Investment Banking', 'CFO'). Leave empty (with Job Titles and Start URLs also empty) to browse all current listings, optionally narrowed by Location/Industry below. For multiple keywords in one run, use \"Job Titles\" instead.", "default": "" }, "jobTitles": { "title": "Job Titles (multiple)", "type": "array", "description": "Search several roles in one run, e.g. [\"Product Manager\", \"CFO\", \"Strategy Consultant\"]. Takes precedence over the single Job Title field above. Results across keywords are automatically de-duplicated.", "default": [], "items": { "type": "string" } }, "startUrls": { "title": "Start URLs (job detail links)", "type": "array", "description": "Paste specific IIMJobs job URLs (e.g. https://www.iimjobs.com/j/company-role-1727623) to enrich exactly those listings with full details, without running a search.", "default": [], "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "location": { "title": "Location Filter", "enum": [ "0", "2", "3", "36", "4", "7", "6", "37", "39" ], "type": "string", "description": "Select a specific Indian city to filter jobs. Leave empty to search across all of India.", "default": "0" }, "industry": { "title": "Industry Filter", "enum": [ "0", "t-1", "t-2", "t-3", "t-5", "t-6", "2", "13", "8", "52", "24", "4", "7", "14", "64", "22", "17", "6", "25", "15", "40", "29", "18", "12", "3", "28", "35", "5", "9", "23", "26", "1", "11", "10", "30", "51", "47", "34", "44", "56", "32", "41", "67", "55", "53", "31", "68", "20", "37", "16", "19", "38", "45", "27", "42", "43", "63", "59", "48", "60", "39", "57", "46", "66", "50", "61", "36", "62", "65", "33" ], "type": "string", "description": "Select an industry to filter jobs (e.g., FinTech, B2B SaaS, Banking, IT-Software).", "default": "0" }, "minExperience": { "title": "Minimum Experience (Years)", "minimum": 0, "maximum": 30, "type": "integer", "description": "Filter jobs requiring at least this many years of experience.", "default": 0 }, "maxExperience": { "title": "Maximum Experience (Years)", "minimum": 0, "maximum": 30, "type": "integer", "description": "Filter jobs requiring at most this many years of experience.", "default": 30 }, "minSalary": { "title": "Minimum Disclosed Salary (LPA)", "minimum": 0, "type": "integer", "description": "Only keep jobs that disclose a salary and whose upper band meets this minimum (in lakhs per annum). Note: only about 5-10% of IIMJobs listings disclose salary at all; leave at 0 to not filter on this.", "default": 0 }, "datePosted": { "title": "Posted Within", "enum": [ "any", "today", "last3days", "last7days", "last30days" ], "type": "string", "description": "Only keep jobs posted within this window.", "default": "any" }, "workFromHomeOnly": { "title": "Work-from-home roles only", "type": "boolean", "description": "Only keep listings explicitly marked as work-from-home.", "default": false }, "excludeConfidential": { "title": "Exclude confidential-employer listings", "type": "boolean", "description": "Skip roles where the hiring company's identity is withheld.", "default": false }, "femaleCandidatePreferredOnly": { "title": "Female-candidate-preferred only", "type": "boolean", "description": "Only keep listings IIMJobs flags as preferring female candidates.", "default": false }, "differentlyAbledFriendlyOnly": { "title": "Differently-abled-friendly only", "type": "boolean", "description": "Only keep listings IIMJobs flags as differently-abled friendly.", "default": false }, "exDefencePreferredOnly": { "title": "Ex-defence-preferred only", "type": "boolean", "description": "Only keep listings IIMJobs flags as preferring ex-defence personnel.", "default": false }, "womenReturningToWorkOnly": { "title": "Women-returning-to-work-friendly only", "type": "boolean", "description": "Only keep listings IIMJobs flags as friendly to women returning to the workforce.", "default": false }, "deepScrape": { "title": "Deep Scrape (Full Description + Extra Fields)", "type": "boolean", "description": "If enabled, visits each job's detail page for the full job description text, employer domain, headcount context, and campus graduation-batch targeting. Recruiter name/designation and company rating are already included without this, at no extra cost.", "default": false }, "maxResults": { "title": "Max Results", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Maximum number of job listings to scrape (across all keywords combined).", "default": 50 }, "onlyNewJobs": { "title": "Only new jobs (monitoring mode)", "type": "boolean", "description": "When enabled, the first run builds a baseline of seen job IDs; later scheduled runs only save jobs never delivered before, and flag salary-reveal / demand-spike / reposted changes on jobs you've already seen. Pair with a schedule for a recurring \"new jobs\" feed.", "default": false }, "resetSeenJobs": { "title": "Reset monitoring baseline", "type": "boolean", "description": "Clear the stored seen-job state for this State Key before this run, so the next run starts a fresh baseline.", "default": false }, "stateKey": { "title": "Monitoring State Key", "type": "string", "description": "Identifies which saved monitoring baseline to use. Use a different key per saved task if you run multiple independent searches on a schedule.", "default": "" }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Apify Proxy configuration. Datacenter proxies are highly recommended and cost-effective for IIMJobs.", "default": { "useApifyProxy": true } } } }, "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 } } } } } } } } } }