v1

latestOpenAPI 3.1.02026-07-26180242448.0 KB
Geo

Search places

Search for geographic places that can be attached to tweets. At least one of query, lat/long, or ip must be provided. Results can be filtered by granularity (neighborhood, city, admin, country). Useful for geo-tagging and location-based analysis.

get/v1/twitter/geo/search

Query parameters

querystring
Example:San Francisco

Free-form text search for place names.

latnumber double
Example:37.7749

Latitude coordinate for location-based search.

longnumber double
Example:-122.4194

Longitude coordinate for location-based search.

Response

Successfully retrieved places.

Example response

{
  "data": [
    {
      "id": "5a110d312052166f",
      "name": "San Francisco",
      "full_name": "San Francisco, CA",
      "country": "United States",
      "country_code": "US",
      "bounding_box": {
        "type": "Polygon"
      }
    }
  ]
}