# Indeed Interviews API (indeed.interviews)

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

Indeed Interviews reads the interview section of one employer's Indeed page and returns a single record: the interview questions candidates report, their own accounts of how the process went, and how long it took from application to starting the job. Career coaching services and job platforms use it to prepare candidates for a specific employer, and recruiters and employer branding teams use it to see how a hiring process looks from the outside and how its length compares with other employers.

Name the employer in `company` with its Indeed short name, such as Microsoft, or any link to its /cmp/<company>/ page. `questions` and `process_stories` are text written by candidates, so weigh a theme by how many candidates mention it rather than by one vivid account, and read `hiring_durations` as a distribution rather than one figure.

## Health

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

## 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. |

## 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. |
| company_name | platform-native meaning |
| hiring_durations | platform-native meaning |
| questions | platform-native meaning |
| process_stories | platform-native meaning |
| 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": "interviews",
  "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": "interviews",
        "params": {
            "company": "Microsoft",
        },
    },
    timeout=120,
)
print(response.status_code)
print(response.json())
```

## Response example

No real sample for these example parameters yet: structure only, every value is a placeholder (…).

```text
{
  "id": "req_…",
  "platform": "indeed",
  "action": "interviews",
  "results": {
    "id": …,
    "url": …,
    "company_name": …,
    "hiring_durations": …,
    "questions": …,
    "process_stories": …,
    "platform": …
  },
  "billing": {
    "charged": …,
    "charged_usd": …,
    "balance_after_usd": …,
    …
  },
  "quota": { … }
}
```

## FAQ

### Why do I get one record instead of a list?

This capability summarizes the employer's interview section as a whole: one record holds the reported `questions`, the candidate accounts in `process_stories` and the timing in `hiring_durations`. Expand those lists yourself if you want one row per question or per story.

### How should I read `hiring_durations`?

It describes how long hiring took, from application to starting the job, as a distribution rather than a single number. Look at where most of it falls instead of the fastest or slowest case, and compare employers only when you read their distributions the same way.

### Can I pass a link to another section of the company page?

Yes. Any /cmp/<company>/ link works, whether it points at the reviews, salaries or jobs part of the page: the call takes the employer from the link and reads its interviews section. A link also spares you from guessing how a name with spaces is written in Indeed's URL.

## 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
