Reddit Scraper API just launched: posts, comments, subreddits, users & full search→
Twitter Scraper APIsGeo API
Twitter Geo API

Twitter (X) Geo Details Scraper API for Complete Place Search and Location Data

Search for Twitter geographic places by name, coordinates, or IP address and retrieve complete place metadata, country information, place types, and geographic bounding boxes as structured JSON.

2 Geo-specific endpoints
1 base credit + 1 credit per item returned
Failed requests cost 0 credits
1,000 free credits
No credit card required
Get Started FreeView Docs
GET /v1/twitter/geo/search
TWITTER
{
  "data": [
    { "id": "place_001", "name": "New York", "woeid": 2459115, "country": "United States", "type": "City" },
    { "id": "place_002", "name": "New York, NY", "woeid": 2459115, "country": "United States", "type": "Admin" }
  ]
}
Endpoints

2 Geo Endpoints

All endpoints return structured JSON and authenticate with your API key in the x-api-key header.

GETSearch Places

Find Twitter place entities by name, coordinates, or IP address. Get WOEIDs for trend lookups and place IDs for geo-tagged tweet analysis.

/v1/twitter/geo/search
GETGet Place Detail

Get complete geographic information for any Twitter place: name, type, country, coordinates, and bounding box for mapping and analysis.

/v1/twitter/geo/places/{place_id}
Cost Calculator

Estimate your geo scraping cost

Failed requests never consume credits, and the exact charge is returned in the X-Credits-Used response header.

Total credits for 1,000 geo requests21,000
Loading plans…
Pricing

Simple, transparent pricing

Start with pay-as-you-go credits (never expire) or save up to 64% with a monthly or annual subscription. No hidden fees, no lock-in.

See full pricing details
FAQ

Frequently asked questions

Everything you need to know about the Twitter Geo API.

What is a Twitter Geo Details Scraper API?

A Twitter Geo Details Scraper API turns Twitter place entities into structured geographic data an application can use. ScrapeBadger's two Geo endpoints let you search for places and retrieve detailed metadata for a specific place ID.

How can I search for a Twitter place?

Search Places supports free-form place names via the query parameter and coordinate-based search via a lat and long pair. The endpoint also supports IP-based location search via the ip parameter and geographic granularity filtering. At least one search method must be provided.

What place data can I retrieve?

Place responses can include the unique place ID, short name, full regional name, country, ISO country code, place type, Twitter place URL, bounding-box type, bounding-box coordinates, and additional attributes.

Which Twitter place types are supported?

Place objects can be classified as city, country, admin, poi, or neighborhood. The granularity filter on Search Places can narrow results to neighborhood, city, admin, or country-level places.

What is the difference between a Twitter place ID and a WOEID?

A place ID identifies a Twitter geographic place entity and is used by the Get Place Details endpoint. A WOEID (Where On Earth ID) is used by the Trends by Location endpoint. These identifiers serve different endpoints and should not be assumed to be interchangeable.

How much does the Twitter Geo API cost?

Every successful Geo request costs 1 base credit plus 1 credit for each place returned. A place-details lookup returns one object and uses 2 credits. A search returning 20 places uses 21 credits. Failed 4xx and 5xx requests use 0 credits, and the exact charge is returned in the X-Credits-Used response header.

Does the Twitter Geo API have rate limits?

Yes. Request-per-minute limits depend on the selected ScrapeBadger plan. See the pricing table for the current limits per plan tier.

More Twitter Data APIs

Tweets APIAdvanced Tweet Search APILists APICommunities APITrends APILive Events APIUsers APITwitter StreamsAll Twitter APIs

Start building with the Geo API

Sign up free and get 1,000 API credits. No credit card required.

Start Free TrialView All Twitter APIs

Disclaimer: ScrapeBadger is not affiliated with, endorsed by, or in any way officially connected with X Corp. (formerly Twitter, Inc.) or any of its subsidiaries or affiliates. The names Twitter, X, and related trademarks are the property of their respective owners.