{
  "openapi": "3.0.1",
  "info": {
    "title": "Hirist Jobs Scraper & API: Recruiter Activity, Applicants",
    "description": "Scrape hirist.tech jobs in India with recruiter activity on every job: applications, views, recruiter actions and last active date. Every job of a skill, whole board, newest first, AmbitionBox ratings, job alerts. Excel, CSV, JSON.",
    "version": "0.1",
    "x-build-id": "ctjUa8QAeZ40qwztP"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/s_actors~hirist-jobs-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-s_actors-hirist-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/s_actors~hirist-jobs-scraper/runs": {
      "post": {
        "operationId": "runs-sync-s_actors-hirist-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/s_actors~hirist-jobs-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-s_actors-hirist-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": "🔎 Skills or keywords",
            "type": "array",
            "description": "Skill, technology or job title, one per line: \"python\", \"react\", \"java\", \"devops\", \"data engineer\", \"machine learning\". A Hirist skill returns every job tagged with it (python: about 8,500 jobs; Hirist's own search box finds about 900); anything else is a Hirist title search. Empty = every job of the categories below, or the whole Hirist board (about 27,000 jobs).",
            "items": {
              "type": "string"
            }
          },
          "locations": {
            "title": "📍 Locations",
            "type": "array",
            "description": "City, state or country as on Hirist: \"Bangalore\" (or Bengaluru), \"Pune\", \"Hyderabad\", \"Delhi NCR\", \"Gurgaon\", \"Noida\", \"Mumbai\", \"Chennai\", \"Kolkata\", \"Remote\", \"Dubai\". Hirist filters by them itself; several = any of them. Empty = everywhere.",
            "items": {
              "type": "string"
            }
          },
          "categories": {
            "title": "🗂️ Categories",
            "type": "array",
            "description": "Hirist's categories: \"Backend Development\", \"Frontend Development\", \"Full Stack\", \"Mobile Applications\", \"AI/ML\", \"Data Engineering\", \"Data Analytics & BI\", \"DevOps / SRE\", \"Quality Assurance\", \"CyberSecurity\", \"Platform Engineering / SAP/Oracle\", \"Emerging Technologies\". 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 Hirist'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": "Hirist'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 Hirist 1,000 jobs a request, so large pulls are fast.",
            "default": 100
          },
          "sortBy": {
            "title": "↕️ Order",
            "enum": [
              "hirist",
              "newest"
            ],
            "type": "string",
            "description": "Newest first = the Actor reads the whole search and orders it by the posting time.",
            "default": "hirist"
          },
          "recruiterActiveWithinDays": {
            "title": "🟢 Recruiter active within (days)",
            "minimum": 0,
            "maximum": 365,
            "type": "integer",
            "description": "Keep jobs whose recruiter logged in to Hirist 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 (\"Recruiter actions\" on the job page is above 0). 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": "Hirist 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 Hirist), 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). Most Hirist recruiters hide it.",
            "default": false
          },
          "keywordMatch": {
            "title": "🧩 Keyword match",
            "enum": [
              "skill",
              "title"
            ],
            "type": "string",
            "description": "Skill = every job tagged with the skill; a keyword that is not a skill falls back to the title search.",
            "default": "skill"
          },
          "titleMustMatchKeyword": {
            "title": "🎯 Title must contain the keyword",
            "type": "boolean",
            "description": "On = only jobs whose title has every word of the keyword (\"python\" drops a \"Backend Engineer\" job that asks for Python). 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\", \"manager\".",
            "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": "🔗 Hirist listing links",
            "type": "array",
            "description": "Pages such as hirist.tech/k/python-jobs (skill), hirist.tech/c/ai-ml-jobs (category), hirist.tech/search/data-engineer, with their loc and posting filters.",
            "items": {
              "type": "string"
            }
          },
          "recruiterUrls": {
            "title": "🔗 Hirist recruiter links",
            "type": "array",
            "description": "Recruiter profiles, e.g. https://www.hirist.tech/r/180511-talent-bridge-bangalore.html: all their open jobs (Talent Bridge = Hirist's hiring drives).",
            "items": {
              "type": "string"
            }
          },
          "jobUrls": {
            "title": "🔗 Hirist job links",
            "type": "array",
            "description": "Links of single jobs, e.g. https://www.hirist.tech/j/flatworld-agentic-ai-engineer-aiml-1675409, or just the number 1675409.",
            "items": {
              "type": "string"
            }
          },
          "includeJobDetails": {
            "title": "📄 Job page data",
            "type": "boolean",
            "description": "Recruiter activity (applications, views, recruiter actions, last active), recruiter name, 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 a Hirist 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 Hirist 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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}