Piloterr

LinkedIn Job Suggest

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

Credit cost: 1 credit per call

GET
/v2/linkedin/job/suggest

Authorization

ApiKeyAuth
x-api-key<token>

Your API key. Include it in the x-api-key header for every request.

In: header

Query Parameters

query*string

The keyword prefix to search for job title suggestions or location names.

Example — keyword suggestions:

Air

Example — location suggestions (when location=true):

Par

Notes:

  • Short prefixes (2–4 characters) generally yield more results.
  • When location=false, returns job-related keyword suggestions (titles, companies, schools).
  • When location=true, returns geo locations with their geo_id values.
location?boolean

Set to true to receive location (geo) suggestions instead of keyword suggestions.

Accepted values:

  • false (default): Returns job keyword suggestions (titles, companies, schools)
  • true: Returns geographic locations with their geo_id for use in Job Count and Job Search filters

Note: The returned geo_id values can be used directly in the geo_id parameter of the LinkedIn Job Search and Job Count endpoints.

Default"false"

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://api.piloterr.com/v2/linkedin/job/suggest?query=string"

[
  {
    "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"
  }
]

{
  "error": "Bad Request"
}
{
  "error": "Invalid API Key"
}
{
  "error": "Payment required"
}
{
  "error": "Rate limit exceeded for the API key: quota monthly"
}
{
  "error": "Internal Error"
}