Skip to main content
GET https://xquik.com/api/v1/x/places/search
1 credit per place returned · All plans from $0.00012/credit
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

Choose fields

Headers

Response

200 OK

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

400 Missing query

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.

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

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

503 Service busy

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

429 Rate limit exceeded

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

424 Dependency failed

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.

Response examples

  • 400 { "error": "missing_query", "message": "Search query required. Use q." }
  • 401 { "error": "unauthenticated", "message": "Authentication required." }
  • 402 { "error": "insufficient_credits", "message": "Insufficient credits. Top up or subscribe to continue." }
  • 403 { "error": "api_key_paused", "message": "This API key is paused. Resume it at dashboard.xquik.com/api-keys to use it again." }
  • 424 { "error": "x_api_unavailable", "message": "X data source temporarily unavailable. Try again later." }
  • 429 { "error": "rate_limit_exceeded", "message": "Too many requests. Try again later.", "retryAfter": 60 }
  • 502 { "error": "x_api_unavailable", "message": "X data source temporarily unavailable. Try again later." }
  • 503 { "error": "x_api_unavailable", "message": "Xquik is busy right now. Retry shortly." }