{ "openapi": "3.0.1", "info": { "title": "IIMJobs Scraper: MBA, Finance & CA Jobs India with Recruiters", "description": "Scrape IIMJobs.com jobs across India: MBA, finance, consulting, CA and CFA roles with recruiter names, company ratings, skills and applicant counts on every row. Filter by role, city or industry, add full descriptions, and schedule daily new-jobs feeds for Sheets, Airtable or n8n.", "version": "1.3", "x-build-id": "zee4EYscc0SL4q3M7" }, "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" }, "locations": { "title": "Cities (multiple)", "type": "array", "description": "Search several cities in one run, e.g. [\"Mumbai\", \"Bangalore\", \"Delhi NCR\", \"Remote\"]. Major cities use the site filter; any other city name is matched against each job's listed locations. Can be combined with the Location Filter above. Leave empty for all of India.", "default": [], "items": { "type": "string" } }, "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" }, "postedWithinDays": { "title": "Posted within (days)", "minimum": 1, "maximum": 365, "type": "integer", "description": "Only keep jobs posted in the last N days (1 to 365), for example 1 for a daily feed or 7 for a weekly report. Overrides the Posted Within list above when set. Leave empty for all open jobs." }, "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 save across all keywords combined. In monitoring mode only newly delivered jobs count. Free-plan runs are limited to 100.", "default": 50 }, "maxResultsPerKeyword": { "title": "Max results per keyword", "minimum": 0, "maximum": 5000, "type": "integer", "description": "Optional cap for each keyword or city search so one broad keyword cannot use up the whole run. 0 means no per-keyword cap. The Max Results total still applies.", "default": 0 }, "skipJobIds": { "title": "Skip job IDs you already have", "type": "array", "description": "Job IDs from earlier exports (the id field). They are skipped before any detail fetch and never saved or charged. Large lists are fine.", "default": [], "items": { "type": "string" } }, "onlyNewJobs": { "title": "Only new jobs (monitoring mode)", "type": "boolean", "description": "When enabled, the first run builds a baseline of delivered job IDs and later scheduled runs save and charge only jobs you have never received before. The baseline lives in a key-value store named iimjobs-monitor-state in your account, one entry per Monitor Scope. Pair it with a schedule for a recurring new-jobs feed. With a Monitor Scope but this switch off, every job is saved and flagged with change events instead.", "default": false }, "resetSeenJobs": { "title": "Reset monitoring baseline", "type": "boolean", "description": "Clear the saved baseline for this Monitor Scope before this run, so the run starts fresh.", "default": false }, "monitorScope": { "title": "Monitor Scope", "type": "string", "description": "Names the saved search used by monitoring (for example pm-bangalore-daily). Use a different scope for each independent saved task. Leave empty to use the shared default scope.", "default": "" }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Optional. The site answers direct connections, so runs go direct by default and use Apify Proxy automatically only if the site refuses one. Pick specific proxy groups or a country to always use a proxy.", "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 }, "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 } } } } } } } } } }