{
  "openapi": "3.0.1",
  "info": {
    "title": "iimjobs Scraper & API: Recruiter Actions, Applicants",
    "description": "Scrape iimjobs.com jobs in India (management, finance, consulting, MBA) with what iimjobs Pro sells: recruiter actions on applications, applicants, views, recruiter last active. Exact keyword matches, AmbitionBox ratings, job alerts.",
    "version": "0.1",
    "x-build-id": "D07EO6vhAV8fc8QdU"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/s_actors~iimjobs-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-s_actors-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/s_actors~iimjobs-scraper/runs": {
      "post": {
        "operationId": "runs-sync-s_actors-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/s_actors~iimjobs-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-s_actors-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": {
          "keywords": {
            "title": "🔎 Job titles or keywords",
            "type": "array",
            "description": "Job title, function or skill, one per line: \"product manager\", \"investment banking\", \"chief of staff\", \"HR business partner\", \"equity research\", \"strategy\". Each keyword = iimjobs's title search without its loose tail (its search for \"brand manager\" also returns \"Brand Head\" and \"Manager - Marketing\": the Actor drops jobs whose title, role and skills miss a word, free) + every job tagged with the skill, when iimjobs has that skill. Empty = every job of the categories below, or the whole iimjobs board.",
            "items": {
              "type": "string"
            }
          },
          "locations": {
            "title": "📍 Locations",
            "type": "array",
            "description": "City, state or country as on iimjobs: \"Mumbai\", \"Bangalore\" (or Bengaluru), \"Gurgaon\", \"Delhi NCR\", \"Noida\", \"Pune\", \"Hyderabad\", \"Chennai\", \"Kolkata\", \"Remote\", \"Dubai\", \"Singapore\". iimjobs filters by them itself; several = any of them. Empty = everywhere.",
            "items": {
              "type": "string"
            }
          },
          "categories": {
            "title": "🗂️ Categories",
            "type": "array",
            "description": "iimjobs categories: \"Banking & Finance\", \"Sales & Marketing\", \"Consulting\", \"HR & IR\", \"IT & Systems\", \"SCM & Operations\", \"Legal\", \"BPO\", \"GenAI\" (short names work: finance, marketing, strategy, HR, operations). Without keywords = every job of these categories; with keywords = only keyword jobs in them.",
            "items": {
              "type": "string"
            }
          },
          "remoteOnly": {
            "title": "🏠 Remote jobs",
            "type": "boolean",
            "description": "Adds iimjobs's \"Remote\" location. Every row has workplaceType (remote, hybrid = remote or office, on-site).",
            "default": false
          },
          "experienceYears": {
            "title": "🎓 Your years of experience",
            "minimum": 0,
            "maximum": 40,
            "type": "integer",
            "description": "Only jobs whose experience range includes this many years. 0 = jobs for freshers (entry level). Empty = any. Removed jobs are free."
          },
          "postedWithin": {
            "title": "🕒 Posted within",
            "enum": [
              "anyTime",
              "past24Hours",
              "past3Days",
              "pastWeek",
              "past2Weeks",
              "pastMonth",
              "past3Months"
            ],
            "type": "string",
            "description": "iimjobs's own date filter. Every row has postedDate and daysSincePosted.",
            "default": "anyTime"
          },
          "maxJobsPerSearch": {
            "title": "🔢 Max jobs per search",
            "minimum": 1,
            "maximum": 30000,
            "type": "integer",
            "description": "Per keyword, category or link. With only a location (no keyword or category) this is the total for the whole board. The Actor reads iimjobs 1,000 jobs a request, so large pulls are fast.",
            "default": 100
          },
          "sortBy": {
            "title": "↕️ Order",
            "enum": [
              "iimjobs",
              "newest"
            ],
            "type": "string",
            "description": "Newest first = the Actor reads the whole search and orders it by the posting time. A keyword (title search + skill tag) always comes newest first.",
            "default": "iimjobs"
          },
          "recruiterActiveWithinDays": {
            "title": "🟢 Recruiter active within (days)",
            "minimum": 0,
            "maximum": 365,
            "type": "integer",
            "description": "Keep jobs whose recruiter logged in to iimjobs in the last N days (0 = today), as the job page shows (\"Last Active\"). Jobs posted through an ATS have no date and are removed. Removed jobs are free."
          },
          "onlyRespondingRecruiters": {
            "title": "💬 Only recruiters who act on applications",
            "type": "boolean",
            "description": "Keep jobs where the recruiter has already acted on applications (viewed, shortlisted or replied: the \"recruiter actions\" iimjobs Pro shows). The share is in recruiterActionRate.",
            "default": false
          },
          "maxApplicants": {
            "title": "👥 Max applicants",
            "minimum": 0,
            "type": "integer",
            "description": "Keep jobs with at most this many applications so far (less competition), e.g. 100."
          },
          "excludeAtsJobs": {
            "title": "🤖 Skip jobs posted through an ATS",
            "type": "boolean",
            "description": "iimjobs marks jobs imported from a third-party hiring tool: their recruiter activity is not shown (postedViaAts = true).",
            "default": false
          },
          "minCompanyRating": {
            "title": "⭐ Min company rating",
            "minimum": 0,
            "maximum": 5,
            "type": "number",
            "description": "Keep jobs of companies rated at least this on AmbitionBox (1-5, as shown on iimjobs), e.g. 3.5. Companies without a rating are removed. Removed jobs are free."
          },
          "onlyWithSalary": {
            "title": "💰 Only jobs with a salary",
            "type": "boolean",
            "description": "Keep jobs that show the salary (lakhs per annum). About 9 in 10 iimjobs recruiters hide it.",
            "default": false
          },
          "keywordMatch": {
            "title": "🧩 Keyword match",
            "enum": [
              "smart",
              "title",
              "loose"
            ],
            "type": "string",
            "description": "How a keyword is searched. Exact = every word of the keyword is in the title, role or skills (manager = management).",
            "default": "smart"
          },
          "titleMustMatchKeyword": {
            "title": "🎯 Title must contain the keyword",
            "type": "boolean",
            "description": "On = only jobs whose title has every word of the keyword (\"investment banking\" drops an \"Associate - M&A\" job tagged Investment Banking). Removed jobs are free.",
            "default": false
          },
          "titleInclude": {
            "title": "✅ Title must contain one of",
            "type": "array",
            "description": "Keep only jobs whose title contains one of these words, e.g. \"senior\", \"lead\".",
            "items": {
              "type": "string"
            }
          },
          "titleExclude": {
            "title": "🚫 Title must not contain",
            "type": "array",
            "description": "Remove jobs whose title contains one of these words, e.g. \"intern\", \"sales\".",
            "items": {
              "type": "string"
            }
          },
          "companyExclude": {
            "title": "🚷 Exclude companies",
            "type": "array",
            "description": "Remove jobs of companies whose name contains one of these, e.g. staffing agencies.",
            "items": {
              "type": "string"
            }
          },
          "skipDuplicates": {
            "title": "♻️ Skip reposts",
            "type": "boolean",
            "description": "Companies often post one job many times: same title + company + cities = one row.",
            "default": true
          },
          "searchUrls": {
            "title": "🔗 iimjobs listing links",
            "type": "array",
            "description": "Pages such as iimjobs.com/k/investment-banking-jobs (skill), iimjobs.com/c/banking-finance-jobs (category), iimjobs.com/search/product-manager, with their loc and posting filters.",
            "items": {
              "type": "string"
            }
          },
          "recruiterUrls": {
            "title": "🔗 iimjobs recruiter links",
            "type": "array",
            "description": "Recruiter profiles, e.g. https://www.iimjobs.com/r/149963-suraj: all their open jobs.",
            "items": {
              "type": "string"
            }
          },
          "jobUrls": {
            "title": "🔗 iimjobs job links",
            "type": "array",
            "description": "Links of single jobs, e.g. https://www.iimjobs.com/j/ketto-product-managersenior-product-manager-metago-1736442, or just the number 1736442.",
            "items": {
              "type": "string"
            }
          },
          "includeJobDetails": {
            "title": "📄 Job page data",
            "type": "boolean",
            "description": "Recruiter activity (applications, views, recruiter actions, last active), recruiter name and title, full description and the company's AmbitionBox profile: one request per job, included in the price. Off = faster runs with the listing fields only.",
            "default": true
          },
          "descriptionFormat": {
            "title": "📝 Description",
            "enum": [
              "text",
              "html",
              "both",
              "none"
            ],
            "type": "string",
            "description": "The full job description is included at no extra cost.",
            "default": "text"
          },
          "onlyNewJobs": {
            "title": "🔔 Only new jobs (job alert)",
            "type": "boolean",
            "description": "Remembers the jobs of earlier runs with the same alert name and returns only new ones, newest first. Schedule the Actor daily for an iimjobs job alert to Slack, email or a sheet. Jobs already seen are free.",
            "default": false
          },
          "monitorName": {
            "title": "🏷️ Alert name",
            "type": "string",
            "description": "Separate memory for each alert: use a different name for each search you schedule.",
            "default": "default"
          },
          "maxConcurrency": {
            "title": "⚡ Parallel requests",
            "minimum": 1,
            "maximum": 30,
            "type": "integer",
            "description": "How many iimjobs requests run at once.",
            "default": 10
          },
          "debugLog": {
            "title": "🐞 Debug log",
            "type": "boolean",
            "description": "Log every retry.",
            "default": 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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}