Find job location: GET /jobs/find-location/{term}

Docs

Find job location

Location IDs for the jobLocationId filter of job search. Returns up to 10 matches.

GET/jobs/find-location/{term}

Parameters

termpath · string · required
Place name, URL-encoded.

Name	In	Type	Required	Description
term	path	string	yes	Place name, URL-encoded.

Example request

curl 'https://api.twittrapi.com/jobs/find-location/Berlin' \
  --header 'X-API-KEY: YOUR_API_KEY'

import httpx

# No SDK method for this endpoint yet, so this is a plain HTTP call.
resp = httpx.get(
    "https://api.twittrapi.com/jobs/find-location/Berlin",
    headers={"X-API-KEY": "YOUR_API_KEY"},
    timeout=60,
)
data = resp.json()

import { TwittrAPI } from "twittrapi";

const client = new TwittrAPI({ apiKey: process.env.TWITTRAPI_API_KEY });
// No wrapper method for this endpoint yet; client.get() sends the same authenticated GET.
const data = await client.get({
  path: "/jobs/find-location/Berlin",
});

curl 'https://twitter-aio.p.rapidapi.com/jobs/find-location/Berlin' \
  --header 'x-rapidapi-key: YOUR_RAPIDAPI_KEY' \
  --header 'x-rapidapi-host: twitter-aio.p.rapidapi.com'

Base URL https://api.twittrapi.com, key in the X-API-KEY header. Python and Node.js use the official SDKs.

Response

Raw JSON of X's LocationSelectorQuery.

Simple format (?format=simple or X-Response-Format: simple): Collection of {id, name} location suggestions (no cursor). Schema.

{
  "data": {
    "location_type_ahead": [
      {
        "display_name": "Land Berlin, DE",
        "location_id": "1720462559101268315"
      },
      {
        "display_name": "Berlin, DE",
        "location_id": "1720462559210320095"
      },
      {
        "display_name": "New Berlin, WI",
        "location_id": "1721739239443038504"
      }
    ]
  }
}

{
  "data": [
    {
      "id": "1720462559101268315",
      "name": "Land Berlin, DE"
    },
    {
      "id": "1720462559210320095",
      "name": "Berlin, DE"
    },
    {
      "id": "1721739239443038504",
      "name": "New Berlin, WI"
    }
  ],
  "nextCursor": null,
  "previousCursor": null,
  "hasNextPage": false
}

In the raw format, field names and nesting come from X and can change without notice. See Response format; the simple format keeps a fixed schema.

Errors

No endpoint-specific validation. Errors from X are mapped as described below.

Errors every endpoint can return (401, 402, 403, 404, 408, 409, 429, 5xx), and which of them are charged, are on the Errors page. Calls that fail with 400, 408, 409 or a 5xx error are refunded.