# LinkedIn Job Suggest

## Overview

| Property | Value |
|----------|-------|
| **Status** | active |
| **Method** | `GET` |
| **Endpoint** | `/v2/linkedin/job/suggest` |
| **Base URL** | `https://api.piloterr.com` |
| **Credit Cost** | 1 credit per call |
| **Documentation** | https://www.piloterr.com/library/linkedin-job-suggest |

## Description

Get personalized job suggestions based on keywords or locations to streamline your job search.

## 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/linkedin/job/suggest' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY'
```

## Example Response

### Keyword suggestions for 'Air'

```json
[
  {
    "id": "1192656",
    "name": "Toulouse Lautrec",
    "type": "keyword"
  },
  {
    "id": "15095709",
    "name": "Toulouse School of Management",
    "type": "keyword"
  },
  {
    "id": "1611398",
    "name": "Toulouse School of Economics",
    "type": "keyword"
  },
  {
    "id": "10260250",
    "name": "Toulouse Métropole",
    "type": "keyword"
  },
  {
    "id": "23121145",
    "name": "Toulouse",
    "type": "keyword"
  }
]
```

### Location geo suggestions for 'Air' (location=true)

```json
[
  {
    "id": "90009870",
    "name": "Greater Buenos Aires",
    "type": "geo"
  },
  {
    "id": "100886388",
    "name": "Airdrie, Alberta, Canada",
    "type": "geo"
  },
  {
    "id": "102808620",
    "name": "Partido de General Pueyrredón, Buenos Aires Province, Argentina",
    "type": "geo"
  },
  {
    "id": "105934900",
    "name": "Airdrie, Scotland, United Kingdom",
    "type": "geo"
  }
]
```

## Documentation

## Overview
Get autocomplete suggestions for LinkedIn job searches. Use keyword mode to find job titles, companies, or schools, or use location mode to discover geographic areas and their `geo_id` values.

## Quickstart
```
GET https://api.piloterr.com/v2/linkedin/job/suggest?query=Air&location=false
```

## Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| `query` | string | yes | Keyword prefix for suggestions |
| `location` | boolean | no | `true` for geo suggestions, `false` for keyword suggestions |

## Main use cases
- Discover valid `geo_id` values for any city or region to power location-filtered job searches
- Build job search autocomplete UI components backed by LinkedIn's suggestion engine
- Validate and normalize job title inputs before feeding them into job search pipelines
- Map company or school names to LinkedIn internal IDs for advanced filtering