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

Authorization

ApiKeyAuth
headerx-api-key<token>

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

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

Successful response

application/json
  1. response
[index: integer]?
Example Request
curl -X GET 'https://api.piloterr.com/v2/linkedin/job/suggest?query=string'
Example Response
[  {    "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"  }]