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

Search places

cURL

curl --request GET \
  --url https://scrapebadger.com/v1/twitter/geo/search \
  --header 'x-api-key: <api-key>'

200

{
  "data": [
    {
      "id": "5a110d312052166f",
      "name": "San Francisco",
      "full_name": "San Francisco, CA",
      "country": "United States",
      "country_code": "US",
      "url": "<string>",
      "bounding_box": {
        "type": "Polygon",
        "coordinates": [
          [
            [
              123
            ]
          ]
        ]
      },
      "attributes": {}
    }
  ]
}

Authorizations

x-api-key · string · header · required

Your ScrapeBadger API key. You can find this in your dashboard at https://scrapebadger.com/dashboard/api-keys.

Query Parameters

query · string

Free-form text search for place names.

Example:

"San Francisco"

lat · number<double>

Latitude coordinate for location-based search.

Example:

37.7749

long · number<double>

Longitude coordinate for location-based search.

Example:

-122.4194

Response

200

application/json

Successfully retrieved places.

List of geographic places.

data · object[] | null

Array of place objects.

Show child attributes