# Place Search

Canonical URL: https://doc.roote.ai/capabilities/geography/place-search



Search places, businesses, establishments, and points of interest. Place Search is for discovery, not only “find the nearest coffee.”

```http
GET https://api.roote.ai/v1/place-search
```

Examples include `Gare Lyon Part-Dieu`, `Starbucks près de République`, and `pharmacie à Lyon`.

## Request [#request]

```bash
curl "https://api.roote.ai/v1/place-search?q=pharmacie%20%C3%A0%20Lyon&lat=45.7640&lon=4.8357&limit=5" \\
  -H "Authorization: Bearer YOUR_API_TOKEN"
```

| Parameter  | Required | Description                                   |
| ---------- | -------- | --------------------------------------------- |
| `q`        | Yes      | Place, business, establishment, or POI query. |
| `lat`      | No       | Latitude used to bias results.                |
| `lon`      | No       | Longitude used to bias results.               |
| `category` | No       | Category filter where supported.              |
| `limit`    | No       | Maximum number of candidates requested.       |

## Response [#response]

```json
{
  "results": [{
    "roote_id": null,
    "name": "Example Pharmacy",
    "label": "Example Pharmacy, Lyon, France",
    "type": "establishment",
    "location": { "lat": 45.7644, "lon": 4.8361 },
    "address": { "city": "Lyon", "country": "France" },
    "source_id": "google",
    "source_place_id": "provider-place-id"
  }],
  "meta": { "source": "google", "cache": "miss", "total": 1, "query": "pharmacie à Lyon" }
}
```

Results are ordered candidates, not a conversationally selected answer. Use Bearer authentication by default. Invalid queries, incomplete geographic bias, rate limiting, and upstream provider failures return structured errors.