# Indeed Job Salary

## Overview

| Property | Value |
|----------|-------|
| **Status** | active |
| **Method** | `GET` |
| **Endpoint** | `/v2/indeed/job/salary` |
| **Base URL** | `https://api.piloterr.com` |
| **Credit Cost** | 2 credits per call |
| **Documentation** | https://www.piloterr.com/library/indeed-job-salary |

## Description

Indeed Job Salary API. Career salary aggregates by job title slug or URL. Browser rendering returns median, percentiles and top paying cities.

## Authentication

- **Key Name:** `x-api-key`
- **Location:** HTTP Header
- **Get an API key:** https://app.piloterr.com/register

## Example Request

```bash
curl --location --request GET 'https://api.piloterr.com/v2/indeed/job/salary' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY'
```

## Example Response

### Salary aggregates for 'ingénieur-etudes-et-développement' in France

```json
{
  "url": "https://fr.indeed.com/career/ing%C3%A9nieur-etudes-et-d%C3%A9veloppement/salaries",
  "title": "Ingénieur Etudes Et Développement (H/F)",
  "period": "YEARLY",
  "salary": {
    "max": 69630.14,
    "min": 31076.39,
    "mean": 48879.51,
    "text": "46 517 €",
    "type": "YEARLY",
    "median": 46517.24,
    "num_data_points": 2269
  },
  "country": "FR",
  "currency": "EUR",
  "location": "France",
  "by_period": {
    "DAILY": {
      "max": 603.35,
      "min": 356.04,
      "mean": 473.4,
      "type": "DAILY",
      "median": 463.48,
      "num_data_points": 108
    },
    "HOURLY": {
      "max": 98.98,
      "min": 31.18,
      "mean": 61.49,
      "type": "HOURLY",
      "median": 55.56,
      "num_data_points": 18
    },
    "YEARLY": {
      "max": 69630.14,
      "min": 31076.39,
      "mean": 48879.51,
      "type": "YEARLY",
      "median": 46517.24,
      "num_data_points": 2269
    },
    "MONTHLY": {
      "max": 3509.6,
      "min": 1795.21,
      "mean": 2552.01,
      "type": "MONTHLY",
      "median": 2454.6,
      "num_data_points": 86
    }
  },
  "title_slug": "ing%C3%A9nieur-etudes-et-d%C3%A9veloppement",
  "location_slug": null,
  "related_titles": null,
  "national_salary": null,
  "top_paying_cities": [
    {
      "url": "https://fr.indeed.com/career/ing%C3%A9nieur-etudes-et-d%C3%A9veloppement/salaries/Paris",
      "salary": null,
      "currency": "EUR",
      "location": "Paris",
      "location_slug": "Paris"
    },
    {
      "url": "https://fr.indeed.com/career/ing%C3%A9nieur-etudes-et-d%C3%A9veloppement/salaries/Bordeaux",
      "salary": null,
      "currency": "EUR",
      "location": "Bordeaux",
      "location_slug": "Bordeaux"
    }
  ],
  "top_paying_companies": [
    {
      "salary": {
        "mean": 114.85,
        "type": "HOURLY",
        "count": 3
      },
      "company_url": null,
      "company_name": "Service Civique",
      "reviews_count": 12
    },
    {
      "salary": {
        "mean": 422,
        "type": "DAILY",
        "count": 5
      },
      "company_url": null,
      "company_name": "FREELANCE.COM",
      "reviews_count": 10
    }
  ]
}
```

## Documentation

## Overview
Benchmark Indeed career salaries via browser rendering. The **Indeed Job Salary API** reads `/career/.../salaries` pages and returns medians, percentiles, pay-period breakdowns and top paying cities or companies.

Pass a **job title slug**, a **full career salary URL** or a **`slug|location`** pair.

Complements [Indeed Job Search](https://www.piloterr.com/library/indeed-job-search) and [Indeed Job Info](https://www.piloterr.com/library/indeed-job-info).

## Quickstart
```
GET https://api.piloterr.com/v2/indeed/job/salary?query=ing%C3%A9nieur-etudes-et-d%C3%A9veloppement
GET https://api.piloterr.com/v2/indeed/job/salary?query=ing%C3%A9nieur-etudes-et-d%C3%A9veloppement|Paris-(75)
```

## Notes
- Default domain is **fr.indeed.com** unless a full URL specifies another locale.
- Aggregates cover Indeed postings from the last 36 months.
- `top_paying_cities[].salary` and `top_paying_companies[].salary` may be `null` on list entries.
- Costs **2 credits** per call (browser rendering).

## Main use cases
- **Compensation benchmarking**: compare medians by role and city
- **Workforce planning**: size talent markets with `num_data_points`
- **Recruiting strategy**: identify top paying cities and employers