# Agoda Hotel Detail API Documentation

<p><strong>Agoda Hotel Detail API Documentation</strong> Retrieve one Agoda hotel: name, public url, property type, star rating, address, coordinates, description, review score and count, up to 30 images with captions, top amenities, facility groups and policies (check-in and check-out times, children, extra beds). An unknown hotel id is a not found error that is not billed.</p>

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

## 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 |
| --- | --- | --- | --- |
| `hotel_id` | integer | Yes | Agoda hotel id from the suggest or search endpoint. Example: 44842960. |

## Example response

```json
{
    "data": {
        "hotel": {
            "id": 44842960,
            "url": "https://www.agoda.com/partners/partnersearch.aspx?hid=44842960",
            "name": "Grande Centre Point Surawong Bangkok",
            "images": [
                {
                    "url": "https://pix8.agoda.net/hotelImages/44842960/0/07e9fedbdbb16fd581b8da4d69ad1b1f.jpeg?va=1&ce=2&s=1024x768",
                    "caption": "Balcony/terrace"
                },
                {
                    "url": "https://pix8.agoda.net/hotelImages/44842960/734493268/bac60c242ab5812461030fa8167876a4.jpeg?va=1&ce=2&s=1024x768",
                    "caption": "Executive King Room - Room plan"
                }
            ],
            "address": {
                "area": "Silom",
                "city": "Bangkok",
                "street": "299 Thanon Surawong",
                "country": "Thailand",
                "postal_code": "10500",
                "country_code": "TH"
            },
            "latitude": 13.725975,
            "policies": {
                "children": [
                    "Infant 0-1 year(s): Stay for free if using existing bedding. Note, if you need a cot, it may incur an extra charge and is subject to availability.",
                    "Children 2-6 year(s): Stay for free if using existing bedding."
                ],
                "extra_bed": [
                    "Extra beds are dependent on the room you choose. Please check the individual room capacity for more details."
                ],
                "additional": [
                    "When booking more than 5 rooms, different policies and additional supplements may apply."
                ],
                "check_in_from": "14:00",
                "check_out_until": "12:00"
            },
            "amenities": [
                "Free Wi-Fi",
                "Pool with view",
                "Free parking",
                "Spa",
                "Front desk [24-hour]",
                "Fitness center",
                "Restaurants",
                "Massage"
            ],
            "longitude": 100.518982,
            "description": "Grande Centre Point Surawong Bangkok is ideal for two travelers, blending urban luxury with a sky pool and city views, Technogym fitness, modern games room, Let's Relax Spa, and wellness areas in a vibrant neighborhood. Grande Centre Point Surawong Bangkok in vibrant Silom offers a perfect mix of nightlife, dining, and shopping. Enjoy air-conditioned rooms, free Wi-Fi, a sparkling pool, steam room, and guided tours. Select accommodations feature breathtaking city views. Nearby attractions include ICONSIAM and Wat Traimit\u2019s Golden Buddha\u2014ideal for two travelers seeking leisure and cultural discovery. [Some content may be Generative AI assisted. Inaccuracies may occur.]",
            "star_rating": 5,
            "review_count": 14999,
            "review_score": 9.3,
            "property_type": "Hotel",
            "facility_groups": [
                {
                    "name": "Take a look at these facilities:",
                    "items": [
                        "Fitness center",
                        "Gym/fitness",
                        "Massage",
                        "Sauna"
                    ]
                },
                {
                    "name": "Languages spoken",
                    "items": [
                        "English",
                        "Chinese [Mandarin]",
                        "Thai"
                    ]
                }
            ]
        }
    },
    "meta": {
        "billable": true,
        "endpoint_family": "hotel_detail"
    },
    "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 | The hotel id is unknown to Agoda. 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)