GETplaces

Search Twitter Places & Locations

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

Average response time: 70ms

Code Examples

const response = await fetch(
  'https://scrapebadger.com/v1/twitter/geo/search?query=New+York',
  { headers: { 'x-api-key': 'YOUR_API_KEY' } }
);
const places = await response.json();
places.data.forEach(p => console.log(p.name, p.woeid));
Response
{
  "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" }
  ]
}

API Reference

GET/v1/twitter/geo/search
ParameterTypeRequiredDescription
querystringOptionalPlace name to search for (e.g., "New York")
latnumberOptionalLatitude coordinate
longnumberOptionalLongitude coordinate

Use Cases

Trend Tracking

Detect emerging trends, viral content, and breaking news before they peak using real-time trending topic data.

Market Research

Analyze consumer conversations, product feedback, and market trends to inform product development and go-to-market strategies.

Political Analysis

Study political discourse, election campaigns, policy discussions, and public opinion using large-scale tweet datasets.

Academic Research

Collect large-scale Twitter datasets for computational social science, NLP research, political analysis, and network studies.

Sports Analytics

Track game-day conversations, player mentions, fan sentiment, and sports trends for media companies and betting platforms.

Social Listening

Monitor brand mentions, keywords, and conversations across Twitter in real time to understand public sentiment and emerging topics.

Frequently Asked Questions

Yes. Pass lat and long parameters to search for places near specific coordinates.

Use WOEIDs with the Get Place Trends endpoint to get trending topics for that location.

Twitter recognizes Country, Admin (state/region), City, and Neighborhood as place types.

Use the place ID from this endpoint with Advanced Search to find geo-tagged tweets from that location.