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

# Search places

`GET /v1/twitter/geo/search`

## Request

- Base URL: `https://scrapebadger.com`
- URL: `https://scrapebadger.com/v1/twitter/geo/search`
- Auth: API key in header `x-api-key`
- TypeScript: <https://skmtc.dev/scrapebadger/apis/scrapebadger-account-api/docs/v1/twitter/geo/search/get.ts> (a function with typed inputs; its response is checked against the schema)

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.dev/scrapebadger/apis/scrapebadger-account-api.md) - [All operations](https://skmtc.dev/scrapebadger/apis/scrapebadger-account-api/llms.txt) - [OpenAPI document](https://skmtc.dev/scrapebadger/apis/scrapebadger-account-api/revisions/4a1ef8777baf?raw)