# InHerSight Scraper (`solidcode/inhersight-com-scraper`) Actor

\[💰 $1.7 / 1K] Extract women's workplace ratings and anonymous employee reviews from InHerSight. Get overall scores, 16 rating categories (pay, PTO, flexibility, leave), awards, industry rankings, HQ, size, and review text. Search by name, browse Best Companies lists, or paste URLs.

- **URL**: https://apify.com/solidcode/inhersight-com-scraper.md
- **Developed by:** [SolidCode](https://apify.com/solidcode) (community)
- **Categories:** Automation, Developer tools
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.70 / 1,000 results

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

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

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
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.
Actors are written with capital "A".

## 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.
The best way to integrate Actors is as follows.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).

# README

## InHerSight Scraper

Pull company ratings and anonymous employee reviews from InHerSight at scale — overall scores, 16 rating categories rated by women employees, five grouped score dimensions, monthly award badges, industry and size rankings, and full written review text with satisfaction scores. Built for DEI and people-analytics teams, employer-brand agencies, and talent-market researchers who need women's workplace-experience data as a clean structured dataset instead of clicking through hundreds of company profiles one at a time.

### Why This Scraper?

- **16 rating categories rated by women employees** — Salary Satisfaction, Paid Time Off, Flexible Work Hours, Ability to Telecommute, Maternity and Adoptive Leave, Family Support, Wellness Initiatives, Learning Opportunities, Sponsorship and Mentorship, Management Opportunities for Women, Equal Opportunities for Women and Men, Female Representation in Leadership, Sense of Belonging, Company Culture, The People You Work With, and Employer Responsiveness — each with an average score, a weighted score, and submission counts.
- **Five grouped score dimensions plus a score trend** — Opportunity, Schedule & Flexibility, Enrichment, Family, and Culture roll the 16 categories into comparable indices, and every company carries an `increasing` / `decreasing` trend flag on its headline score.
- **Full anonymous review text, not just star counts** — each review ships as its own row with the written comment, a satisfaction score and label ("Very satisfied"), the reviewer's job level, reply count, and the date it was posted. Walmart alone has 866 reviews on file.
- **Deep, duplicate-free review pagination** — verified pulling 250 unique reviews from a single company in three passes with zero repeats and zero gaps, and `maxReviewsPerCompany: 0` collects every review a company has (up to 1,000).
- **Awards and per-category rankings** — Microsoft returned 2 award badges and 54 ranking rows in testing: each rating category ranked separately within its industry group, its narrow industry, and its company-size band, with rank and total ("#55 of 178").
- **Five multiple-choice survey polls per company, with the vote split** — "Do the dads and non-birth parents here have access to sufficient parental leave?" comes back with each answer option, its vote count, and its share of respondents (68% yes / 6% no / 26% don't know), so you get percentages rather than prose.
- **Roughly 185 curated Best Companies lists as a discovery surface** — browse 16 industry groups, 16 rating categories, 43 US states, 99 US cities, and 3 company-size bands, or paste any of the 114 narrower industry list URLs directly.
- **Rating threshold applied before any company is opened** — about 95% of InHerSight's 77,320-company directory is unrated shells, so `minRating` screens them out on the listing entry and you never pay to collect an empty profile.
- **Fast enough for interactive work** — one company's complete 866-review history comes back in about 20 seconds, and a default run (20 companies plus 168 reviews) finishes in well under a minute.

### Use Cases

**DEI Benchmarking & People Analytics**

- Benchmark your employer's maternity leave, flexible hours, and salary satisfaction scores against named competitors
- Track a company's score trend month over month to see whether women's sentiment is improving
- Compare the five grouped dimensions across an industry to find where your sector consistently underperforms

**Employer Brand & Talent Marketing**

- Pull every award badge and ranking a company holds to validate or challenge its employer-brand claims
- Find which rating category a company ranks highest in and build recruitment messaging around it
- Monitor the Best Companies lists your competitors appear on each month

**Recruitment & Candidate Research**

- Build a shortlist of top-rated employers for women in a specific city or state
- Surface employers that lead on maternity leave, telecommuting, or sponsorship and mentorship
- Screen an offer shortlist by reading the actual written reviews from senior-level women

**Market & Investment Research**

- Score public companies (ticker included) on workplace-culture signals for ESG models
- Compare small, medium, and large employers within the same industry group
- Quantify sentiment shifts across a sector using satisfaction scores from thousands of reviews

**Content, Journalism & Report Building**

- Source quotable, attributable review text for workplace and gender-equity reporting
- Build "best companies for women in X" rankings backed by category-level data
- Produce annual state-of-the-workplace reports from multi-state, multi-industry pulls

### Getting Started

#### Simplest run — the current top-rated employers

Leave everything blank and you get InHerSight's live Best Companies list.

```json
{}
```

#### Named companies with their reviews

```json
{
  "startUrls": [
    "https://www.inhersight.com/company/microsoft/ratings",
    "https://www.inhersight.com/company/salesforce/ratings"
  ],
  "includeAwards": true,
  "maxReviewsPerCompany": 50
}
```

#### Browse by industry, location, and rating category

```json
{
  "industries": ["technology", "health"],
  "locations": ["Boston, MA", "Massachusetts"],
  "reviewCategories": ["maternity_leave", "flexible_hours"],
  "minRating": "4.0",
  "maxResults": 100
}
```

#### Everything on — full detail, deep reviews

```json
{
  "searchTerms": ["credit union"],
  "companySizes": ["large"],
  "minRating": "3.5",
  "includeRatingBreakdown": true,
  "includeAwards": true,
  "includeSurveyQuestions": true,
  "includeReviews": true,
  "maxReviewsPerCompany": 0,
  "maxResults": 250
}
```

### Input Reference

#### What to Scrape

| Parameter | Type | Default | Description |
|-----------|------|---------|-------------|
| `startUrls` | array | `[]` | InHerSight URLs. Accepts company profiles (`/company/microsoft/ratings`) and Best Companies lists (`/companies/best`, `/companies/best/industry/computer-software`, `/companies/best/state/massachusetts-us`, `/companies/best/city/boston-ma`, `/companies/best/size/large`, `/companies/best/reviews/paid-time-off`). List URLs expand into the companies they rank. |
| `searchTerms` | array | `[]` | Company names or keywords such as `Salesforce`, `hospital`, or `credit union`. Each term is searched separately and returns up to 50 matching companies. |

#### Browse Best Companies

The overall Best Companies list publishes 50 employers; every other list publishes 20. These are InHerSight's own ranking lengths, so a single selection cannot return more than that no matter how high `maxResults` is set — the run log says so when a list hits its ceiling.

| Parameter | Type | Default | Description |
|-----------|------|---------|-------------|
| `industries` | array | `[]` | One or more of 16 industry groups: Art, Construction, Consumer Goods, Corporate, Education, Finance, Government, Health, Legal, Manufacturing, Media, Organization, Recreation, Service, Technology, Transportation. For one of the 114 narrower industries, paste that list URL into `startUrls`. Each of these lists is published as a top-20 ranking, so one selection returns at most 20 companies — combine several to collect more. |
| `reviewCategories` | array | `[]` | Scrape the Best Companies list for any of the 16 rating categories — for example `maternity_leave`, `paid_time_off`, `salary`, `telecommute`, `leadership_diversity`, `wellness_benefits`. Each of these lists is published as a top-20 ranking, so one selection returns at most 20 companies — combine several to collect more. |
| `companySizes` | array | `[]` | `small`, `medium`, or `large`. Each of these lists is published as a top-20 ranking, so one selection returns at most 20 companies — combine several to collect more. |
| `locations` | array | `[]` | US cities or states, written naturally: `Boston, MA`, `Chicago`, `MA`, or `Massachusetts`. InHerSight publishes lists for 99 cities and 43 states; unmatched entries are skipped and named in the run log. Each of these lists is published as a top-20 ranking, so one selection returns at most 20 companies — combine several to collect more. |

#### Filters & Company Detail

| Parameter | Type | Default | Description |
|-----------|------|---------|-------------|
| `minRating` | string | `"any"` | Minimum overall InHerSight score: Any company (including unrated), Rated companies only, 3.0 and above, 3.5 and above, 4.0 and above, or 4.5 and above. Checked on the listing entry first, so filtered-out companies cost you nothing. Companies you name in `startUrls` are always collected. |
| `includeRatingBreakdown` | boolean | `true` | Adds the 16 rating categories plus the five grouped scores and the score trend to every company. |
| `includeAwards` | boolean | `false` | Adds monthly award badges — including state and city Best Companies placements — plus each company's rank within its broad industry group, its narrow industry, and its company-size band. |
| `includeSurveyQuestions` | boolean | `false` | Adds the multiple-choice survey polls answered by women who worked at the company, each with every answer option, its vote count, and the share of respondents who chose it. |

#### Employee Reviews

| Parameter | Type | Default | Description |
|-----------|------|---------|-------------|
| `includeReviews` | boolean | `true` | Adds anonymous written reviews from women who worked at the company. Each review is returned as its own row. Turning it off also leaves `reviewCount` blank, since that total comes from the reviews themselves. |
| `maxReviewsPerCompany` | integer | `10` | Reviews per company, newest first. Set to `0` for every available review — a safety limit of 1,000 per company still applies. Ignored when reviews are off. |

#### Limits

| Parameter | Type | Default | Description |
|-----------|------|---------|-------------|
| `maxResults` | integer | `20` | Maximum number of *companies* across everything you asked for. Review rows are returned on top of this number. Set to `0` for no limit — a safety limit of 50,000 companies still applies. |

### Output

Every row carries a `recordType` field so you can split companies from reviews in one pass.

#### Company rows (`recordType: "company"`)

```json
{
  "recordType": "company",
  "companyId": 2050,
  "companyUuid": "046d5fcb-8af9-47c4-8b63-383a9d9dde0e",
  "name": "PayPal",
  "slug": "paypal",
  "profileUrl": "https://www.inhersight.com/company/paypal/ratings",
  "score": 4.4,
  "ratingCount": 1861,
  "participantCount": 121,
  "reviewCount": 20,
  "topCompany": true,
  "underReview": false,
  "industry": "Internet",
  "industryGroup": "Technology",
  "companyType": "Public Company",
  "headquarters": "San Jose, CA",
  "otherLocations": ["Boston, MA", "Austin, TX", "New York City, NY"],
  "employeeCount": "10000+",
  "companySize": "large",
  "websiteUrl": "http://www.paypal.com",
  "ticker": "PYPL",
  "logoUrl": "https://ucare.inhersight.com/6805f9e4-8b3a-4648-b05b-6d3928f67bcf/",
  "briefOverview": "PayPal is an internet company headquartered in the San Jose, CA area with 10000+ employees.",
  "jobsUrl": "/company/paypal/jobs",
  "hasIndeedJobs": false,
  "sourceType": "bestCompaniesList",
  "sourceList": "Best Companies to Work For",
  "listRank": 8,
  "scoreTrend": "increasing",
  "scrapedAt": "2026-08-01T15:25:58.294209+00:00",
  "ratingBreakdown": [
    {
      "categorySlug": "telecommute",
      "categoryName": "Ability to Telecommute",
      "averageScore": 3.0,
      "weightedAverageScore": 4.9,
      "submissions": 117,
      "participants": 117,
      "question": "How satisfied are you with your ability to work from home or another remote location as needed?",
      "description": "Flexibility to work remotely"
    }
  ],
  "ratingGroups": [
    {
      "groupSlug": "schedule",
      "groupName": "Schedule & Flexibility",
      "categories": ["paid_time_off", "flexible_hours", "telecommute"],
      "averageScore": 3.5,
      "weightedAverageScore": 4.7,
      "percent": 70.6
    }
  ],
  "surveyQuestions": [
    {
      "questionId": 390,
      "questionType": "Multiple choice",
      "question": "Do the dads and non-birth parents at this company have access to sufficient parental leave and the support and encouragement to take it?",
      "ratingGroupSlug": "rg-family",
      "ratingGroupName": "Family",
      "responseCount": 72,
      "voteCount": 72,
      "options": [
        { "answer": "Yes", "order": 1, "primary": true, "voteCount": 49, "percentage": 68.0 },
        { "answer": "No", "order": 2, "primary": false, "voteCount": 4, "percentage": 6.0 },
        { "answer": "I don't know", "order": 3, "primary": false, "voteCount": 19, "percentage": 26.0 }
      ]
    }
  ]
}
```

##### Core Fields

| Field | Type | Description |
|-------|------|-------------|
| `recordType` | string | Always `"company"` for these rows |
| `companyId` | integer | InHerSight's numeric company id |
| `companyUuid` | string | Stable UUID for the company |
| `name` | string | Company name |
| `slug` | string | URL slug, e.g. `paypal` |
| `profileUrl` | string | Full URL of the company's ratings page |
| `score` | number | Overall InHerSight score out of 5 |
| `ratingCount` | integer | Number of individual category ratings submitted |
| `participantCount` | integer | Number of women who rated the company |
| `reviewCount` | integer | Number of written reviews available |
| `topCompany` | boolean | Whether the company currently holds a Best Companies placement |
| `underReview` | boolean | Whether InHerSight has flagged the profile as under review |
| `scoreTrend` | string | `increasing` or `decreasing` — direction of the headline score |
| `scrapedAt` | string | ISO 8601 timestamp of collection |

##### Company Profile

| Field | Type | Description |
|-------|------|-------------|
| `industry` | string | Narrow industry, e.g. `Internet` |
| `industryGroup` | string | One of the 16 broad groups, e.g. `Technology` |
| `companyType` | string | e.g. `Public Company`, `Privately Held`, `Nonprofit` |
| `headquarters` | string | HQ city and state |
| `otherLocations` | array | Additional offices, as city/state strings |
| `employeeCount` | string | Headcount band, e.g. `10000+` |
| `companySize` | string | `small`, `medium`, or `large` |
| `fullyRemote` | boolean | Whether the employer is fully remote |
| `websiteUrl` | string | Company website |
| `ticker` | string | Stock ticker for public companies |
| `logoUrl` | string | Company logo image |
| `briefOverview` | string | One-line company summary |
| `shortDescription` | string | Longer company description |
| `jobsUrl` | string | Path to the company's job listings on InHerSight |
| `hasIndeedJobs` | boolean | Whether third-party job listings are attached |

##### Where the Company Came From

| Field | Type | Description |
|-------|------|-------------|
| `sourceType` | string | `bestCompaniesList`, `search`, or `startUrl` |
| `sourceList` | string | Human-readable source label, e.g. `Best Companies in Boston, MA` or `Search: "salesforce"`. A company appearing on several of your selected lists is returned once, labelled with the first list it was found on |
| `listRank` | integer | Position in that list — meaningful only relative to `sourceList` |

##### Ratings, Awards & Rankings

Present when `includeRatingBreakdown` / `includeAwards` are on.

| Field | Type | Description |
|-------|------|-------------|
| `ratingBreakdown[]` | array | 16 rows — one per rating category |
| `ratingBreakdown[].categorySlug` / `.categoryName` | string | Machine key and display name, e.g. `maternity_leave` / `Maternity and Adoptive Leave` |
| `ratingBreakdown[].averageScore` / `.weightedAverageScore` | number | Raw and weighted category scores out of 5 |
| `ratingBreakdown[].submissions` / `.participants` | integer | How many ratings and how many people fed the category |
| `ratingBreakdown[].question` / `.description` | string | The exact question women answered, and its short label |
| `ratingGroups[]` | array | 5 rows — Opportunity, Schedule & Flexibility, Enrichment, Family, Culture |
| `ratingGroups[].categories` | array | Which category slugs roll into that group |
| `ratingGroups[].averageScore` / `.weightedAverageScore` / `.percent` | number | Group scores and percentage equivalent |
| `awards[]` | array | Award badges: `title`, `list`, `type`, `subtype`, `rank`, `month`, `year`, `current`, `badgeImageUrl` |
| `rankings[]` | array | One row per category × scope: `categorySlug`, `scope` (`industryGroup` / `industry` / `size`), `scopeName`, `rank`, `outOf` |

##### Survey Polls

Present when `includeSurveyQuestions` is on — five multiple-choice polls per company.

| Field | Type | Description |
|-------|------|-------------|
| `surveyQuestions[]` | array | One row per poll |
| `surveyQuestions[].question` | string | The exact question women answered |
| `surveyQuestions[].questionId` / `.questionUuid` | integer / string | Stable poll identifiers |
| `surveyQuestions[].questionType` | string | e.g. `Multiple choice` |
| `surveyQuestions[].ratingGroupSlug` / `.ratingGroupName` | string | Which score dimension the poll feeds, e.g. `rg-family` / `Family` |
| `surveyQuestions[].responseCount` / `.voteCount` | integer | How many women answered |
| `surveyQuestions[].options[]` | array | One row per answer option |
| `surveyQuestions[].options[].answer` | string | The option text, e.g. `Yes`, `No`, `I don't know` |
| `surveyQuestions[].options[].voteCount` / `.percentage` | number | Votes for that option, and its share of respondents |
| `surveyQuestions[].options[].primary` / `.order` | boolean / integer | Whether it is the leading option, and its display position |

#### Review rows (`recordType: "review"`)

```json
{
  "recordType": "review",
  "reviewId": 690097,
  "companyId": 246983,
  "companyName": "dbt Labs",
  "companySlug": "dbt-labs",
  "companyProfileUrl": "https://www.inhersight.com/company/dbt-labs/ratings",
  "text": "Mat leave in EMEA is well below standard. If we compare to companies like GCP/Stripe/Salesforce, they're offering a minimum of 26 weeks paid...",
  "satisfactionScore": 5.0,
  "satisfactionLabel": "Very satisfied",
  "jobLevel": 3,
  "jobLevelLabel": "Senior-Level",
  "featured": false,
  "replyCount": 0,
  "createdAt": "2022-09-20T02:57:53.245964-04:00",
  "scrapedAt": "2026-08-01T15:26:04.602134+00:00"
}
```

| Field | Type | Description |
|-------|------|-------------|
| `recordType` | string | Always `"review"` for these rows |
| `reviewId` | integer | Unique review id |
| `companyId` | integer | Links the review back to its company row |
| `companyName` | string | Company name, repeated so reviews stand alone |
| `companySlug` | string | Company URL slug |
| `companyProfileUrl` | string | Full URL of the company's ratings page |
| `text` | string | The full anonymous written review |
| `satisfactionScore` | number | Reviewer's satisfaction rating out of 5 |
| `satisfactionLabel` | string | Display form, e.g. `Very satisfied` |
| `jobLevel` | integer | InHerSight's job-level id |
| `jobLevelLabel` | string | Readable job level, e.g. `Senior-Level`, `Entry-Level` |
| `featured` | boolean | Whether InHerSight highlights this review on the profile |
| `replyCount` | integer | Number of replies posted to the review |
| `createdAt` | string | When the review was posted |
| `scrapedAt` | string | ISO 8601 timestamp of collection |

### Tips for Best Results

- **Set `minRating` to `"rated"` or higher before any broad browse.** Roughly 95% of InHerSight's 77,320-company directory has no score at all, and the filter runs before a company is opened — so it protects your result count as well as your bill.
- **Read `listRank` against `sourceList`, not globally.** A rating-category list such as Paid Time Off ranks companies by that single category, so a `listRank` of 1 there means "best for PTO", not "best overall".
- **Compare `averageScore` and `weightedAverageScore` side by side.** InHerSight weights recent and higher-confidence ratings differently, and a wide gap between the two on a category is the clearest signal that a company's experience has changed recently.
- **Keep `maxReviewsPerCompany` at 10–50 for exploration, and only set `0` on a shortlist.** Review counts have a long tail — most rated employers have 5 to 35, but Walmart has 866 and Starbucks 418.
- **Use `reviewCategories` to build targeted employer shortlists.** Selecting `maternity_leave` or `telecommute` returns a genuinely different company set than `salary` — in testing, two category lists overlapped by only one company out of six.
- **Reach narrow industries through `startUrls`.** The `industries` field covers 16 broad groups; the other 98 industry lists (Computer Software, Hospital & Health Care, and so on) are one pasted list URL away.
- **Reach for `includeSurveyQuestions` when you need a number, not a narrative.** The polls return a clean percentage split per answer option, which charts far better than review text — and unlike the rating categories, they cover concrete policy questions such as non-birth-parent leave and extended-family caregiving.
- **Turn `includeAwards` on only for companies you care about.** Large employers return dozens of ranking rows each — Microsoft returned 54 — which is excellent for a competitive teardown and noise for a broad sweep.

### Pricing

**From $1.70 per 1,000 results** — flat pay-per-result with no compute or time-based charges. Bronze, Silver, and Gold subscribers pay progressively less; the table below shows the total cost at each discount tier.

| Results | No discount | Bronze | Silver | Gold |
|---------|-------------|--------|--------|------|
| 100 | $0.20 | $0.19 | $0.18 | $0.17 |
| 1,000 | $2.00 | $1.90 | $1.80 | $1.70 |
| 10,000 | $20.00 | $19.00 | $18.00 | $17.00 |
| 100,000 | $200.00 | $190.00 | $180.00 | $170.00 |

**What counts as a result:** every row in the dataset, of either type. A company profile is one result, and each employee review is also one result — so a company collected with 20 reviews returns **21 results**: 1 company row plus 20 review rows. With the default settings (20 companies, 10 reviews each) a run costs about 220 results.

To control spend, lower `maxReviewsPerCompany`, or set `includeReviews` to `false` to bill company rows only. `minRating` also helps, because companies filtered out on the listing entry are never collected and never billed. No compute or time-based charges — you pay per result, plus a small fixed per-run start fee. Platform fees (storage, data transfer) depend on your Apify plan.

### Integrations

Export data in JSON, CSV, Excel, XML, or RSS. Connect to 1,500+ apps via:

- **Zapier** / **Make** / **n8n** — Workflow automation
- **Google Sheets** — Direct spreadsheet export
- **Slack** / **Email** — Notifications on new results
- **Webhooks** — Trigger custom APIs on run completion
- **Apify API** — Full programmatic access

### Legal & Ethical Use

This actor collects publicly available company ratings, award listings, and anonymous employee reviews for legitimate research, benchmarking, employer-brand analysis, and journalism. Reviews on InHerSight are published anonymously and no reviewer identity is collected or exposed. You are responsible for complying with applicable laws and InHerSight's terms of service, for making reasonable-rate requests, and for attributing review content appropriately when you publish it. Do not use the collected data for spam, harassment, misrepresentation, or any illegal purpose.

# Actor input Schema

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

Paste one or more InHerSight URLs. Accepts company profiles (https://www.inhersight.com/company/microsoft/ratings) and Best Companies lists (https://www.inhersight.com/companies/best, /companies/best/industry/computer-software, /companies/best/state/massachusetts-us, /companies/best/city/boston-ma, /companies/best/size/large, /companies/best/reviews/paid-time-off). List URLs are expanded into the companies they rank.

## `searchTerms` (type: `array`):

Company names or keywords to search on InHerSight, for example 'Salesforce', 'hospital', or 'credit union'. Each term is searched separately and returns up to 50 matching companies — narrow the term if a broad keyword matches more.

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

Scrape the Best Companies list for each industry you select. InHerSight publishes each of these as a top-20 ranking, so one selection returns at most 20 companies no matter how high Max Companies is set — combine several selections, add search terms, or paste list URLs to collect more. To target a narrower industry (there are 114 in total, such as Computer Software or Hospital & Health Care), paste that list's URL into the InHerSight URLs field instead.

## `reviewCategories` (type: `array`):

Scrape the Best Companies list for each rating category you select, for example the top-rated employers for paid time off or maternity leave. InHerSight publishes each of these as a top-20 ranking, so one selection returns at most 20 companies no matter how high Max Companies is set — combine several selections, add search terms, or paste list URLs to collect more.

## `companySizes` (type: `array`):

Scrape the Best Companies list for each company size you select. InHerSight publishes each of these as a top-20 ranking, so one selection returns at most 20 companies no matter how high Max Companies is set — combine several selections, add search terms, or paste list URLs to collect more.

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

US cities or states to scrape the Best Companies list for, for example 'Boston, MA', 'Chicago', 'MA', or 'Massachusetts'. InHerSight publishes lists for 99 cities and 43 states; entries with no matching list are skipped and reported in the run log. InHerSight publishes each of these as a top-20 ranking, so one selection returns at most 20 companies no matter how high Max Companies is set — combine several selections, add search terms, or paste list URLs to collect more.

## `minRating` (type: `string`):

Only scrape companies whose overall InHerSight score meets this threshold. The check runs on the listing entry before any company detail is fetched, so skipped companies cost you nothing. Companies you name directly in the InHerSight URLs field are always scraped.

## `includeRatingBreakdown` (type: `boolean`):

Add the 16 individual rating categories (salary satisfaction, paid time off, flexible hours, maternity leave, and more) plus the five grouped scores to every company. Turn off for faster runs that return only the headline score.

## `includeAwards` (type: `boolean`):

Add InHerSight's monthly award badges — including its state and city Best Companies placements — plus each company's rank within its broad industry group, its narrow industry, and its company-size band. Off by default because it makes every company slower to collect.

## `includeSurveyQuestions` (type: `boolean`):

Add the multiple-choice survey polls answered by women who worked at the company, such as whether dads and non-birth parents get sufficient parental leave. Each poll comes with every answer option, its vote count, and the percentage of respondents who chose it. Off by default so it costs nothing unless you want it.

## `includeReviews` (type: `boolean`):

Add anonymous written reviews from women who worked at the company, with their satisfaction score and job level. Each review is returned as its own row. Turning this off also leaves the company's total review count blank, because that number comes from the reviews themselves.

## `maxReviewsPerCompany` (type: `integer`):

How many reviews to collect for each company, newest first. Set to 0 to collect every available review — a safety limit of 1,000 reviews per company still applies. Ignored when employee reviews are turned off.

## `maxResults` (type: `integer`):

Maximum number of companies to return across everything you asked for. Employee reviews are returned as extra rows on top of this number. Set to 0 for no limit — a safety limit of 50,000 companies still applies.

## Actor input object example

```json
{
  "startUrls": [],
  "searchTerms": [],
  "industries": [],
  "reviewCategories": [],
  "companySizes": [],
  "locations": [],
  "minRating": "any",
  "includeRatingBreakdown": true,
  "includeReviews": true,
  "maxReviewsPerCompany": 10,
  "maxResults": 20
}
```

# Actor output Schema

## `overview` (type: `string`):

Every scraped company with its InHerSight score, rating volume, industry, and headquarters.

## `ratings` (type: `string`):

Score, rating counts, review counts, and the full rating-category breakdown per company.

## `awards` (type: `string`):

Monthly award badges and per-category industry, industry-group and company-size rankings, when those options are turned on.

## `reviews` (type: `string`):

Anonymous written reviews with satisfaction score, job level, and the company they belong to.

# 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 = {
    "startUrls": [],
    "searchTerms": [],
    "industries": [],
    "reviewCategories": [],
    "companySizes": [],
    "locations": [],
    "minRating": "any",
    "includeRatingBreakdown": true,
    "includeAwards": false,
    "includeSurveyQuestions": false,
    "includeReviews": true,
    "maxReviewsPerCompany": 10,
    "maxResults": 20
};

// Run the Actor and wait for it to finish
const run = await client.actor("solidcode/inhersight-com-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 = {
    "startUrls": [],
    "searchTerms": [],
    "industries": [],
    "reviewCategories": [],
    "companySizes": [],
    "locations": [],
    "minRating": "any",
    "includeRatingBreakdown": True,
    "includeAwards": False,
    "includeSurveyQuestions": False,
    "includeReviews": True,
    "maxReviewsPerCompany": 10,
    "maxResults": 20,
}

# Run the Actor and wait for it to finish
run = client.actor("solidcode/inhersight-com-scraper").call(run_input=run_input)

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

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

```

## CLI example

```bash
echo '{
  "startUrls": [],
  "searchTerms": [],
  "industries": [],
  "reviewCategories": [],
  "companySizes": [],
  "locations": [],
  "minRating": "any",
  "includeRatingBreakdown": true,
  "includeAwards": false,
  "includeSurveyQuestions": false,
  "includeReviews": true,
  "maxReviewsPerCompany": 10,
  "maxResults": 20
}' |
apify call solidcode/inhersight-com-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=solidcode/inhersight-com-scraper",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/acts/xAqym1ffOjtKSzZ8P/builds/1ksgEV96JfCuOwQAb/openapi.json