# Indeed Company Reviews Extractor (`reviewly/indeed-company-reviews-extractor`) Actor Scrapes company reviews from Indeed with pagination, date filtering, and deduplication. - **URL**: https://apify.com/reviewly/indeed-company-reviews-extractor.md - **Developed by:** [Reviewly](https://apify.com/reviewly) (community) - **Categories:** AI, Integrations, Other - **Stats:** 3 total users, 2 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing from $8.00 / 1,000 record scrapeds 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/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. 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. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use 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 ## Indeed Reviews Scraper β€” Extract Company Reviews at Scale **Automatically collect hundreds of employee reviews from Indeed company pages β€” no coding required.** Get structured review data including ratings, pros & cons, job titles, dates, and employer responses. Perfect for HR teams, market researchers, and recruitment agencies who need reliable, up-to-date employer reputation data. --- ### πŸ“Œ What This Actor Does The **Indeed Reviews Scraper** navigates Indeed company review pages and extracts all publicly available employee reviews into a clean, structured dataset. Simply paste one or more Indeed company review URLs, set your filters, and let the actor handle pagination, deduplication, and data normalization automatically. **Who is it for?** - **HR & Talent Acquisition teams** monitoring employer brand and competitor reputation - **Business analysts** benchmarking companies by employee satisfaction - **Recruitment agencies** vetting employers before placing candidates - **Market researchers** tracking sentiment trends over time - **Developers** building HR intelligence or employer rating platforms --- ### ✨ Key Features - **Multi-company support** β€” scrape multiple companies in a single run - **Full pagination** β€” automatically fetches all pages of reviews, not just the first - **Date filtering** β€” only collect reviews from a specific date onwards - **Deduplication** β€” built-in review ID tracking prevents duplicates across runs - **Employer responses** β€” captures the full thread of official company replies - **Structured output** β€” clean `{ entity, reviews[] }` format ready for any downstream tool - **Residential proxy support** β€” stays undetected with Apify's proxy network - **Browser fingerprinting** β€” mimics a real mobile device to avoid blocks - **Automatic retries** β€” retries failed requests with exponential backoff - **Pay-per-review pricing** β€” only pay for what you actually extract --- ### 🧠 Why This Actor is Different Most Indeed scrapers break within days because they rely on fragile CSS selectors or hardcoded session tokens. This actor extracts data from Indeed's **embedded JSON payload** (`#comp-initialData`) β€” a stable, structured data source that changes far less often than the page's visual layout. | Feature | This Actor | Typical scrapers | |---|---|---| | Data source | Embedded JSON (stable) | HTML selectors (fragile) | | Employer replies | βœ… Full thread | ❌ Often missing | | Date filtering | βœ… Built-in | ❌ Manual post-processing | | Deduplication | βœ… Automatic | ❌ Manual | | Multiple companies | βœ… One run | ❌ One at a time | | Pay-per-result | βœ… Yes | ❌ Fixed cost | --- ### πŸ’° Pricing This actor uses **pay-per-event** pricing β€” you only pay for reviews actually extracted, with no subscriptions or minimums. | Event | Cost | |---|---| | Per review extracted | **$0.008** ($8 per 1,000 reviews) | | Actor start | **$0.50** | > **Examples:** 500 reviews β†’ $4.50 β€” 2,000 reviews β†’ $16.50 β€” 10,000 reviews β†’ $80.50 --- ### βš™οΈ Input Configuration #### Fields | Field | Type | Required | Description | |---|---|---|---| | `startUrls` | Array | βœ… Yes | One or more Indeed company review page URLs | | `maxNumberOfReviews` | Integer | No | Max reviews per company. `0` = no limit (default: `0`) | | `targetDate` | String | No | Only scrape reviews on or after this date (`YYYY-MM-DD`) | | `proxyConfiguration` | Object | No | Proxy settings β€” residential proxies strongly recommended | #### Example Input (JSON) ```json { "startUrls": [ { "url": "https://fr.indeed.com/cmp/Decathlon/reviews/" }, { "url": "https://fr.indeed.com/cmp/L-Oreal/reviews/" } ], "maxNumberOfReviews": 500, "targetDate": "2024-01-01", "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": ["RESIDENTIAL"] } } ```` #### Tips for Best Results - **Always use residential proxies** β€” datacenter IPs are frequently blocked by Cloudflare on Indeed - **Use `targetDate` for incremental runs** β€” set it to your last run date to only pull new reviews and avoid re-scraping - **Leave `maxNumberOfReviews` at `0`** to scrape all available reviews for a company - **URL format** β€” any Indeed subdomain works (`fr.indeed.com`, `uk.indeed.com`, etc.); the actor normalizes them automatically *** ### πŸ“€ Output Format The actor produces **one dataset item per company**. Each item contains the company metadata and all scraped reviews in a single nested structure. #### Sample Output ```json { "entity": { "companyName": "Decathlon", "totalRating": 4.1, "totalReviews": 3842, "ratingDistribution": { "1": 210, "2": 180, "3": 420, "4": 890, "5": 2142 }, "sourceUrl": "https://fr.indeed.com/cmp/Decathlon/reviews/" }, "reviews": [ { "reviewId": "abc123xyz", "url": "https://fr.indeed.com/cmp/Decathlon/reviews/super-entreprise?id=abc123", "location": "Paris (75)", "rating": 5, "title": "Super entreprise", "reviewBody": "TrΓ¨s bonne ambiance de travail, management Γ  l'Γ©coute.", "positivePoints": "Ambiance, Γ©volution de carriΓ¨re, avantages", "negativePoints": "Horaires parfois chargΓ©s", "comments": [ { "isOfficial": true, "body": "Merci pour votre retour positif !", "date": "2024-03-15T00:00:00.000Z" } ], "date": "2024-02-20T00:00:00.000Z", "author": { "jobTitle": "Vendeur", "isCurrentlyWorking": true }, "scrapedAt": "2025-05-16T10:30:00.000Z" } ] } ``` #### Field Reference **Entity (company metadata)** | Field | Type | Description | |---|---|---| | `companyName` | String | Company name as shown on Indeed | | `totalRating` | Float | Overall rating (0–5) | | `totalReviews` | Integer | Total number of reviews on Indeed | | `ratingDistribution` | Object | Count of reviews per star rating (1–5) | | `sourceUrl` | String | The original URL provided as input | **Review fields** | Field | Type | Description | |---|---|---| | `reviewId` | String | Unique Indeed review identifier | | `url` | String | Direct permalink to the review | | `location` | String | Reviewer's work location | | `rating` | Integer | Star rating (1–5) | | `title` | String | Review headline | | `reviewBody` | String | Full review text | | `positivePoints` | String | Pros section text | | `negativePoints` | String | Cons section text | | `comments` | Array | Employer responses (`isOfficial`, `body`, `date`) | | `date` | ISO 8601 | Date the review was submitted | | `author.jobTitle` | String | Reviewer's job title | | `author.isCurrentlyWorking` | Boolean | `true` if the reviewer is a current employee | | `scrapedAt` | ISO 8601 | Timestamp of when this record was extracted | *** ### ▢️ How to Use #### Option A β€” Apify Console (No Code) 1. Open the actor in [Apify Store](https://apify.com/store) and click **Try for free** 2. In the **Input** tab, paste your Indeed company review URL(s) 3. Set `maxNumberOfReviews` and `targetDate` if needed 4. Enable **Residential** proxies under *Proxy configuration* 5. Click **Start** and wait for the run to finish 6. Download your data from the **Dataset** tab as JSON, CSV, or Excel #### Option B β€” Apify API ```bash curl -X POST \ "https://api.apify.com/v2/acts/YOUR_ACTOR_ID/runs?token=YOUR_API_TOKEN" \ -H "Content-Type: application/json" \ -d '{ "startUrls": [{ "url": "https://fr.indeed.com/cmp/Decathlon/reviews/" }], "maxNumberOfReviews": 200, "targetDate": "2024-01-01" }' ``` #### Option C β€” Scheduled Updates (Recommended) 1. Open the actor β†’ **Schedules** tab 2. Set it to run weekly or monthly 3. Set `targetDate` to the previous run date to only pull new reviews 4. Connect to **Zapier**, **Make**, or a webhook to push results to your CRM or spreadsheet automatically *** ### πŸ“ˆ Use Cases #### 1. Employer Brand Monitoring Track how your company's Indeed rating evolves month over month. Schedule a weekly run with `targetDate` pointing to the previous week to catch every new review as it appears. #### 2. Competitive Intelligence Scrape reviews from 5–10 competitors in a single run. Analyze `positivePoints` and `negativePoints` across companies to understand what top talent values β€” and where competitors fall short. #### 3. Recruitment Due Diligence Before placing a candidate with a client company, pull their latest reviews to surface red flags β€” management issues, high turnover, unpaid overtime β€” that won't appear in a sales pitch. #### 4. Sentiment Analysis & NLP Feed `reviewBody`, `positivePoints`, and `negativePoints` into an NLP pipeline to score employer sentiment at scale across hundreds of companies. #### 5. HR Reporting Dashboards Connect this actor to Google Sheets or Airtable via Apify integrations to auto-populate live employer satisfaction dashboards for leadership reporting. *** ### πŸ› οΈ Advanced Tips #### Incremental Scraping (Only New Reviews) Use `targetDate` to avoid re-scraping old data on repeat runs: ```json { "startUrls": [{ "url": "https://fr.indeed.com/cmp/Decathlon/reviews/" }], "targetDate": "2025-04-01" } ``` Each month, update `targetDate` to the first day of the current month. Using the Apify API, you can compute this date dynamically before each scheduled run. #### Scaling to Many Companies The actor processes companies sequentially. For batches of 50+ companies: - Split URLs across multiple parallel actor runs via the Apify API - Use Apify's [meta-actor pattern](https://docs.apify.com/platform/actors/running/metamorphing) to fan out automatically *** ### ❓ FAQ & Troubleshooting **The actor returns no reviews β€” what's wrong?** Verify your URL matches the pattern `https://*.indeed.com/cmp/COMPANY-SLUG/reviews/`. The actor skips invalid URLs and logs a warning. Also confirm that residential proxies are enabled. **How fresh is the data?** Data is scraped live on every run β€” there is no cache. You always get the latest reviews at the moment the actor starts. **How many reviews can I scrape in one run?** There is no hard cap. The actor paginates through all available pages. Companies with 5,000+ reviews are fully supported. Set `maxNumberOfReviews: 0` for unlimited. **Is the data usable in Excel or Google Sheets?** Yes β€” download directly as CSV or Excel from the Apify dataset UI. For nested fields (`comments`, `ratingDistribution`), use JSON format to preserve the full structure, or flatten with a tool like `jq` or Python `pandas`. **Does scraping Indeed reviews violate their Terms of Service?** This actor scrapes **publicly visible** data β€” the same reviews any visitor sees without logging in. Always ensure your use case complies with the applicable terms of service and local data regulations (GDPR, etc.). *** ### πŸ“ž Support - **Bug reports & issues:** Use the *Issues* tab on the actor's Apify Store page - **Feature requests:** Open a thread in the *Discussion* tab - **Community help:** [community.apify.com](https://community.apify.com) # Actor input Schema ## `startUrls` (type: `array`): One or more Indeed company review page URLs (any subdomain β€” will be normalized to fr.indeed.com). ## `maxNumberOfReviews` (type: `integer`): Maximum number of reviews to scrape per company. Set to 0 (or leave empty) for no limit. ## `targetDate` (type: `string`): Only scrape reviews submitted on or after this date (YYYY-MM-DD). Leave empty to scrape all reviews. ## `proxyConfiguration` (type: `object`): Proxy servers used to avoid rate limiting and Cloudflare blocks. Residential proxies recommended. ## Actor input object example ```json { "startUrls": [ { "url": "https://fr.indeed.com/cmp/Aza%C3%A9-1/reviews/" } ], "maxNumberOfReviews": 0, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } ``` # 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 '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "startUrls": [ { "url": "https://fr.indeed.com/cmp/Aza%C3%A9-1/reviews/" } ], "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } }; // Run the Actor and wait for it to finish const run = await client.actor("reviewly/indeed-company-reviews-extractor").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 '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "startUrls": [{ "url": "https://fr.indeed.com/cmp/Aza%C3%A9-1/reviews/" }], "proxyConfiguration": { "useApifyProxy": True, "apifyProxyGroups": ["RESIDENTIAL"], }, } # Run the Actor and wait for it to finish run = client.actor("reviewly/indeed-company-reviews-extractor").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": [ { "url": "https://fr.indeed.com/cmp/Aza%C3%A9-1/reviews/" } ], "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } }' | apify call reviewly/indeed-company-reviews-extractor --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=reviewly/indeed-company-reviews-extractor", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Indeed Company Reviews Extractor", "description": "Scrapes company reviews from Indeed with pagination, date filtering, and deduplication.", "version": "0.0", "x-build-id": "nfPrtgdTeez2gqQZA" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/reviewly~indeed-company-reviews-extractor/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-reviewly-indeed-company-reviews-extractor", "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/reviewly~indeed-company-reviews-extractor/runs": { "post": { "operationId": "runs-sync-reviewly-indeed-company-reviews-extractor", "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/reviewly~indeed-company-reviews-extractor/run-sync": { "post": { "operationId": "run-sync-reviewly-indeed-company-reviews-extractor", "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", "required": [ "startUrls" ], "properties": { "startUrls": { "title": "Company Review URLs", "type": "array", "description": "One or more Indeed company review page URLs (any subdomain β€” will be normalized to fr.indeed.com).", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "maxNumberOfReviews": { "title": "Max reviews per company", "minimum": 0, "type": "integer", "description": "Maximum number of reviews to scrape per company. Set to 0 (or leave empty) for no limit.", "default": 0 }, "targetDate": { "title": "Filter reviews after date", "type": "string", "description": "Only scrape reviews submitted on or after this date (YYYY-MM-DD). Leave empty to scrape all reviews." }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Proxy servers used to avoid rate limiting and Cloudflare blocks. Residential proxies recommended.", "default": { "useApifyProxy": 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 } } }, "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 } } } } } } } } } } ```