Twitter place search API: find X place IDs by name

{
  "places": [
    {
      "id": "5e02a0f0d91c76d2",
      "name": "İstanbul",
      "fullName": "İstanbul, Türkiye",
      "country": "Turkey",
      "countryCode": "TR"
    }
  ],
  "count": 1,
  "total": 1
}

{
  "error": "missing_query",
  "message": "Search query required. Use q."
}

{
  "error": "unauthenticated",
  "message": "Authentication required."
}

{
  "error": "insufficient_credits",
  "message": "Insufficient credits. Top up or subscribe to continue."
}

{
  "error": "x_api_unavailable",
  "message": "X data source temporarily unavailable. Try again later."
}

{
  "error": "rate_limit_exceeded",
  "message": "Too many requests. Try again later.",
  "retryAfter": 60
}

{
  "error": "x_api_unavailable",
  "message": "X data source temporarily unavailable. Try again later."
}

{
  "error": "x_api_unavailable",
  "message": "Xquik is busy right now. Retry shortly."
}

GET

places

Twitter place search API: find X place IDs by name

curl --request GET \
  --url https://xquik.com/api/v1/x/places/search

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://xquik.com/api/v1/x/places/search"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

{
  "places": [
    {
      "id": "<string>",
      "name": "<string>",
      "fullName": {},
      "country": {},
      "countryCode": {},
      "placeType": {},
      "url": {},
      "centroid": {},
      "boundingBox": {},
      "attributes": {},
      "containedWithin": [
        {}
      ]
    }
  ],
  "count": 123,
  "total": 123,
  "message": "<string>"
}

1 credit per place returned · All plans from $0.00012/credit

curl -G https://xquik.com/api/v1/x/places/search \
  --data-urlencode "q=istanbul" \
  --data-urlencode "limit=5" \
  -H "x-api-key: xq_your_api_key_here" | jq

const params = new URLSearchParams({ q: "istanbul", limit: "5" });
const response = await fetch(`https://xquik.com/api/v1/x/places/search?${params}`, {
  headers: { "x-api-key": "xq_your_api_key_here" },
});
const data = await response.json();
const placeRows = data.places.map((place) => ({
  place_id: place.id,
  name: place.name,
  full_name: place.fullName,
  country_code: place.countryCode,
  place_type: place.placeType,
}));

for (const row of placeRows) {
  process.stdout.write(`${JSON.stringify(row)}\n`);
}

import json
import requests

response = requests.get(
    "https://xquik.com/api/v1/x/places/search",
    params={"q": "istanbul", "limit": 5},
    headers={"x-api-key": "xq_your_api_key_here"},
)
data = response.json()
place_rows = [
    {
        "place_id": place["id"],
        "name": place["name"],
        "full_name": place["fullName"],
        "country_code": place["countryCode"],
        "place_type": place["placeType"],
    }
    for place in data["places"]
]
for row in place_rows:
    print(json.dumps(row))

Use GET /x/places/search to find places on X by name. Each place carries the id that Search tweets takes as place. Each returned place costs 1 credit. limit lowers the cost. An empty result costs nothing.

Search tweets from a place

Search for the place by name, then read id from the place you want. Send that id as place to GET /x/tweets/search to get posts tagged there. fullName, country, and placeType tell places with the same name apart. containedWithin lists the larger places around each place. X ranks the places. Their order can differ between requests.

Query parameters

string

required

Place name to search for, such as istanbul. Alias: query.

integer

Maximum places to return, starting at 1. Omit it for every place X finds. Your credit balance can return fewer. Aliases: pageSize, count, max_results, maxItems, max_items & per_page.

Headers

string

Send a full Xquik account API key.

string

Bearer xq_your_guest_key_here for paid_reads.

Response

200 OK

object[]

Places X found for the name, in X’s order. Place object fields.

string

Place ID. Pass it as place to GET /x/tweets/search.

string

Short name of the place.

string | null

Name with the region or country around the place.

string | null

Country the place lies in.

string | null

2-letter code of that country.

string | null

X’s kind of place, such as city, admin, neighborhood, poi, or country.

string | null

X’s own reference URL for the place.

number[] | null

Center of the place. Longitude, then latitude.

object | null

Outline of the place as GeoJSON, with type and coordinates. Each point holds longitude, then latitude.

object

Extra details X attaches to some places. Often empty.

object[]

Larger places this place lies in. Each has the same fields, without containedWithin.

number

Places returned and charged.

number

Places X found, before limit.

string

What to send instead. Present only when X finds no place.

{
  "places": [
    {
      "id": "5e02a0f0d91c76d2",
      "name": "İstanbul",
      "fullName": "İstanbul, Türkiye",
      "country": "Turkey",
      "countryCode": "TR",
      "placeType": "city",
      "url": "https://api.twitter.com/1.1/geo/id/5e02a0f0d91c76d2.json",
      "centroid": [28.84318392941324, 41.054196399999995],
      "boundingBox": {
        "type": "Polygon",
        "coordinates": [
          [
            [28.6321043, 40.8027337],
            [28.6321043, 41.2399073],
            [29.3783413, 41.2399073],
            [29.3783413, 40.8027337]
          ]
        ]
      },
      "attributes": {},
      "containedWithin": []
    }
  ],
  "count": 1,
  "total": 1
}

A name X finds no place for returns an empty list and a message:

{
  "places": [],
  "count": 0,
  "total": 0,
  "message": "X found no place for that text. Try a city or country name."
}

400 Missing query

{ "error": "missing_query", "message": "Search query required. Use q." }

Send the place name as q.

401 Unauthenticated

Anonymous requests get WWW-Authenticate: Bearer and a guest wallet checkout action. This is not a Payment challenge.

{ "error": "unauthenticated" }

402 Payment required

Account keys get account options. Guest keys get guest top-up only. No checkout starts automatically. Confirm any payment action.

502 X API unavailable

{ "error": "x_api_unavailable" }

The read service returned an error. Retry after a short delay.

503 Service busy

{ "error": "x_api_unavailable" }

Xquik is busy. Wait for Retry-After, then retry.

429 Rate limit exceeded

{ "error": "rate_limit_exceeded", "retryAfter": 60 }

The Xquik tier limit blocked the request. Use Retry-After when present. Otherwise, use the JSON retryAfter field.

424 Dependency failed

{ "error": "x_api_unavailable" }

The opt-in normalized contract returns 424 when the read service fails. Send xquik-api-contract: 2026-04-29 to opt in. Default v1 returns 502.

Twitter place search API questions

How do I find a Twitter place ID?

Call GET /x/places/search with the place name as q. Read id from the place you want.

How do I search tweets from a place?

Send the place id as place to GET /x/tweets/search. Add q to keep only posts that match your words.

How much does a place search cost?

Each returned place costs 1 credit. An empty result costs nothing. Add limit to return fewer places.

Why does the order of places change?

X ranks the places for each request. Match on id, not on position.

Does this replace X’s official API?

No. This page documents Xquik, an independent third-party service. It does not document X’s official API.

Next steps. Search tweets takes a place id as place.

{
  "places": [
    {
      "id": "5e02a0f0d91c76d2",
      "name": "İstanbul",
      "fullName": "İstanbul, Türkiye",
      "country": "Turkey",
      "countryCode": "TR"
    }
  ],
  "count": 1,
  "total": 1
}

{
  "error": "missing_query",
  "message": "Search query required. Use q."
}

{
  "error": "unauthenticated",
  "message": "Authentication required."
}

{
  "error": "insufficient_credits",
  "message": "Insufficient credits. Top up or subscribe to continue."
}

{
  "error": "x_api_unavailable",
  "message": "X data source temporarily unavailable. Try again later."
}

{
  "error": "rate_limit_exceeded",
  "message": "Too many requests. Try again later.",
  "retryAfter": 60
}

{
  "error": "x_api_unavailable",
  "message": "X data source temporarily unavailable. Try again later."
}

{
  "error": "x_api_unavailable",
  "message": "Xquik is busy right now. Retry shortly."
}

Twitter place search API: find X place IDs by name

curl --request GET \
  --url https://xquik.com/api/v1/x/places/search

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://xquik.com/api/v1/x/places/search"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

{
  "places": [
    {
      "id": "<string>",
      "name": "<string>",
      "fullName": {},
      "country": {},
      "countryCode": {},
      "placeType": {},
      "url": {},
      "centroid": {},
      "boundingBox": {},
      "attributes": {},
      "containedWithin": [
        {}
      ]
    }
  ],
  "count": 123,
  "total": 123,
  "message": "<string>"
}

Overview

X API

X write

Trends

Radar

Account

API keys

Guest wallets

Credits

X accounts

Monitors

Events

Webhooks

Draws

Extractions

Compose

Drafts

Styles

Support

Twitter place search API: find X place IDs by name

Search tweets from a place

Query parameters

Headers

Response

200 OK

400 Missing query

401 Unauthenticated

402 Payment required

502 X API unavailable

503 Service busy

429 Rate limit exceeded

424 Dependency failed

Twitter place search API questions

How do I find a Twitter place ID?

How do I search tweets from a place?

How much does a place search cost?

Why does the order of places change?

Does this replace X’s official API?

​Search tweets from a place

​Query parameters

​Headers

​Response

​200 OK

​400 Missing query

​401 Unauthenticated

​402 Payment required

​502 X API unavailable

​503 Service busy

​429 Rate limit exceeded

​424 Dependency failed

​Twitter place search API questions

​How do I find a Twitter place ID?

​How do I search tweets from a place?

​How much does a place search cost?

​Why does the order of places change?

​Does this replace X’s official API?

Search tweets from a place

Query parameters

Headers

Response

200 OK

400 Missing query

401 Unauthenticated

402 Payment required

502 X API unavailable

503 Service busy

429 Rate limit exceeded

424 Dependency failed

Twitter place search API questions

How do I find a Twitter place ID?

How do I search tweets from a place?

How much does a place search cost?

Why does the order of places change?

Does this replace X’s official API?