# Indeed Company reviews API (indeed.company_reviews)

- Canonical page: [https://everyinfra.com/en/indeed-api/company_reviews](https://everyinfra.com/en/indeed-api/company_reviews?utm_medium=ai_doc&utm_campaign=page_md)
- Endpoint: POST https://api.everyinfra.com/api/v1/social with {"platform": "indeed", "action": "company_reviews", "params": {...}}
- Price: $0.001389 per call ($1.39 per 1,000 requests); failed calls and empty results are not charged
- Returns: list, default 20, max 200 per call
- Mode: sync; add "mode": "async" for slow tasks

Indeed Company reviews reads the employee reviews of one employer on Indeed. Each row carries the review title and text, the overall rating, sub-ratings for pay and benefits, culture, job security, management and work-life balance, the reviewer's job title and location, whether they still work there, how many readers marked the review helpful, and the posting date. HR and employer branding teams use it to hear how staff describe a workplace, while recruiters and investors use it to compare employers and watch sentiment change over time.

Name the employer in `company` with its Indeed short name, such as Microsoft, or a full /cmp/<company>/reviews link. A plain name has its spaces turned into hyphens, so it is not a fuzzy name search; match the spelling of the Indeed company URL. Split results by `is_current_employee`, where false marks a former employee, and convert `rating` with `rating_scale` before you set it beside scores from other review sites.

## Health

- Live health (24h percent, hourly and daily trends): https://api.everyinfra.com/api/v1/social/availability?platform=indeed&action=company_reviews

## Parameters

| name | type | required | default | description |
|---|---|---|---|---|
| company | not declared | yes | not declared | Accepts an Indeed company short name or full /cmp/<company>/ URL. For company_reviews, pass the /reviews page URL directly; for salaries and interviews, the system extracts the entity from the URL and routes to the correct section. Passing a plain company name converts spaces to hyphens rather than executing a fuzzy search. |
| until | not declared | no | not declared | Sets an upper date limit (recommended format YYYY-MM-DD) for company_reviews. It does not act as a start date. |
| limit | integer (1–200) | no | 20 | The most rows to return in this call, an integer from 1 to 200. The default applies when you leave it out, and a call can return fewer rows. Larger values return 422 before any charge. |

## Response fields (items in `results`)

| field | meaning |
|---|---|
| id | The record's unique ID on the platform. Unique only within one platform; IDs can repeat across platforms. |
| url | Link to the record on the platform. |
| title | Title. null when the platform has no titles (for example text-only posts). |
| text | Body text with HTML removed, returned in full and never cut short (on a few platforms the list results themselves carry only an excerpt; the platform's field notes say so). |
| rating | Rating. **The scale varies by platform**: rating_scale on the same row gives the maximum (usually 5; Booking, Douban, iQIYI and NAVER use 10). Convert with rating_scale before comparing across platforms, or the comparison can come out backwards. |
| rating_scale | Maximum of rating in the same row: 5 for five-star scales, 10 for ten-point scales. Present only when the row has a rating. |
| rating_compensation | platform-native meaning |
| rating_culture | platform-native meaning |
| rating_job_security | platform-native meaning |
| rating_management | platform-native meaning |
| rating_work_life | platform-native meaning |
| job_title | platform-native meaning |
| location | Location description passed through as is; the format varies by platform. |
| country | Country or region: a full name or an ISO code depending on the platform, not normalized. |
| is_current_employee | platform-native meaning |
| helpful_count | platform-native meaning |
| posted_at | Publish time in ISO 8601, UTC (for example 2026-08-07T12:34:56+00:00). Non-standard strings from the platform are passed through as is, so parse defensively. null means the platform does not disclose it. |
| platform | Source platform identifier, the same as platform in the request (for example xiaohongshu, tiktok). |

## Example

```bash
curl -X POST 'https://api.everyinfra.com/api/v1/social' \
  -H "Authorization: Bearer $EVERYINFRA_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "platform": "indeed",
  "action": "company_reviews",
  "params": {
    "company": "Microsoft"
  }
}'
```

```python
import os
import requests

response = requests.post(
    "https://api.everyinfra.com/api/v1/social",
    headers={"Authorization": f"Bearer {os.environ['EVERYINFRA_API_KEY']}"},
    json={
        "platform": "indeed",
        "action": "company_reviews",
        "params": {
            "company": "Microsoft",
        },
    },
    timeout=120,
)
print(response.status_code)
print(response.json())
```

## Response example

Real response to the example request above, captured 2026-09-26T08:56:04Z. `results` and `count` are real with personal information (names, handles, avatars, profile links, contact details) removed; the list keeps the first 2 of 20. `id`, `billing` and `quota` differ on every call, so only their shape is shown.

```text
{
  "id": "req_…",
  "platform": "indeed",
  "action": "company_reviews",
  "results": [
    {
      "id": "3ae466ce9f38a614",
      "url": "/cmp/Microsoft/reviews/great-work-life-balance-but-retention-is-a-problem?id=3ae466ce9f38a614&uid=ed415639d2d6a5bd1c3caeb90d5eef1e",
      "rating": 3,
      "rating_compensation": 0,
      "rating_culture": 0,
      "rating_job_security": 0,
      "rating_management": 0,
      "job_title": "",
      "location": "",
      "country": "US",
      "is_current_employee": true,
      "helpful_count": 0,
      "posted_at": "2026-09-22T00:00:00+00:00",
      "platform": "indeed",
      "rating_scale": 5
    },
    {
      "id": "496522eb95651a48",
      "url": "/cmp/Microsoft/reviews/lot-to-learn?id=496522eb95651a48&uid=965ec521ba9f62d0150dafbf43a38803",
      "rating": 5,
      "rating_compensation": 0,
      "rating_culture": 0,
      "rating_job_security": 0,
      "rating_management": 0,
      "job_title": "Intern",
      "location": "Johannesburg, Gauteng",
      "country": "ZA",
      "is_current_employee": false,
      "helpful_count": 0,
      "posted_at": "2026-09-18T00:00:00+00:00",
      "platform": "indeed",
      "rating_scale": 5
    }
  ],
  "count": 20,
  "billing": {
    "charged": …,
    "charged_usd": …,
    "balance_after_usd": …,
    …
  },
  "quota": { … }
}
```

## FAQ

### What does `until` do?

It sets the latest review date to include, ideally written as YYYY-MM-DD, so you get reviews posted up to that date. It is an upper bound, not a start date: to study one period, set `until` to its last day and drop rows whose `posted_at` falls before the period begins. The Indeed Salaries and Interviews capabilities have no such date bound.

### Am I charged when an employer has no reviews?

No. A call that returns no rows is not charged, so an employer without reviews, or an `until` date earlier than any review, costs nothing. The price for calls that do return reviews is shown on this page, which is the place to check before you schedule regular pulls for many employers.

### How do I compare the sub-ratings?

`rating_compensation`, `rating_culture`, `rating_job_security`, `rating_management` and `rating_work_life` are each on a 5-point scale, so they can sit side by side as they are. Average each one over many reviews rather than reading single rows, and split the averages by `is_current_employee` to see whether current and former staff agree.

## Also

- Capability catalog (no key): https://api.everyinfra.com/api/v1/social/catalog?platform=indeed
- OpenAPI: https://everyinfra.com/openapi.json · Agents guide: https://everyinfra.com/agents.md
