# Instahyre Jobs Scraper - Company Ratings, Recruiters & Emails (`topapi/instahyre-jobs-scraper`) Actor

Scrape Instahyre jobs in India: title, company, cities, skills, experience, full description, recruiter, stipend, company Glassdoor ratings, website and tech stack, employer emails. Every site filter, links or ids, newest first, monitor mode, company tracker. $0.94 per 1,000 jobs.

- **URL**: https://apify.com/topapi/instahyre-jobs-scraper.md
- **Developed by:** [Top Api](https://apify.com/topapi) (community)
- **Categories:** Jobs, Lead generation, Automation
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.94 / 1,000 jobs

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

### What does Instahyre Jobs Scraper do?

**Instahyre Jobs Scraper** exports Instahyre jobs in India to JSON, CSV or Excel, with no Instahyre account and no cookies.
Each row is one job: title, company, cities and state, skills, experience range, the full description, job category
and functions, the recruiter (name, designation, their company and whether it is a staffing agency), the internship
stipend, and the hiring company's profile with its **Glassdoor ratings**, website, LinkedIn, tech stack, benefits and
open jobs. Optional **employer contacts** read the company's own website for emails and phone numbers.

Also called: Instahyre API, Instahyre jobs API, Instahyre job scraper, India tech jobs scraper.

- Search like on instahyre.com: keyword, city, years of experience, job function and category, industry, company size,
  job type and company. **Instahyre applies these filters itself**, so the counts are exact and runs are fast.
- Paste links: search pages, landing pages (`/python-jobs-in-bangalore/`), company pages (`/jobs-at-zepto/`), single jobs, or job ids.
- **Newest first**, **only new jobs** on a schedule (monitor mode with new, updated and removed jobs), a **company hiring tracker**,
  and alerts to Slack, Discord, Teams, Telegram, ntfy, WhatsApp or a webhook.
- Reads past Instahyre's 10,000-jobs-per-search limit: the whole board (13,006 jobs on 2026-11-06) in one run.

### What data can you get from Instahyre?

| Job | Company (free, on by default) | Recruiter and details |
|---|---|---|
| 💼 Title, job id, link | ⭐ Glassdoor rating and 6 sub-ratings | 👤 Recruiter name and designation |
| 🏙️ Cities, state, remote / hybrid / on-site | 🌐 Website, LinkedIn, X, Facebook, Instagram, apps | 🏢 Recruiter's company, agency flag |
| 🛠️ Skill tags | 🧰 Tech stack, benefits, industry | 📝 Full description (text, HTML or Markdown) |
| 🎓 Experience range (years) | 👥 Size group, employee band, founded | 🗂️ Job category and functions |
| 🌍 Accepts other cities | 📍 Office locations, about, why join, interview process | 💰 Internship stipend and duration |
| 🏷️ Diversity / featured employer badges | 📊 Open jobs on Instahyre | ✅ Open or closed |

Measured on a 1,000-job run on 2026-11-06 (`software engineer`, 536 companies): title, company, cities, skills,
experience range, category, functions, description 100%; recruiter 92.1%; company website 99.1%, LinkedIn 92.9%,
Glassdoor rating 66.7%, tech stack 70.0%, benefits 59.7%, office photos 66.2%, why join 79.0%, interview process 21.8%.
Internship stipend: every paid internship in a 5-internship sample. With employer contacts on, 15 of 37 companies'
websites gave an email (41%) and 12 of 34 in a second run (35%).

**Not in the rows: the posting date.** Instahyre shows it only on its job pages, which this actor cannot read (a
Cloudflare browser check); its search and job APIs have no date. Use **Newest first** (Instahyre's job ids rise with
the posting date) or **Only new jobs** on a schedule. Instahyre publishes no salary for full-time jobs.

### How to scrape Instahyre with Instahyre Jobs Scraper

1. Type keywords (one search each) and, if you like, cities and filters.
2. Leave **Job details** and **Company profile** on for the full row, or turn them off for the search fields only.
3. Click **Start**, then download the jobs as JSON, CSV, Excel or HTML, or read them through the API.

### ⬇️ Input

| Input | What it does |
|---|---|
| `searchQueries` | Keywords (python, react, data analyst, product manager). Each is one Instahyre search; Instahyre matches titles and skills. Empty = all jobs matching the filters, or the whole board. |
| `locations` | Cities, states or regions as on Instahyre: Bangalore (or Bengaluru), Pune, Gurgaon (or Gurugram), Delhi / NCR, Karnataka (its cities), South India, Anywhere in India, Work From Home. Several = any. |
| `startUrls` | Instahyre links: search pages, landing pages, company pages, single jobs. The filters below are added to search links. |
| `jobIds` | Job numbers, e.g. 443990. |
| `companies` | Only these companies (Amazon, Accenture, Zepto). A near-miss is matched against Instahyre's own company list. |
| `experienceYears` | Jobs open to this many years of experience; 0 = jobs for freshers. |
| `jobFunctions`, `jobCategories`, `industries` | Instahyre's functions (Backend Development, DevOps / Cloud ...), categories (Software Engineering ...) and industries, by name, slug or id. |
| `jobType`, `companySize`, `remoteOnly` | Full-time or internship; small / medium / large; Work From Home only. |
| `sortBy` | `relevance` (Instahyre's order) or `newest` (highest job id first). |
| `titleInclude`, `titleExclude`, `titleMustMatchKeyword` | Title words to keep or drop; keep only titles that carry every word of the keyword. |
| `skills` + `skillMatch`, `keywords` + `keywordMatch`, `excludeKeywords` | Skill-tag and text filters (any / all). Alone, skills or keywords are also the search. |
| `companyExclude`, `excludeAgencyPosted`, `diversityEmployersOnly`, `featuredEmployersOnly`, `minCompanyRating`, `skipDuplicates` | Company and quality filters. Reposts (same title, company and cities) are skipped by default. |
| `includeDetails` | Description, experience, category, functions, recruiter, agency flag, stipend, open or closed. On by default. |
| `includeCompanyProfile` | Ratings, website and socials, tech stack, benefits, industry, about, open jobs. On by default, free. |
| `enrichEmails`, `withEmailOnly` | Employer contacts from the company's own website; keep only jobs whose company gave an email. |
| `descriptionFormat`, `descriptionMaxLength` | text, html, markdown, both, all or none; a length cap. |
| `monitorMode`, `monitorStoreName`, `emitBaseline`, `includeUpdated`, `includeUnchanged`, `includeRemoved`, `resetMonitor` | Only new jobs per named monitor; what the first run does; changed, unchanged and removed jobs. |
| `trackCompanies` | Company hiring tracker instead of jobs (one row per company). |
| `marketSnapshot` | Instahyre's own counts per search into the MARKET_SNAPSHOT record. |
| `maxItems`, `maxItemsPerSearch`, `maxPages`, `splitLargeSearches`, `maxConcurrency` | Row caps (default 50), pages per search, reading past 10,000, parallel requests. |
| Alerts | `slackWebhookUrl`, `discordWebhookUrl`, `teamsWebhookUrl`, `telegramToken` + `telegramChatId`, `ntfyTopic`, `whatsappAccessToken` + `whatsappPhoneNumberId` + `whatsappTo`, `webhookUrl`, `notificationLimit`. |
| `proxyConfiguration` | Not needed (see Speed and limits). |

Input names of other Instahyre actors work too (`keywords`, `cities`, `companyNames`, `jobFunctionSlugs`, `maxJobs`,
`stateName`, `monitoringMode`, `onlyNewJobs`, `includeJobDetails`).

#### Input JSON

```json
{
  "searchQueries": ["python", "data engineer"],
  "locations": ["Bangalore", "Pune"],
  "experienceYears": 3,
  "companySize": "large",
  "minCompanyRating": 4,
  "maxItems": 200
}
```

#### Put one idea per keyword

Instahyre's search matches titles and skill tags, so `python` also brings Backend Engineer jobs that list Python. Turn
on **Title must match the keyword** for titles only, or add **Title must contain** words.

#### Paste a link when you already searched on the site

A link such as `https://www.instahyre.com/search-jobs/?skills=Python&location=Pune&years=3` or
`https://www.instahyre.com/python-jobs-in-bangalore/` is read with its own filters, plus any filters you set here.

### ⬆️ Output

A real row from the 2026-11-06 test run (some fields shortened):

```json
{
  "jobId": "445674",
  "title": "Senior Software Engineer",
  "companyName": "InCred Financial Services",
  "locations": ["Bangalore"], "states": ["Karnataka"], "workplaceType": "on-site",
  "skills": ["Node.js", "Backend Engineer", "MongoDB", "NodeJS", "Senior Software Engineer", "Software Engineer"],
  "experienceLevel": "3-5 years", "experienceMin": 3, "experienceMax": 5,
  "jobCategory": "Software Engineering", "jobFunctions": ["Backend Development"], "jobType": "full_time", "isActive": true,
  "recruiterDesignation": "Technical Recruiter", "recruiterCompanyName": "Success Pact", "isAgencyPosted": true,
  "companySize": "large", "employeeCount": 1000, "companyFounded": 2016, "companyOpenJobs": 18,
  "companyRating": 4.1,
  "companyRatings": { "overall": 4.1, "cultureValues": 4, "workLifeBalance": 4, "compensationBenefits": 3.8, "careerOpportunities": 4, "diversityInclusion": 4, "recommendToFriend": 4 },
  "companyWebsite": "https://www.incred.com/",
  "companyIndustry": "Banking / Financial Services",
  "publicUrl": "https://www.instahyre.com/job-445674-senior-software-engineer-at-incred-financial-services-bangalore/",
  "description": "Responsibilities:\n\n- Design, develop, and maintain RESTful APIs and microservices using Node.js ..."
}
```

#### Fields

| Group | Fields |
|---|---|
| Job | `jobId`, `title`, `candidateTitle`, `publicUrl` (`jobUrl`, `applyUrl`, `applyType`), `resourceUri`, `skills`, `acceptOutstation` |
| Place | `locations`, `locationsRaw`, `location`, `states`, `isRemote`, `workplaceType` (remote, hybrid, on-site) |
| Company (search) | `companyName`, `companyId`, `companyResourceUri`, `companyLogoUrl`, `companyTagline`, `companyFounded`, `employeeCount`, `companySize`, `companyNote`, `companyNoteShort`, `isDiversityEmployer`, `isFeaturedEmployer` |
| Details | `description`, `descriptionHtml`, `descriptionMarkdown`, `experienceMin`, `experienceMax`, `experienceLevel`, `jobCategory`, `jobFunctions`, `jobFunctionCategories`, `jobType`, `employmentType`, `isActive`, `isClosed`, `recruiterName`, `recruiterDesignation`, `recruiterCompanyName`, `recruiterProfileUrl`, `isAgencyPosted`, `agencyFunctionNames`, `detailStatus`, `detailError` |
| Internship | `internshipStipend` (INR a month), `internshipPaid`, `internshipDurationMonths`, `internshipStartDate`, `salaryText`, `salaryMin`, `salaryMax`, `salaryCurrency`, `salaryPeriod`, `salaryYearlyMin`, `salaryYearlyMax` |
| Company profile | `companyUrl`, `companySlug`, `companyRating`, `companyRatings`, `companyWebsite`, `companyLinkedin`, `companyFacebook`, `companyTwitter`, `companyInstagram`, `companyAndroidApp`, `companyIosApp`, `companyBenefits`, `companyTechStack`, `companyIndustry`, `companyIndustries`, `companyLocations`, `companyHeadquarters`, `companyAbout`, `companyWhyUs`, `companyInterviewProcess`, `companyOpenJobs`, `companyMediaCoverage`, `companyOfficePhotos` |
| Employer contacts | `employerEmail`, `employerEmailKind` (hr, sales, support, general, personal, other), `employerEmailDomain`, `employerEmailSourceUrl`, `employerEmails`, `employerPhones`, `employerSocials`, `emailEnrichmentStatus` |
| Monitor | `changeType` (new, updated, unchanged, removed, details), `firstSeenAt`, `lastSeenAt`, `contentHash`, `removedReason` |
| Search | `searchQuery`, `searchLocation`, `searchUrl`, `source`, `scrapedAt` |

Tracker rows (`trackCompanies`, `type: "company"`): `openRoles`, `openRolesDelta`, `functionBreakdown`, `functionsStarted`,
`functionsStopped`, `locationBreakdown`, `locationsOpened`, `locationsClosed`, `skillBreakdown`, `remoteShare`,
`remoteShareDelta`, `jobTypeBreakdown`, `experienceLevels`, `newJobIds`, `closedJobIds`, `firstTrackedAt`,
`lastTrackedAt` and the company profile. Five table views: Overview, Job details, Companies and contacts, Monitoring,
Company hiring tracker.

### How much does it cost to scrape Instahyre?

Pay per event, no subscription, no start fee:

| Event | Price |
|---|---|
| Job (a row) | $0.94 per 1,000 |
| Job details (per job that gets them, on by default) | $0.09 per 1,000 |
| Employer contacts (once per company whose website gave an email) | $0.036 |
| Tracked company (tracker row) | $0.94 per 1,000 |

1,000 jobs with details and company profiles = **$1.03**. Jobs removed by your filters, reposts, links that are not
found and jobs an earlier monitor run delivered are free. Set **Maximum cost per run** in the run options and the run
stops cleanly there (measured: a $0.02 limit delivered and charged 19 jobs).

### Run it on a schedule (only new jobs)

1. Set keywords and filters, turn on **Only new jobs** and give the monitor a name.
2. Save as a task and add an Apify **schedule** (every morning). Each run returns jobs it has not delivered before,
   newest first, plus changed jobs; turn on **Report removed jobs** to get closed jobs too.
3. Send them to Slack, Discord, Teams, Telegram, ntfy, WhatsApp or a webhook (Alerts section), or use Apify
   integrations (Google Sheets, Zapier, Make, n8n).

A poll reads the whole search (35 jobs a request) and delivers only what is new. Measured: an Accenture monitor
(439 jobs) baseline 42-57 s; the next poll with nothing new 3.5 s and $0.0001, nothing charged and nothing written.
The monitor's memory is kept in a dataset named after the monitor name and the search. A job delivered without job
details, employer contacts or the company profile comes again once, with them and `changeType: "details"`, when a later
run of the same monitor turns them on (charged like any job with them).

From the API: `POST https://api.apify.com/v2/acts/TopApi~instahyre-jobs-scraper/run-sync-get-dataset-items` with the
input as the body returns the jobs as JSON. AI agents can call it through the Apify MCP server.

### Speed and limits (measured 2026-11-06)

| Run | Rows | Time |
|---|---|---|
| python in Bangalore, 20 jobs, all defaults | 20 | 2-3 s |
| 3 keywords x 50 jobs | 150 | 5-32 s |
| software engineer, 1,000 jobs with details and profiles | 1,000 | 200-270 s |
| Anywhere in India, 2,500 jobs with details and profiles | 2,500 | 599 s |
| The whole board, search fields only | 13,006 | 431 s |

- Instahyre limits requests per address per minute (search ~100, details ~250, company profiles ~190). The actor stays
  under them on each egress, moves to the Apify datacenter proxy when Instahyre refuses it, and slows down after a
  refusal instead of failing. No proxy is needed.
- After about 2,000 job details from one address Instahyre locks it for minutes. The actor then delivers the next jobs
  at once without details (`detailStatus: rate_limited`, not charged for details) and tries again a minute later: in
  the 2,500-job run 2,428 jobs had details.
- Newest first and monitor polls read every page of the search (35 jobs a request). With filters Instahyre cannot apply
  (title words, rating, agency), a search is read only while the jobs found pay for its pages: a 4,403-job search with
  rare title words gave 33 jobs in about 400 s, and title words that match nothing stop after about 30 s, nothing charged.
- Instahyre shows 10,000 jobs per search; bigger searches are split by company size and job type.
- Memory: 256 MB by default; you can raise it to 512 MB (more does not make runs faster: they wait for Instahyre).

### FAQ

**Do I need an Instahyre account, cookies or an API key?** No. Only what any visitor can open is read.

**Why is there no posting date?** Instahyre puts it only on its job pages, which ask this actor's HTTP client for a
browser check. Sort by **Newest first** (job ids rise with the posting date) or use **Only new jobs**.

**Where do the ratings come from?** From the company's Instahyre page, which shows its Glassdoor ratings. About two in
three companies have them; **Min company rating** removes the rest for free.

**Is a job posted by an agency?** `isAgencyPosted` is true when the recruiter's own company is not the employer
(Success Pact, Talent500, Zyoin ... in the test run). **Skip jobs posted by agencies** removes them.

**Where do employer emails come from?** From the company's own website as Instahyre lists it: the home page and up to
three contact or about pages. Instahyre itself publishes no recruiter email.

**Why did my run return no results?** The status line says why: no jobs match (try a broader keyword or fewer
filters), your filters removed every job, or a location Instahyre does not know (it lists what it ignored).

### Other TopApi job actors

- [Indeed Jobs Scraper](https://apify.com/topapi/indeed-jobs-scraper) - Indeed in every country, India included.
- [Naukrigulf Jobs Scraper](https://apify.com/topapi/naukrigulf-jobs-scraper) - Gulf jobs, salaries and recruiters.
- [Welcome to the Jungle Jobs Scraper](https://apify.com/topapi/welcome-to-the-jungle-jobs-scraper) - jobs and company profiles.
- [XING Jobs Scraper](https://apify.com/topapi/xing-jobs-scraper) - jobs in Germany, Austria and Switzerland.
- [All TopApi actors](https://apify.com/topapi)

# Actor input Schema

## `searchQueries` (type: `array`):

Skill, job title or technology, one per line: python, react, data analyst, devops, product manager. Each keyword is one Instahyre search (Instahyre matches titles and skills). Empty = every job matching the filters below, or the whole board (about 13,000 jobs). API aliases: keywords, query.

## `locations` (type: `array`):

Cities, states or regions as Instahyre names them: Bangalore (or Bengaluru), Pune, Hyderabad, Gurgaon (or Gurugram), Noida, Mumbai, Chennai, Delhi / NCR, Karnataka, South India, Anywhere in India, Work From Home. Instahyre filters by them itself; several = any of them. Empty = all of India. API aliases: cities, city.

## `startUrls` (type: `array`):

Instahyre links: search pages (instahyre.com/search-jobs/?skills=Python), landing pages (instahyre.com/python-jobs-in-bangalore/, /jobs-in-pune/, /internships-in-bangalore/, /work-from-home-react-jobs/), company pages (instahyre.com/jobs-at-zepto/) or single jobs (instahyre.com/job-443990-...). The filters below are added to search links. API aliases: searchUrls, jobUrls.

## `jobIds` (type: `array`):

Instahyre job numbers, e.g. 443990 (the number in the job link).

## `companies` (type: `array`):

Only jobs of these companies, name as on Instahyre: Amazon, Accenture, Zepto. A name Instahyre does not know exactly is matched against its own company type-ahead (every word of your name). API alias: companyNames.

## `experienceYears` (type: `integer`):

Jobs open to a candidate with this many years of experience (Instahyre's own filter). 0 = jobs for freshers. Empty = any.

## `jobFunctions` (type: `array`):

Instahyre's job functions, by name, slug or id: Backend Development, frontend-development, Data Science / Machine Learning, DevOps / Cloud, Product Management, Software Testing / QA / SDET, Sales / Business Development. Several = any of them. API alias: jobFunctionSlugs.

## `jobCategories` (type: `array`):

Instahyre's broader groups of functions: Software Engineering, Data Science & Analytics, Product & Project Management, Design & Creative, Sales, Marketing, IT Operations, Operations, Human Resources, Customer Service, Accounting, Finance & Banking, Consulting, Hardware Engineering, Legal, Education & Training, General Management, Administration & Facilities.

## `industries` (type: `array`):

Industries as on Instahyre: Computer Software / IT / Internet, Banking / Financial Services, Management Consulting, Healthcare / Hospitals, E-Commerce... Several = any of them.

## `jobType` (type: `string`):

Full-time jobs, internships, or both (Instahyre's own filter).

## `companySize` (type: `string`):

Instahyre's own company-size groups.

## `remoteOnly` (type: `boolean`):

Only jobs Instahyre lists under Work From Home (with your locations: remote jobs of companies there). Every row has isRemote and workplaceType.

## `sortBy` (type: `string`):

Instahyre sorts by relevance only and keeps jobs listed for months. Newest first reads the whole search (35 jobs a request) and orders it by job id, which rises with the posting date.

## `titleInclude` (type: `array`):

Keep only jobs whose title contains one of these words, e.g. senior, lead.

## `titleExclude` (type: `array`):

Remove jobs whose title contains one of these words, e.g. intern, manager.

## `titleMustMatchKeyword` (type: `boolean`):

Instahyre's search also matches skills: python brings Backend Engineer jobs that list Python. On = only jobs whose title has every word of the keyword.

## `skills` (type: `array`):

Keep only jobs whose skill tags match, e.g. react, sql (partial match). Alone (no keywords) they are also the search.

## `skillMatch` (type: `string`):

Any: a job passes when one listed skill matches. All: every listed skill must match.

## `keywords` (type: `array`):

With keywords above: keep only jobs with these terms in the title, skills, company or location. Without keywords above: these are the search.

## `keywordMatch` (type: `string`):

Any: a job passes when one term matches. All: every term must match.

## `excludeKeywords` (type: `array`):

Remove jobs with any of these terms in the title, skills, company or location.

## `companyExclude` (type: `array`):

Remove jobs of companies whose name contains one of these, e.g. staffing agencies.

## `excludeAgencyPosted` (type: `boolean`):

Skip jobs whose recruiter works for another company than the employer (a staffing agency). Needs job details.

## `diversityEmployersOnly` (type: `boolean`):

Only jobs of employers Instahyre badges for diversity hiring.

## `featuredEmployersOnly` (type: `boolean`):

Only jobs of employers Instahyre features.

## `minCompanyRating` (type: `number`):

Keep jobs of companies rated at least this on Glassdoor (overall, 1-5, as Instahyre shows it), e.g. 4. Companies without a rating are removed. Removed jobs are free.

## `skipDuplicates` (type: `boolean`):

Companies often post one job several times: same title + company + cities = one row.

## `includeDetails` (type: `boolean`):

Full description, experience range, job category and functions, open or closed, recruiter name, designation and company, agency flag, internship stipend and duration. One request per job; charged as a job-details event per job that gets them.

## `includeCompanyProfile` (type: `boolean`):

The company's Glassdoor ratings (overall, culture, work-life balance, salary & benefits, career, diversity, recommend to a friend), website, LinkedIn and other links, benefits, tech stack, industry, about, why join, interview process and open jobs on Instahyre. One request per company, free.

## `enrichEmails` (type: `boolean`):

Read the company's own website (as Instahyre lists it) for contact emails, phone numbers and social profiles. Charged once per company whose website gave an email; no email, no charge.

## `withEmailOnly` (type: `boolean`):

With employer contacts: remove jobs whose company website gave no email (free).

## `descriptionFormat` (type: `string`):

How the full description is delivered (with job details on).

## `descriptionMaxLength` (type: `integer`):

Cut descriptions to this many characters (0 = full).

## `monitorMode` (type: `boolean`):

Remembers the jobs of earlier runs with the same search and monitor name and returns only new (and changed) ones, newest first. Jobs already delivered are free; a run with nothing new costs almost nothing. A job delivered earlier without the job details, employer contacts or company profile that a later run turns on comes again once with them, as changeType details (billed like any job).

## `monitorStoreName` (type: `string`):

Separate memory for each alert: use a different name for each search you schedule. API aliases: stateName, monitorStateName.

## `emitBaseline` (type: `boolean`):

On: the first monitor run delivers every current match. Off: it only remembers them (nothing charged) and later runs return what appears after it.

## `includeUpdated` (type: `boolean`):

Return jobs seen before whose title, company, cities or skills changed, as changeType updated.

## `includeUnchanged` (type: `boolean`):

Return every match on every run (changeType unchanged for jobs seen before). Billed like any job.

## `includeRemoved` (type: `boolean`):

After a full scan, one row (changeType removed) for each job of the last full scan that is gone, with removedReason closed or no longer in the search. Billed as a job.

## `resetMonitor` (type: `boolean`):

Forget the jobs remembered under this monitor name and start again.

## `trackCompanies` (type: `array`):

Company names to track instead of listing jobs: one row per company with open roles, function, location and skill mix, remote share and, from the second run, the change since the last run (roles opened and closed). The search fields above are ignored. Charged per company row.

## `marketSnapshot` (type: `boolean`):

Write Instahyre's own counts for each search (total jobs, top companies, locations, functions, industries, company sizes, job types, experience levels) to the MARKET_SNAPSHOT record. Free.

## `maxItems` (type: `integer`):

Jobs (or tracked companies) in total. 0 = no limit. API alias: maxJobs.

## `maxItemsPerSearch` (type: `integer`):

Per keyword or search link. API alias: maxJobsPerSearch.

## `maxPages` (type: `integer`):

Instahyre returns 35 jobs a page. Bounds how deep a search is read.

## `splitLargeSearches` (type: `boolean`):

Instahyre shows at most 10,000 jobs per search. On = a bigger search is read per company size (then job type) and merged without duplicates.

## `maxConcurrency` (type: `integer`):

How many Instahyre requests run at once (each egress stays under Instahyre's per-minute limits).

## `telegramToken` (type: `string`):

Bot token from @BotFather; with a chat id, each run sends its new jobs there.

## `telegramChatId` (type: `string`):

The chat (or channel) id that receives the alert.

## `slackWebhookUrl` (type: `string`):

Slack incoming-webhook URL for a message with the new jobs.

## `discordWebhookUrl` (type: `string`):

Discord webhook URL for a message with the new jobs.

## `teamsWebhookUrl` (type: `string`):

Microsoft Teams incoming-webhook URL for a message with the new jobs.

## `ntfyTopic` (type: `string`):

ntfy.sh topic for a push notification with the new jobs.

## `whatsappAccessToken` (type: `string`):

WhatsApp Cloud API access token (Meta) for a message with the new jobs.

## `whatsappPhoneNumberId` (type: `string`):

The sending WhatsApp Business phone number id.

## `whatsappTo` (type: `string`):

Recipient phone number with country code, e.g. 919812345678.

## `webhookUrl` (type: `string`):

POSTs { total, items, datasetUrl } as JSON.

## `notificationLimit` (type: `integer`):

How many jobs each alert lists (the count covers all of them).

## `proxyConfiguration` (type: `object`):

Not needed: Instahyre answers a direct connection, and the actor moves to the Apify datacenter proxy by itself when Instahyre rate-limits it. Set one only to send everything through your own proxy.

## Actor input object example

```json
{
  "searchQueries": [
    "python"
  ],
  "locations": [
    "Bangalore"
  ],
  "jobType": "any",
  "companySize": "any",
  "remoteOnly": false,
  "sortBy": "relevance",
  "titleMustMatchKeyword": false,
  "skillMatch": "any",
  "keywordMatch": "any",
  "excludeAgencyPosted": false,
  "diversityEmployersOnly": false,
  "featuredEmployersOnly": false,
  "skipDuplicates": true,
  "includeDetails": true,
  "includeCompanyProfile": true,
  "enrichEmails": false,
  "withEmailOnly": false,
  "descriptionFormat": "text",
  "monitorMode": false,
  "monitorStoreName": "instahyre-monitor",
  "emitBaseline": true,
  "includeUpdated": true,
  "includeUnchanged": false,
  "includeRemoved": false,
  "resetMonitor": false,
  "marketSnapshot": true,
  "maxItems": 20,
  "splitLargeSearches": true,
  "maxConcurrency": 10,
  "notificationLimit": 10,
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}
```

# Actor output Schema

## `results` (type: `string`):

One item per job (or per tracked company): title, company, cities, skills, experience, description, recruiter, stipend, company ratings and profile, employer contacts.

## `snapshot` (type: `string`):

Instahyre's own counts for each search: total jobs, top companies, locations, functions, industries, company sizes, job types and experience levels.

## `summary` (type: `string`):

Per-search counts (on Instahyre, read, delivered), filters, enrichment and egress (written for Console runs, large runs and runs with a problem).

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "searchQueries": [
        "python"
    ],
    "locations": [
        "Bangalore"
    ],
    "maxItems": 20,
    "proxyConfiguration": {
        "useApifyProxy": false
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("topapi/instahyre-jobs-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "searchQueries": ["python"],
    "locations": ["Bangalore"],
    "maxItems": 20,
    "proxyConfiguration": { "useApifyProxy": False },
}

# Run the Actor and wait for it to finish
run = client.actor("topapi/instahyre-jobs-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "searchQueries": [
    "python"
  ],
  "locations": [
    "Bangalore"
  ],
  "maxItems": 20,
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}' |
apify call topapi/instahyre-jobs-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,topapi/instahyre-jobs-scraper"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/DsucTBjB3AKR2ArZf/builds/SpjVYSPxiIzdjHANX/openapi.json
