Piloterr

LinkedIn Job Suggest

GET
/v2/linkedin/job/suggest

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

Credit cost: 1 credit per call

Authentification

ApiKeyAuth
x-api-key<token>

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

In: header

Paramètres de requête

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"

Corps de la réponse

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.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"}