# Agoda Destination Suggest API Documentation

<p><strong>Agoda Destination Suggest API Documentation</strong> Find Agoda destinations by name: for each match the id, name, type (city, area, region, landmark or hotel), city id, city name, country id, country code, number of properties and, for hotels, a public url. Use the city id with the search endpoint and the hotel id with the hotel, rooms and reviews endpoints. A search text without matches is a successful response with an empty list.</p>

- **Documentation:** [https://scrappa.co/docs/agoda-api/agoda_suggest](https://scrappa.co/docs/agoda-api/agoda_suggest)
- **API group:** Agoda API
- **Endpoint:** `GET https://scrappa.co/api/agoda/suggest`

## Authentication

Send your Scrappa API key in the `X-API-KEY` request header. Paid endpoints also support accountless x402 payments when called without an API key.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `query` | string | Yes | Destination or hotel name, 2 to 100 characters. Example: bangkok. |

## Example response

```json
{
    "data": {
        "query": "bangkok",
        "results": [
            {
                "id": 9395,
                "name": "Bangkok",
                "type": "city",
                "city_id": 9395,
                "city_name": "Bangkok",
                "country_id": 106,
                "hotel_count": 12048,
                "country_code": "TH"
            },
            {
                "id": 1,
                "name": "Stay in the heart of Bangkok, Thailand",
                "type": "area",
                "city_id": 9395,
                "city_name": "Bangkok",
                "country_id": 106,
                "hotel_count": 1547,
                "country_code": "TH"
            }
        ]
    },
    "meta": {
        "billable": true,
        "endpoint_family": "destination_suggest"
    },
    "success": true
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | A required query parameter is missing or invalid. This response is not billable. |
| 404 | Resource Not Found | A search text never produces this error; an empty list is a successful response. This response is not billable. |
| 503 | Service Unavailable | Agoda could not be reached or answered with an unexpected shape. This response is not billable. |

## More Scrappa resources

- [API documentation](https://scrappa.co/docs)
- [Full LLM-readable API reference](https://scrappa.co/llms-full.txt)
- [OpenAPI specification](https://scrappa.co/docs/api.json)
- [Pricing](https://scrappa.co/pricing)