GET https://xquik.com/api/v1/x/places/search
1 credit per place returned · All plans from $0.00012/credit
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 readid 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
message.400 Missing query
Send the place name asq.401 Unauthenticated
Anonymous requests getWWW-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 forRetry-After, then retry.429 Rate limit exceeded
The Xquik tier limit blocked the request. UseRetry-After when present. Otherwise, use the JSON retryAfter field.424 Dependency failed
The opt-in normalized contract returns 424 when the read service fails. Sendxquik-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?
CallGET /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 placeid 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. Addlimit to return fewer places.Why does the order of places change?
X ranks the places for each request. Match onid, 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." }