---
title: "Search places"
method: GET
path: "/v1/twitter/geo/search"
tags: ["Geo"]
---

# Search places

`GET /v1/twitter/geo/search`

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.

## Query parameters

- `query` string
- `lat` number, double
- `long` number, double

## Response `200`

Successfully retrieved places.

- PlacesResponse — List of geographic places.
  - `data` PlaceData[], nullable — Array of place objects.
    - `id` string, required — Unique place identifier.
    - `name` string, required — Place name.
    - `full_name` string, nullable — Full place name including region.
    - `country` string, nullable — Country name.
    - `country_code` string, nullable — ISO country code.
    - `place_type` 'city' | 'country' | 'admin' | 'poi' | 'neighborhood', nullable — Type of place.
    - `url` string, nullable — Twitter URL for the place.
    - `bounding_box` object, nullable — Geographical bounding box coordinates.
      - `type` string
      - `coordinates` array[] — Array of coordinate arrays defining the bounding box.
        - array[]
          - number[]
    - `attributes` object, nullable — Additional place attributes.

## Other responses

- `401` — Authentication failed. The API key is missing, invalid, or expired.
- `402` — Insufficient credits. Your account balance has been exhausted. Purchase more credits at https://scrapebadger.com/dashboard/billing.
- `429` — Rate limit exceeded. Too many requests in a given time period. Implement exponential backoff and retry.

---

[API](https://skmtc.net/scrapebadger/apis/scrapebadger-account-api.md) · [All operations](https://skmtc.net/scrapebadger/apis/scrapebadger-account-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/scrapebadger/scrapebadger-account-api/revisions/4a1ef8777baf/schema)