---
type: "firecrawl-provider"
description: "Agoda accommodation: destination, landmark and property suggestions, dated property search near a landmark or in a city with per-night and stay prices (tax-exclusive and tax-inclusive), the dated room grid of one property with room types, tax-included stay totals, tax and fee lines and cancellation terms, paginated guest reviews with score breakdown, property FAQ and top destinations, over Agoda's own site API (GraphQL search and the cronos JSON API)."
use_when: "Agoda accommodation: destination, landmark and property suggestions, dated property search near a landmark or in a city with per-night and stay prices (tax-exclusive and tax-inclusive), the dated room grid of one property with room types, tax-included stay totals, tax and fee lines and cancellation terms, paginated guest reviews with score breakdown, property FAQ and top destinations, over Agoda's own site API (GraphQL search and the cronos JSON API)."
categories: "Travel"
capabilities: 6
credits_per_call: 5
---
# Agoda stays on Firecrawl Alexandria

Agoda accommodation: destination, landmark and property suggestions, dated property search near a landmark or in a city with per-night and stay prices (tax-exclusive and tax-inclusive), the dated room grid of one property with room types, tax-included stay totals, tax and fee lines and cancellation terms, paginated guest reviews with score breakdown, property FAQ and top destinations, over Agoda's own site API (GraphQL search and the cronos JSON API).

- Categories: Travel
- Category index: [Travel category](https://firecrawl.dev/alexandria/agents/categories/travel)
- Provider key: `agoda-com`
- Access: Firecrawl credits
- Cost: 5 credits per call

## More

- [Human guide](https://firecrawl.dev/app/alexandria/agoda-com)
- [OpenAPI spec](https://firecrawl.dev/alexandria/agents/providers/agoda-com/openapi.json)

## Capabilities

- [Property faq](https://firecrawl.dev/alexandria/agents/providers/agoda-com/hotels/property_faq): Agoda's generated FAQ for one property (facilities, nearby places, average rates, policies). Questions keep Agoda's '[hotel_name]' placeholder; answers are rendered. An empty list for a known property is an empty success; an unknown id is not_found.
- [Property reviews](https://firecrawl.dev/alexandria/agents/providers/agoda-com/hotels/property_reviews): Guest reviews of one property from Agoda's HotelReviews: per-provider counts (332 = Agoda's verified guests, 3038 = Booking.com, ...), the overall score with sub-scores and city averages, and a page of review cards (rating, title, text, stay month, traveller group, room type, hotel response). Agoda returns `page_size` reviews per provider interleaved; `provider_id` keeps one provider only (332 for Agoda-only).
- [Property rooms](https://firecrawl.dev/alexandria/agents/providers/agoda-com/hotels/property_rooms): The dated room grid of one property from Agoda's GetSecondaryData: property identity and address, and every room type with its offers: per-night price excluding and including taxes and fees, the whole-stay total excluding and including taxes and fees, the tax and fee lines (e.g. 'Service charge 5%', 'Tax 8%'), cancellation title, policy text and deadline code, breakfast, book-on-request and rooms left, in the requested currency.
- [Search](https://firecrawl.dev/alexandria/agents/providers/agoda-com/hotels/search): Dated property listing near a landmark (`landmark_id`) or in a city (`city_id`) through Agoda's GraphQL landmarkSearch / citySearch: name, stars, type, page URL, address, coordinates, overall and Agoda-only review score and count, availability, cancellation type and free-cancellation deadline, and the cheapest offer's per-night and whole-stay price both excluding and including taxes and fees, in the requested currency. Paginated by `page`.
- [Suggest](https://firecrawl.dev/alexandria/agents/providers/agoda-com/hotels/suggest): Agoda's search-box suggestions for a free-text query: cities, areas, landmarks, airports and properties with their Agoda ids. Landmark and city ids feed `search`; property ids feed `property_rooms`, `property_reviews` and `property_faq`.
- [Top destinations](https://firecrawl.dev/alexandria/agents/providers/agoda-com/hotels/top_destinations): Agoda's most popular destination cities for travellers from an origin country (international or domestic), with city ids, country and property counts.

## 1. Choose this provider when

Agoda accommodation: destination, landmark and property suggestions, dated property search near a landmark or in a city with per-night and stay prices (tax-exclusive and tax-inclusive), the dated room grid of one property with room types, tax-included stay totals, tax and fee lines and cancellation terms, paginated guest reviews with score breakdown, property FAQ and top destinations, over Agoda's own site API (GraphQL search and the cronos JSON API).

## 2. Minimal request

Call `POST https://api.firecrawl.dev/v2/scrape` with `{ alexandria: { provider, capability, options } }`. For a batch, send `{ alexandria: [...] }` with up to 10 calls.

```json
{
  "provider": "agoda-com",
  "capability": "hotels/property_faq",
  "options": {
    "property_id": 6428322
  }
}
```

## 3. Add provider options

Use only the options needed for the task:

- `property_id` (number, required): property_id Example: `10`

## 4. Request through your preferred interface

### JavaScript

```javascript
const result = await firecrawl.scrape({
  alexandria: {
    provider: "agoda-com",
    capability: "hotels/property_faq",
    options: {
      property_id: 6428322,
    },
  },
});
```

### Python

```python
result = firecrawl.scrape_alexandria({
  "provider": "agoda-com",
  "capability": "hotels/property_faq",
  "options": {
    "property_id": 6428322
  }
})
```

### cURL

```sh
curl https://api.firecrawl.dev/v2/scrape \
  -H "Authorization: Bearer $FIRECRAWL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "alexandria": {
    "provider": "agoda-com",
    "capability": "hotels/property_faq",
    "options": {
      "property_id": 6428322
    }
  }
}'
```

### CLI

```sh
firecrawl scrape 'agoda-com/hotels/property_faq' \
  --options '{"property_id":6428322}'
```


### MCP

Call the FCX MCP retrieve tool with this object:

```json
{
  "provider": "agoda-com",
  "capability": "hotels/property_faq",
  "options": {
    "property_id": 6428322
  }
}
```

Ask for only the returned fields needed by the task.

## 5. Full request shape

```json
{
  "provider": "agoda-com",
  "capability": "hotels/property_faq",
  "options": {
    "property_id": 6428322
  }
}
```

## 6. Response data

The response includes `success`, `provider`, `capability`, `creditsCost` and `data`. This example shows the provider payload in `data`:

```json
{
  "count": 24,
  "faqs": [
    {
      "answer": "Yes, Wi-Fi is free for guests in all rooms.",
      "category": "faq_property_ai",
      "question": "Is Wi-Fi free for guests staying at [hotel_name]?",
      "question_id": "2693424182018824730"
    },
    {
      "answer": "Yes, [hotel_name] offers airport transfer services.",
      "category": "faq_property_ai",
      "question": "Does [hotel_name] offer airport shuttle services for guests?",
      "question_id": "7826445557904495153"
    },
    {
      "answer": "Yes, [hotel_name] can host private events and weddings.",
      "category": "faq_property_ai",
      "question": "Can I host a private event or wedding at [hotel_name]?",
      "question_id": "8512895814334009277"
    },
    {
      "answer": "Yes, [hotel_name] offers laundry service and dry cleaning.",
      "category": "faq_property_ai",
      "question": "Are there laundry or dry cleaning services available at [hotel_name]?",
      "question_id": "750611257279865168"
    },
    {
      "answer": "Yes, [hotel_name] offers 24-hour room service.",
      "category": "faq_property_ai",
      "question": "Is room service available 24 hours a day at [hotel_name]?",
      "question_id": "4659003686923596322"
    },
    {
      "answer": "It is about 7.34 km from Tan Son Nhat International Airport.",
      "category": "faq_property_ai",
      "question": "How far is [hotel_name] from Tan Son Nhat International Airport?",
      "question_id": "8855237569191954198"
    },
    {
      "answer": "You can use local taxis or public transport to reach the central areas of Ho Chi Minh City.",
      "category": "faq_property_ai",
      "question": "How do I get from [hotel_name] to the city center of Ho Chi Minh City?",
      "question_id": "4146026016486935324"
    },
    {
      "answer": "Yes, [hotel_name] has 1 on-site restaurant.",
      "category": "faq_property_ai",
      "question": "Are there any restaurants located inside [hotel_name]?",
      "question_id": "8158969032232232535"
    },
    {
      "answer": "Yes, [hotel_name] has a 24-hour fitness center.",
      "category": "faq_property_ai",
      "question": "Is there a fitness center or gym available at [hotel_name]?",
      "question_id": "6271134829599520267"
    },
    {
      "answer": "Check-in is at 03:00 PM and check-out is at 12:00 PM.",
      "category": "faq_property_ai",
      "question": "What is the check-in and check-out time at [hotel_name]?",
      "question_id": "6951085247325714415"
    },
    {
      "answer": "Yes, [hotel_name] has facilities for disabled guests.",
      "category": "faq_property_ai",
      "question": "Does [hotel_name] have facilities for disabled guests?",
      "question_id": "8846782771755474688"
    },
    {
      "answer": "Staff speak Chinese (Mandarin), English, German, and Vietnamese.",
      "category": "faq_property_ai",
      "question": "What languages are spoken by the staff at [hotel_name]?",
      "question_id": "602331305106574607"
    },
    {
      "answer": "Yes, [hotel_name] has meeting/banquet facilities and conference/event spaces.",
      "category": "faq_property_ai",
      "question": "Does [hotel_name] have meeting rooms or a business center?",
      "question_id": "2053607081444234597"
    },
    {
      "answer": "Yes, [hotel_name] has a bar.",
      "category": "faq_property_ai",
      "question": "Does [hotel_name] have a lounge or bar with evening drinks?",
      "question_id": "4051704648923431510"
    },
    {
      "answer": "Yes, [hotel_name] offers non-smoking rooms.",
      "category": "faq_property_ai",
      "question": "Are there non-smoking rooms available at [hotel_name]?",
      "question_id": "7808229818516718108"
    },
    {
      "answer": "Yes, a cot is available and is free.",
      "category": "faq_property_ai",
      "question": "Does [hotel_name] provide baby cots or cribs?",
      "question_id": "1653145287590626707"
    },
    {
      "answer": "Yes, [hotel_name] offers luggage storage.",
      "category": "faq_property_ai",
      "question": "Can I store my luggage at [hotel_name] before check-in or after check-out?",
      "question_id": "5446967186981864139"
    },
    {
      "answer": "Yes, [hotel_name] has on-site parking, including self-parking.",
      "category": "faq_property_ai",
      "question": "Does [hotel_name] offer parking for guests?",
      "question_id": "7952195787233690494"
    },
    {
      "answer": "Free early check-in and late check-out up to 04:00 PM are subject to room availability and not on Public holidays.",
      "category": "faq_property_ai",
      "question": "Does [hotel_name] offer early check-in or late check-out?",
      "question_id": "3080036221851799003"
    },
    {
      "answer": "Yes, [hotel_name] has a 24-hour front desk.",
      "category": "faq_property_ai",
      "question": "Does [hotel_name] have 24-hour front desk service?",
      "question_id": "5400472376824850631"
    },
    {
      "answer": "Yes, [hotel_name] has a concierge.",
      "category": "faq_property_ai",
      "question": "Is there a concierge desk at [hotel_name] to help with tour bookings?",
      "question_id": "3851269170005741729"
    },
    {
      "answer": "Yes, [hotel_name] has an elevator.",
      "category": "faq_property_ai",
      "question": "Does [hotel_name] have an elevator?",
      "question_id": "3601826662763237291"
    },
    {
      "answer": "Breakfast is available as a continental breakfast, breakfast takeaway service, and a breakfast buffet.",
      "category": "faq_property_ai",
      "question": "What type of breakfast is served at [hotel_name]?",
      "question_id": "4200349630729001574"
    },
    {
      "answer": "Yes, [hotel_name] offers currency exchange services.",
      "category": "faq_property_ai",
      "question": "Does [hotel_name] have currency exchange services on-site?",
      "question_id": "205844416246297617"
    }
  ],
  "observed_at_ms": 1792518182554,
  "property_id": 6428322,
  "source_url": "https://www.agoda.com/search?hotel=6428322&selectedproperty=6428322"
}
```

## API reference-derived contract

The following capability contract is generated from the same normalized Alexandria API reference exposed in the API spec.

### Property faq

- Capability: `hotels/property_faq`
- Description: Agoda's generated FAQ for one property (facilities, nearby places, average rates, policies). Questions keep Agoda's '[hotel_name]' placeholder; answers are rendered. An empty list for a known property is an empty success; an unknown id is not_found.
- Instructions: Quick facts and policy Q&A for a known property id.
- Cost: 5 credits per call
- Capability file: [Property faq](https://firecrawl.dev/alexandria/agents/providers/agoda-com/hotels/property_faq)

Accepted options:
- `property_id` (number, required): property_id Example: `10`

Response schema example:
```json
{
  "count": 24,
  "faqs": [
    {
      "answer": "Yes, Wi-Fi is free for guests in all rooms.",
      "category": "faq_property_ai",
      "question": "Is Wi-Fi free for guests staying at [hotel_name]?",
      "question_id": "2693424182018824730"
    },
    {
      "answer": "Yes, [hotel_name] offers airport transfer services.",
      "category": "faq_property_ai",
      "question": "Does [hotel_name] offer airport shuttle services for guests?",
      "question_id": "7826445557904495153"
    },
    {
      "answer": "Yes, [hotel_name] can host private events and weddings.",
      "category": "faq_property_ai",
      "question": "Can I host a private event or wedding at [hotel_name]?",
      "question_id": "8512895814334009277"
    },
    {
      "answer": "Yes, [hotel_name] offers laundry service and dry cleaning.",
      "category": "faq_property_ai",
      "question": "Are there laundry or dry cleaning services available at [hotel_name]?",
      "question_id": "750611257279865168"
    },
    {
      "answer": "Yes, [hotel_name] offers 24-hour room service.",
      "category": "faq_property_ai",
      "question": "Is room service available 24 hours a day at [hotel_name]?",
      "question_id": "4659003686923596322"
    },
    {
      "answer": "It is about 7.34 km from Tan Son Nhat International Airport.",
      "category": "faq_property_ai",
      "question": "How far is [hotel_name] from Tan Son Nhat International Airport?",
      "question_id": "8855237569191954198"
    },
    {
      "answer": "You can use local taxis or public transport to reach the central areas of Ho Chi Minh City.",
      "category": "faq_property_ai",
      "question": "How do I get from [hotel_name] to the city center of Ho Chi Minh City?",
      "question_id": "4146026016486935324"
    },
    {
      "answer": "Yes, [hotel_name] has 1 on-site restaurant.",
      "category": "faq_property_ai",
      "question": "Are there any restaurants located inside [hotel_name]?",
      "question_id": "8158969032232232535"
    },
    {
      "answer": "Yes, [hotel_name] has a 24-hour fitness center.",
      "category": "faq_property_ai",
      "question": "Is there a fitness center or gym available at [hotel_name]?",
      "question_id": "6271134829599520267"
    },
    {
      "answer": "Check-in is at 03:00 PM and check-out is at 12:00 PM.",
      "category": "faq_property_ai",
      "question": "What is the check-in and check-out time at [hotel_name]?",
      "question_id": "6951085247325714415"
    },
    {
      "answer": "Yes, [hotel_name] has facilities for disabled guests.",
      "category": "faq_property_ai",
      "question": "Does [hotel_name] have facilities for disabled guests?",
      "question_id": "8846782771755474688"
    },
    {
      "answer": "Staff speak Chinese (Mandarin), English, German, and Vietnamese.",
      "category": "faq_property_ai",
      "question": "What languages are spoken by the staff at [hotel_name]?",
      "question_id": "602331305106574607"
    },
    {
      "answer": "Yes, [hotel_name] has meeting/banquet facilities and conference/event spaces.",
      "category": "faq_property_ai",
      "question": "Does [hotel_name] have meeting rooms or a business center?",
      "question_id": "2053607081444234597"
    },
    {
      "answer": "Yes, [hotel_name] has a bar.",
      "category": "faq_property_ai",
      "question": "Does [hotel_name] have a lounge or bar with evening drinks?",
      "question_id": "4051704648923431510"
    },
    {
      "answer": "Yes, [hotel_name] offers non-smoking rooms.",
      "category": "faq_property_ai",
      "question": "Are there non-smoking rooms available at [hotel_name]?",
      "question_id": "7808229818516718108"
    },
    {
      "answer": "Yes, a cot is available and is free.",
      "category": "faq_property_ai",
      "question": "Does [hotel_name] provide baby cots or cribs?",
      "question_id": "1653145287590626707"
    },
    {
      "answer": "Yes, [hotel_name] offers luggage storage.",
      "category": "faq_property_ai",
      "question": "Can I store my luggage at [hotel_name] before check-in or after check-out?",
      "question_id": "5446967186981864139"
    },
    {
      "answer": "Yes, [hotel_name] has on-site parking, including self-parking.",
      "category": "faq_property_ai",
      "question": "Does [hotel_name] offer parking for guests?",
      "question_id": "7952195787233690494"
    },
    {
      "answer": "Free early check-in and late check-out up to 04:00 PM are subject to room availability and not on Public holidays.",
      "category": "faq_property_ai",
      "question": "Does [hotel_name] offer early check-in or late check-out?",
      "question_id": "3080036221851799003"
    },
    {
      "answer": "Yes, [hotel_name] has a 24-hour front desk.",
      "category": "faq_property_ai",
      "question": "Does [hotel_name] have 24-hour front desk service?",
      "question_id": "5400472376824850631"
    },
    {
      "answer": "Yes, [hotel_name] has a concierge.",
      "category": "faq_property_ai",
      "question": "Is there a concierge desk at [hotel_name] to help with tour bookings?",
      "question_id": "3851269170005741729"
    },
    {
      "answer": "Yes, [hotel_name] has an elevator.",
      "category": "faq_property_ai",
      "question": "Does [hotel_name] have an elevator?",
      "question_id": "3601826662763237291"
    },
    {
      "answer": "Breakfast is available as a continental breakfast, breakfast takeaway service, and a breakfast buffet.",
      "category": "faq_property_ai",
      "question": "What type of breakfast is served at [hotel_name]?",
      "question_id": "4200349630729001574"
    },
    {
      "answer": "Yes, [hotel_name] offers currency exchange services.",
      "category": "faq_property_ai",
      "question": "Does [hotel_name] have currency exchange services on-site?",
      "question_id": "205844416246297617"
    }
  ],
  "observed_at_ms": 1792518182554,
  "property_id": 6428322,
  "source_url": "https://www.agoda.com/search?hotel=6428322&selectedproperty=6428322"
}
```

### Property reviews

- Capability: `hotels/property_reviews`
- Description: Guest reviews of one property from Agoda's HotelReviews: per-provider counts (332 = Agoda's verified guests, 3038 = Booking.com, ...), the overall score with sub-scores and city averages, and a page of review cards (rating, title, text, stay month, traveller group, room type, hotel response). Agoda returns `page_size` reviews per provider interleaved; `provider_id` keeps one provider only (332 for Agoda-only).
- Instructions: Review text and score breakdown for a known property id; Agoda-only counts with provider_id 332.
- Cost: 5 credits per call
- Capability file: [Property reviews](https://firecrawl.dev/alexandria/agents/providers/agoda-com/hotels/property_reviews)

Accepted options:
- `page` (number): page Example: `1`
- `page_size` (number): Reviews per provider per page. Example: `10`
- `property_id` (number, required): property_id Example: `10`
- `provider_id` (number): Keep reviews from this provider only (332 = Agoda). Omit for every provider Agoda returns. Example: `10`
- `sort` (string): sort Example: `most_recent`

Response schema example:
```json
{
  "combined_score": null,
  "count": 5,
  "name": "Vinpearl Landmark 81, Autograph Collection",
  "next_page": 2,
  "observed_at_ms": 1792518176797,
  "page": 1,
  "page_size": 5,
  "property_id": 6428322,
  "provider_id": 332,
  "providers": [
    {
      "is_default": true,
      "name": "Agoda",
      "provider_id": 332,
      "review_count": 514
    },
    {
      "is_default": false,
      "name": "Booking.com",
      "provider_id": 3038,
      "review_count": 261
    }
  ],
  "review_page_url": "https://www.agoda.com/vinpearl-landmark-81-autograph-collection/reviews/ho-chi-minh-city-vn.html",
  "reviews": [
    {
      "check_in_date": "2026-09-11T00:00:00+07:00",
      "helpful_votes": 0,
      "length_of_stay": 3,
      "negatives": null,
      "positives": null,
      "provider_id": 332,
      "provider_name": "Agoda",
      "rating": 10,
      "rating_text": "Exceptional",
      "response": {
        "date": "2026-09-28T10:14:06.648+07:00",
        "responder": "Vinpearl Landmark 81, Autograph Collection",
        "text": "Dear Guest,\nThank you for your wonderful review and for choosing Vinpearl Landmark 81, Autograph Collection.\n\nWe are truly honored to hear that, among the many 5-star hotels you have experienced in Ho Chi Minh City, your stay with us stands out as the best. Your recognition means a great deal to our entire team.\n\nWe are especially delighted that our service was the highlight of your visit. Delivering warm, personalized, and memorable hospitality is at the heart of everything we do, and it is rewarding to know that our associates made such a positive impression. We are also pleased that you enjoyed our modern facilities and well-appointed amenities, designed to provide both comfort and convenience throughout your stay.\n\nThank you once again for your kind words and recommendation. We are thrilled to know that we have earned your trust, and we look forward to welcoming you back to Vinpearl Landmark 81, Autograph Collection on your next trip to Ho Chi Minh City.\n\nWarm regards,\nVinpearl L"
      },
      "review_date": "2026-09-15T03:07:21+07:00",
      "review_id": 1180094955,
      "reviewer_country": "Australia",
      "reviewer_group": "Family with teens",
      "room_type": "Premier room, Sky view, Guest room, 2 Twin",
      "text": "I've stayed at many different 5 star hotels in Ho Chi  Minh City, this has to be the best that I've experienced. The service is amazing, and is the highlight of this hotel stay. Facilities are very modern and well equipped. I'll definitely come back to Vinpearl Landmark 81 on my next trip",
      "title": "Exceptional",
      "translated_from": "en"
    },
    {
      "check_in_date": "2026-09-06T00:00:00+07:00",
      "helpful_votes": 0,
      "length_of_stay": 2,
      "negatives": null,
      "positives": null,
      "provider_id": 332,
      "provider_name": "Agoda",
      "rating": 9.2,
      "rating_text": "Exceptional",
      "response": {
        "date": "2026-09-14T12:46:55.07+07:00",
        "responder": "Vinpearl Landmark 81, Autograph Collection",
        "text": "Dear Guest,\nThank you for your exceptional review and, most importantly, for choosing to return to Vinpearl Landmark 81, Autograph Collection for a third visit.\n\nWe are truly delighted to know that you love everything about your experience with us. It is wonderful to hear that you enjoyed our clean and comfortable rooms, extensive facilities, convenient access to the shopping mall, and the attentive service provided by our associates. We are especially pleased that our buffet breakfast, complemented by the spectacular sky views, helped make your stay even more memorable.\n\nYour continued loyalty and kind words mean a great deal to our team. Knowing that each visit remains a wonderful experience is the highest compliment we could receive.\n\nWe sincerely appreciate your support and look forward to welcoming you back for a fourth memorable stay in the near future.\n\nWarm regards,\nVinpearl Landmark 81, Autograph Collection"
      },
      "review_date": "2026-09-12T10:28:14+07:00",
      "review_id": 1179355580,
      "reviewer_country": "Australia",
      "reviewer_group": "Couple",
      "room_type": "Premier room, Sky view, Guest room, 2 Twin",
      "text": "Love everything about this place. Its our third time back. The rooms are clean. I love all the facilities. There is a shopping mall directly next to the hotel where you can access through the lobby. Staff are fantastic. I also love the buffet breakfast with the sky view. Its just wonderful to be here.",
      "title": "Exceptional",
      "translated_from": "en"
    },
    {
      "check_in_date": "2026-08-28T00:00:00+07:00",
      "helpful_votes": 0,
      "length_of_stay": 2,
      "negatives": null,
      "positives": null,
      "provider_id": 332,
      "provider_name": "Agoda",
      "rating": 10,
      "rating_text": "Exceptional",
      "response": {
        "date": "2026-09-14T12:46:06.159+07:00",
        "responder": "Vinpearl Landmark 81, Autograph Collection",
        "text": "Dear Guest,\nThank you for choosing Vinpearl Landmark 81, Autograph Collection once again and for sharing your wonderful feedback.\n\nWe are truly honored to know that your second stay with us was both excellent and memorable. Your comment that \"everything is perfect\" is incredibly rewarding for our entire team and serves as great motivation for us to continue delivering exceptional experiences.\n\nIt is always a pleasure to welcome returning guests, and we sincerely appreciate your continued trust and support. We look forward to creating many more memorable moments with you on your next visit.\n\nWarm regards,\nVinpearl Landmark 81, Autograph Collection"
      },
      "review_date": "2026-09-03T10:09:14+07:00",
      "review_id": 1175606161,
      "reviewer_country": "Malaysia",
      "reviewer_group": "Couple",
      "room_type": "Premier room, Panoramic, Guest room, 1 King",
      "text": "Second time stayed at this hotel. Everything is perfect",
      "title": "Excellent & Memorable Stay",
      "translated_from": "en"
    },
    {
      "check_in_date": "2026-08-28T00:00:00+07:00",
      "helpful_votes": 0,
      "length_of_stay": 2,
      "negatives": null,
      "positives": null,
      "provider_id": 332,
      "provider_name": "Agoda",
      "rating": 10,
      "rating_text": "Exceptional",
      "response": {
        "date": "2026-09-14T12:44:23.638+07:00",
        "responder": "Vinpearl Landmark 81, Autograph Collection",
        "text": "Dear Guest,\nThank you for taking the time to share your feedback.\n\nWe are delighted to know that you found Vinpearl Landmark 81, Autograph Collection to be a very good place to stay. We truly appreciate your recognition of the experience we strive to provide.\n\nAt the same time, we understand your concerns regarding the pricing and appreciate your honest comments. We continuously work to deliver exceptional service, facilities, and memorable experiences that reflect the value of staying at one of Ho Chi Minh City's landmark destinations.\n\nThank you once again for your valuable feedback. We hope to have the pleasure of welcoming you back for an even more enjoyable stay in the future.\n\nWarm regards,\nVinpearl Landmark 81, Autograph Collection"
      },
      "review_date": "2026-09-02T07:55:15+07:00",
      "review_id": 1175045857,
      "reviewer_country": "Philippines",
      "reviewer_group": "Couple",
      "room_type": "Premier room, Sky view, Guest room, 2 Twin",
      "text": "Very good place to stay though expensive for an ordinary traveler.",
      "title": "Feedback",
      "translated_from": "en"
    },
    {
      "check_in_date": "2026-08-20T00:00:00+07:00",
      "helpful_votes": 0,
      "length_of_stay": 2,
      "negatives": null,
      "positives": null,
      "provider_id": 332,
      "provider_name": "Agoda",
      "rating": 9.2,
      "rating_text": "Exceptional",
      "response": {
        "date": "2026-09-14T11:29:41.42+07:00",
        "responder": "Vinpearl Landmark 81, Autograph Collection",
        "text": "Dear Guest,\nThank you for sharing your feedback and for highlighting our location as the best in Ho Chi Minh City. We are delighted that you enjoyed the convenience and unique setting of Vinpearl Landmark 81, Autograph Collection.\n\nAt the same time, we sincerely regret that our breakfast buffet did not meet your expectations. We appreciate your candid comments regarding the variety and quality of the offerings, especially in comparison with your experience at Vinpearl Phu Quoc. Your observations have been shared with our culinary team for review as we continuously seek ways to enhance our breakfast experience and better cater to our guests' preferences.\n\nThank you once again for your valuable feedback. We hope to have the opportunity to welcome you back and provide an even more satisfying dining experience on your next visit.\n\nWarm regards,\nVinpearl Landmark 81, Autograph Collection"
      },
      "review_date": "2026-08-26T10:58:12+07:00",
      "review_id": 1171430634,
      "reviewer_country": "Malaysia",
      "reviewer_group": "Family with young children",
      "room_type": "Premier room, Panoramic, Guest room, 2 Twin",
      "text": "Just sad with the Breakfast, it was too basic buffet like all other Hotels, Vinpearl in Phu Quoc has better option in breakfast.",
      "title": "Best location in HCMC",
      "translated_from": "en"
    }
  ],
  "score": {
    "grades": [
      {
        "city_average": 8.4,
        "id": "cleanliness",
        "name": "Cleanliness",
        "score": 9.5
      },
      {
        "city_average": 8,
        "id": "facilities",
        "name": "Facilities",
        "score": 9.2
      },
      {
        "city_average": 8.1,
        "id": "location",
        "name": "Location",
        "score": 9.1
      },
      {
        "city_average": 8.4,
        "id": "staffPerformance",
        "name": "Service",
        "score": 9.3
      },
      {
        "city_average": 8.3,
        "id": "valueForMoney",
        "name": "Value for money",
        "score": 9
      }
    ],
    "max_score": 10,
    "provider_id": 332,
    "review_count": 1915,
    "score": 8.9,
    "text": "Excellent"
  },
  "sort": "most_recent",
  "source_url": "https://www.agoda.com/search?hotel=6428322&selectedproperty=6428322&tab=reviews"
}
```

### Property rooms

- Capability: `hotels/property_rooms`
- Description: The dated room grid of one property from Agoda's GetSecondaryData: property identity and address, and every room type with its offers: per-night price excluding and including taxes and fees, the whole-stay total excluding and including taxes and fees, the tax and fee lines (e.g. 'Service charge 5%', 'Tax 8%'), cancellation title, policy text and deadline code, breakfast, book-on-request and rooms left, in the requested currency.
- Instructions: Exact-date, room-type-level, tax-inclusive totals with cancellation terms for a known property id.
- Cost: 5 credits per call
- Capability file: [Property rooms](https://firecrawl.dev/alexandria/agents/providers/agoda-com/hotels/property_rooms)

Accepted options:
- `adults` (number): adults Example: `2`
- `check_in` (string): Check-in date YYYY-MM-DD, today or later. Default: 30 days from today. Pattern: ^[0-9]{4}-[0-9]{2}-[0-9]{2}$. Example: `<check_in>`
- `children` (number): children Example: `0`
- `currency` (string): Pattern: ^[A-Za-z]{3}$. Example: `USD`
- `nights` (number): nights Example: `1`
- `property_id` (number, required): Agoda property id (hotel id) from `suggest` or `search`. Example: `10`
- `rooms` (number): rooms Example: `1`

Response schema example:
```json
{
  "accommodation_type": "Entire House",
  "address": {
    "area": "Bình Thạnh",
    "city": "Ho Chi Minh City",
    "city_id": 13170,
    "country": "Vietnam",
    "country_id": 38,
    "full": "Bình Thạnh, Ho Chi Minh City, Vietnam",
    "postal_code": null,
    "street": "720A Điện Biên Phủ, Khu phố 5, Thạnh Mỹ Tây, Hồ Chí Minh, Việt Nam"
  },
  "adults": 2,
  "check_in": "2026-11-19",
  "check_out": "2026-11-21",
  "child_policies": [
    {
      "description": "Stay for free if using existing bedding. Note, if you need a cot, it may incur an extra charge and is subject to availability.",
      "is_infant": true,
      "policy": "Infant 0-2 year(s)"
    },
    {
      "description": "Stay for free if using existing bedding.",
      "is_infant": false,
      "policy": "Children 3-7 year(s)"
    }
  ],
  "children": 0,
  "currency": "USD",
  "english_name": "Landmark Plus 1BR - w/ Bathtub",
  "is_data_ready": true,
  "is_nha": true,
  "latitude": 10.79514915563495,
  "longitude": 106.72241646964196,
  "name": "Landmark Plus 1BR - w/ Bathtub",
  "nights": 2,
  "observed_at_ms": 1792518170815,
  "offer_count": 1,
  "property_id": 96461587,
  "room_type_count": 1,
  "room_types": [
    {
      "amenities": [
        "Air conditioning",
        "In-room safe box",
        "Shower",
        "TV",
        "Wi-Fi [free]"
      ],
      "bed_summary": "1 queen bed",
      "cheapest_price": 30.57,
      "image_url": "https://pix8.agoda.net/hotelImages/96461587/0/5cdf898d21f0979fd42164229a9b6267.jpg?ce=3&s=208x117&ar=16x9",
      "is_dormitory": false,
      "max_extra_beds": 0,
      "max_occupancy": 2,
      "name": "home",
      "number_of_beds": "1 bed",
      "offers": [
        {
          "benefits": [
            "Free WiFi"
          ],
          "book_on_request": true,
          "booking_key": "1599678667|False|False|False|2|30.57",
          "breakfast_included": false,
          "cancellation_code": "5D100P_100P",
          "cancellation_description": "Stay flexible! Cancel for free before November 14, 2026 Any cancellation received within 5 days prior to the arrival date will be charged for the entire stay. Failure to arrive at your hotel or property will be treated as a No-Show and will incur a charge of 100% of the booking value (Hotel policy).",
          "cancellation_title": "Cancel for free before November 14, 2026",
          "currency": "USD",
          "free_cancellation": true,
          "max_occupancy": 2,
          "name": "home",
          "occupancy": 2,
          "offer_uid": "981efa0b-529e-2191-7e68-70994ae3e637",
          "per_night_exclusive": 30.57,
          "per_night_inclusive": 33.02,
          "rate_plan_id": 24412185,
          "rooms_left": 1,
          "supplier_id": 332,
          "supplier_name": "Agoda.com",
          "taxes_and_fees": 4.9,
          "taxes_and_surcharges": [
            "Service charge 5%",
            "Tax 8%"
          ],
          "total_exclusive": 61.14,
          "total_inclusive": 66.04,
          "total_pay_at_property": null,
          "urgency_message": "Our last room!"
        }
      ],
      "room_type_id": 1599678667
    }
  ],
  "rooms": 1,
  "source_url": "https://www.agoda.com/search?hotel=96461587&selectedproperty=96461587&checkIn=2026-11-19&los=2&rooms=1&adults=2&children=0&currency=USD",
  "star_rating": 1.5,
  "taxes_and_surcharges": "Service charge 5%, Tax 8%"
}
```

### Search

- Capability: `hotels/search`
- Description: Dated property listing near a landmark (`landmark_id`) or in a city (`city_id`) through Agoda's GraphQL landmarkSearch / citySearch: name, stars, type, page URL, address, coordinates, overall and Agoda-only review score and count, availability, cancellation type and free-cancellation deadline, and the cheapest offer's per-night and whole-stay price both excluding and including taxes and fees, in the requested currency. Paginated by `page`.
- Instructions: Compare properties for exact dates and guests; get property ids for the detail functions.
- Cost: 5 credits per call
- Capability file: [Search](https://firecrawl.dev/alexandria/agents/providers/agoda-com/hotels/search)

Accepted options:
- `adults` (number): adults Example: `2`
- `check_in` (string): Check-in date YYYY-MM-DD, today or later. Default: 30 days from today. Pattern: ^[0-9]{4}-[0-9]{2}-[0-9]{2}$. Example: `<check_in>`
- `child_ages` (number[]): One age per child; defaults to 8 for each child when omitted (Agoda's own default child age). Example: `[]`
- `children` (number): children Example: `0`
- `city_id` (number): Agoda city id from `suggest` (kind city, or the city_id of any suggestion). With `landmark_id` it only scopes content; alone it searches the whole city. Example: `10`
- `currency` (string): Pattern: ^[A-Za-z]{3}$. Example: `USD`
- `landmark_id` (number): Agoda landmark id from `suggest` (kind landmark). Either this or `city_id`. Example: `10`
- `nights` (number): nights Example: `1`
- `page` (number): page Example: `1`
- `page_size` (number): Agoda may add sponsored rows on top of the requested size. Example: `20`
- `rooms` (number): rooms Example: `1`
- `sort` (string): sort Example: `recommended`

Response schema example:
```json
{
  "adults": 2,
  "check_in": "2026-11-19",
  "check_out": "2026-11-21",
  "children": 0,
  "city_id": 13170,
  "city_name": "Ho Chi Minh City",
  "count": 11,
  "currency": "USD",
  "is_complete": true,
  "landmark_id": 1518284,
  "next_page": 2,
  "nights": 2,
  "observed_at_ms": 1792518164746,
  "page": 1,
  "page_size": 10,
  "properties": [
    {
      "accommodation_type_id": 29,
      "agoda_review_count": 658,
      "agoda_review_score": 7.5,
      "area": "Bình Thạnh",
      "area_id": 61314,
      "bathrooms": 1,
      "bedrooms": null,
      "beds": 1,
      "cancellation_type": "FreeCancellation",
      "city": "Ho Chi Minh City",
      "city_id": 13170,
      "country": "Vietnam",
      "country_code": "VN",
      "default_name": "Landmark 81 & Vinhomes - ZEN Saigon Citypoint",
      "free_cancellation_until": "2026-11-17T00:00:00.000+07:00",
      "image_url": "https://pix8.agoda.net/hotelImages/66755965/0/e637908a96ebf4117bb7e0022bf89318.jpeg?ce=3",
      "is_available": true,
      "is_ready": true,
      "is_sponsored": false,
      "latitude": 10.795099258422852,
      "longitude": 106.72203063964844,
      "name": "Landmark 81 & Vinhomes - ZEN Saigon Citypoint",
      "nearest_landmark": {
        "distance_m": 2924.76,
        "name": "Saigon Opera House (Ho Chi Minh Municipal Theater)"
      },
      "pay_at_hotel": false,
      "pay_later": true,
      "price": {
        "currency": "USD",
        "per_night_exclusive": 50.44,
        "per_night_exclusive_original": 50.44,
        "per_night_inclusive": 54.48,
        "per_night_inclusive_original": 54.48,
        "total_exclusive": 100.88,
        "total_inclusive": 108.96,
        "total_inclusive_crossed_out": null
      },
      "property_id": 66755965,
      "property_type": "NonHotel",
      "result_type": "NormalProperty",
      "review_count": 658,
      "review_score": 7.5,
      "room_size_sqm": 59,
      "rooms_left": 1,
      "star_rating": 5,
      "supplier_id": 332,
      "url": "https://www.agoda.com/celavie-serviced-apartment-the-landmark-81/hotel/ho-chi-minh-city-vn.html"
    },
    {
      "accommodation_type_id": 29,
      "agoda_review_count": null,
      "agoda_review_score": null,
      "area": "Bình Thạnh",
      "area_id": 61314,
      "bathrooms": 2,
      "bedrooms": 2,
      "beds": 3,
      "cancellation_type": "FreeCancellation",
      "city": "Ho Chi Minh City",
      "city_id": 13170,
      "country": "Vietnam",
      "country_code": "VN",
      "default_name": "2 bedrooms apartment at Landmark Vinhomes Central Park",
      "free_cancellation_until": "2026-11-05T00:00:00.000+07:00",
      "image_url": "https://q-xx.bstatic.com/xdata/images/hotel/max500/233580451.jpg?k=eff531f9e1e9400aeb4a1e171cc49c605bd0994763048d34d3028c38af0f04da&o=",
      "is_available": true,
      "is_ready": true,
      "is_sponsored": false,
      "latitude": 10.794590950012209,
      "longitude": 106.72076416015624,
      "name": "2 bedrooms apartment at Landmark Vinhomes Central Park",
      "nearest_landmark": {
        "distance_m": 2787.53,
        "name": "Saigon Opera House (Ho Chi Minh Municipal Theater)"
      },
      "pay_at_hotel": true,
      "pay_later": false,
      "price": {
        "currency": "USD",
        "per_night_exclusive": 60.39,
        "per_night_exclusive_original": 60.39,
        "per_night_inclusive": 65.22,
        "per_night_inclusive_original": 65.22,
        "total_exclusive": 120.78,
        "total_inclusive": 130.44,
        "total_inclusive_crossed_out": null
      },
      "property_id": 11120955,
      "property_type": "SingleRoom",
      "result_type": "NormalProperty",
      "review_count": null,
      "review_score": null,
      "room_size_sqm": 80,
      "rooms_left": 1,
      "star_rating": 4,
      "supplier_id": 3038,
      "url": "https://www.agoda.com/2-bedrooms-apartment-at-landmark-vinhomes-central-park/hotel/all/ho-chi-minh-city-vn.html"
    },
    {
      "accommodation_type_id": 34,
      "agoda_review_count": 1915,
      "agoda_review_score": 8.9,
      "area": "Bình Thạnh",
      "area_id": 61314,
      "bathrooms": null,
      "bedrooms": null,
      "beds": null,
      "cancellation_type": "FreeCancellation",
      "city": "Ho Chi Minh City",
      "city_id": 13170,
      "country": "Vietnam",
      "country_code": "VN",
      "default_name": "Vinpearl Landmark 81, Autograph Collection",
      "free_cancellation_until": "2026-11-19T00:00:00.000+07:00",
      "image_url": "https://pix8.agoda.net/hotelImages/6428322/0/101c0af0c3776c4e326971bb3cc12b1f.jpeg?ce=3",
      "is_available": true,
      "is_ready": true,
      "is_sponsored": false,
      "latitude": 10.794903755187988,
      "longitude": 106.7215805053711,
      "name": "Vinpearl Landmark 81, Autograph Collection",
      "nearest_landmark": {
        "distance_m": 2874.67,
        "name": "Saigon Opera House (Ho Chi Minh Municipal Theater)"
      },
      "pay_at_hotel": false,
      "pay_later": true,
      "price": {
        "currency": "USD",
        "per_night_exclusive": 253.44,
        "per_night_exclusive_original": 253.44,
        "per_night_inclusive": 273.72,
        "per_night_inclusive_original": 273.72,
        "total_exclusive": 506.88,
        "total_inclusive": 547.44,
        "total_inclusive_crossed_out": null
      },
      "property_id": 6428322,
      "property_type": "Hotel",
      "result_type": "NormalProperty",
      "review_count": 2974,
      "review_score": 9,
      "room_size_sqm": null,
      "rooms_left": 5,
      "star_rating": 5,
      "supplier_id": 29002,
      "url": "https://www.agoda.com/vinpearl-landmark-81-autograph-collection/hotel/ho-chi-minh-city-vn.html"
    },
    {
      "accommodation_type_id": 120,
      "agoda_review_count": 219,
      "agoda_review_score": 7.9,
      "area": "Bình Thạnh",
      "area_id": 61314,
      "bathrooms": null,
      "bedrooms": null,
      "beds": null,
      "cancellation_type": null,
      "city": "Ho Chi Minh City",
      "city_id": 13170,
      "country": "Vietnam",
      "country_code": "VN",
      "default_name": "VIA Saigon Hub - Landmark 81 & Vinhomes Serviced Apartments",
      "free_cancellation_until": null,
      "image_url": "https://pix8.agoda.net/hotelImages/52057280/0/129d7b082f0f6d018b60edb0e4ebb96e.jpeg?ce=3",
      "is_available": false,
      "is_ready": true,
      "is_sponsored": false,
      "latitude": 10.795111656188965,
      "longitude": 106.72209930419922,
      "name": "VIA Saigon Hub - Landmark 81 & Vinhomes Serviced Apartments",
      "nearest_landmark": {
        "distance_m": 2931.04,
        "name": "Saigon Opera House (Ho Chi Minh Municipal Theater)"
      },
      "pay_at_hotel": null,
      "pay_later": null,
      "price": null,
      "property_id": 52057280,
      "property_type": "Hotel",
      "result_type": "SoldOutProperty",
      "review_count": 219,
      "review_score": 7.9,
      "room_size_sqm": null,
      "rooms_left": null,
      "star_rating": 5,
      "supplier_id": null,
      "url": "https://www.agoda.com/celavie-services-apartments-vinhomes-landmark-81/hotel/ho-chi-minh-city-vn.html"
    },
    {
      "accommodation_type_id": 29,
      "agoda_review_count": 2,
      "agoda_review_score": 9.2,
      "area": "Bình Thạnh",
      "area_id": 61314,
      "bathrooms": 1,
      "bedrooms": 1,
      "beds": 1,
      "cancellation_type": "FreeCancellation",
      "city": "Ho Chi Minh City",
      "city_id": 13170,
      "country": "Vietnam",
      "country_code": "VN",
      "default_name": "Cozy Apartment at Vinhomes Central Park",
      "free_cancellation_until": "2026-11-18T00:00:00.000+07:00",
      "image_url": "https://q-xx.bstatic.com/xdata/images/hotel/max500/917974022.jpg?k=e895e8daa1b6b7df6996bf2a4656c2ddc7fbf01b220fded06d72b70fdf256b25&o=",
      "is_available": true,
      "is_ready": true,
      "is_sponsored": false,
      "latitude": 10.795178413391112,
      "longitude": 106.72079467773438,
      "name": "Cozy Apartment at Vinhomes Central Park",
      "nearest_landmark": {
        "distance_m": 2837.31,
        "name": "Saigon Opera House (Ho Chi Minh Municipal Theater)"
      },
      "pay_at_hotel": true,
      "pay_later": false,
      "price": {
        "currency": "USD",
        "per_night_exclusive": 32.6,
        "per_night_exclusive_original": 32.6,
        "per_night_inclusive": 35.21,
        "per_night_inclusive_original": 35.21,
        "total_exclusive": 65.2,
        "total_inclusive": 70.42,
        "total_inclusive_crossed_out": null
      },
      "property_id": 95291746,
      "property_type": "SingleRoom",
      "result_type": "NormalProperty",
      "review_count": 19,
      "review_score": 8.8,
      "room_size_sqm": 58,
      "rooms_left": 7,
      "star_rating": 5,
      "supplier_id": 3038,
      "url": "https://www.agoda.com/cozy-apartment-at-vinhomes-central-park/hotel/all/ho-chi-minh-city-vn.html"
    },
    {
      "accommodation_type_id": 29,
      "agoda_review_count": 1556,
      "agoda_review_score": 8.6,
      "area": "Bình Thạnh",
      "area_id": 61314,
      "bathrooms": 1,
      "bedrooms": null,
      "beds": 1,
      "cancellation_type": "FreeCancellation",
      "city": "Ho Chi Minh City",
      "city_id": 13170,
      "country": "Vietnam",
      "country_code": "VN",
      "default_name": "LuxHomes Saigon - Vinhomes Central Park",
      "free_cancellation_until": "2026-11-17T00:00:00.000+07:00",
      "image_url": "https://pix8.agoda.net/hotelImages/28445719/0/a4342a671338237e43ada3e7f44b7311.jpeg?ce=3",
      "is_available": true,
      "is_ready": true,
      "is_sponsored": false,
      "latitude": 10.795220375061035,
      "longitude": 106.72045135498048,
      "name": "LuxHomes Saigon - Vinhomes Central Park",
      "nearest_landmark": {
        "distance_m": 2815.34,
        "name": "Saigon Opera House (Ho Chi Minh Municipal Theater)"
      },
      "pay_at_hotel": false,
      "pay_later": true,
      "price": {
        "currency": "USD",
        "per_night_exclusive": 36.61,
        "per_night_exclusive_original": 36.61,
        "per_night_inclusive": 39.53,
        "per_night_inclusive_original": 39.53,
        "total_exclusive": 73.22,
        "total_inclusive": 79.06,
        "total_inclusive_crossed_out": null
      },
      "property_id": 28445719,
      "property_type": "NonHotel",
      "result_type": "NormalProperty",
      "review_count": 1596,
      "review_score": 8.5,
      "room_size_sqm": 55,
      "rooms_left": 8,
      "star_rating": 4,
      "supplier_id": 332,
      "url": "https://www.agoda.com/luxhomes-saigon-vinhomes-central-park/hotel/ho-chi-minh-city-vn.html"
    },
    {
      "accommodation_type_id": 34,
      "agoda_review_count": 232,
      "agoda_review_score": 8.9,
      "area": "Bình Thạnh",
      "area_id": 61314,
      "bathrooms": null,
      "bedrooms": null,
      "beds": null,
      "cancellation_type": "FreeCancellation",
      "city": "Ho Chi Minh City",
      "city_id": 13170,
      "country": "Vietnam",
      "country_code": "VN",
      "default_name": "Somi Luxstay Landmark 81",
      "free_cancellation_until": "2026-11-12T00:00:00.000+07:00",
      "image_url": "https://pix8.agoda.net/hotelImages/62056439/0/965ad2a9af7c3a1940bc15cf72776da2.jpeg",
      "is_available": true,
      "is_ready": true,
      "is_sponsored": false,
      "latitude": 10.794897079467772,
      "longitude": 106.72064208984376,
      "name": "Somi Luxstay Landmark 81",
      "nearest_landmark": {
        "distance_m": 2803.06,
        "name": "Saigon Opera House (Ho Chi Minh Municipal Theater)"
      },
      "pay_at_hotel": false,
      "pay_later": true,
      "price": {
        "currency": "USD",
        "per_night_exclusive": 74.96,
        "per_night_exclusive_original": 74.96,
        "per_night_inclusive": 80.96,
        "per_night_inclusive_original": 80.96,
        "total_exclusive": 149.92,
        "total_inclusive": 161.92,
        "total_inclusive_crossed_out": null
      },
      "property_id": 62056439,
      "property_type": "Hotel",
      "result_type": "NormalProperty",
      "review_count": 2302,
      "review_score": 8.9,
      "room_size_sqm": null,
      "rooms_left": 7,
      "star_rating": 5,
      "supplier_id": 332,
      "url": "https://www.agoda.com/somi-luxstay-landmark-81/hotel/ho-chi-minh-city-vn.html"
    },
    {
      "accommodation_type_id": 34,
      "agoda_review_count": 136,
      "agoda_review_score": 7.3,
      "area": "Bình Thạnh",
      "area_id": 61314,
      "bathrooms": null,
      "bedrooms": null,
      "beds": null,
      "cancellation_type": "FreeCancellation",
      "city": "Ho Chi Minh City",
      "city_id": 13170,
      "country": "Vietnam",
      "country_code": "VN",
      "default_name": "Lavela Urban Residences - Landmark 81 & Vinhomes",
      "free_cancellation_until": "2026-11-18T00:00:00.000+07:00",
      "image_url": "https://pix8.agoda.net/hotelImages/90716167/0/a8d23d4a7fc74fd7c7980730cee84b27.png?ce=3",
      "is_available": true,
      "is_ready": true,
      "is_sponsored": false,
      "latitude": 10.795081,
      "longitude": 106.72116,
      "name": "Lavela Urban Residences - Landmark 81 & Vinhomes",
      "nearest_landmark": {
        "distance_m": 2856.81,
        "name": "Saigon Opera House (Ho Chi Minh Municipal Theater)"
      },
      "pay_at_hotel": false,
      "pay_later": true,
      "price": {
        "currency": "USD",
        "per_night_exclusive": 59.03,
        "per_night_exclusive_original": 59.03,
        "per_night_inclusive": 63.75,
        "per_night_inclusive_original": 63.75,
        "total_exclusive": 118.05,
        "total_inclusive": 127.49,
        "total_inclusive_crossed_out": null
      },
      "property_id": 90716167,
      "property_type": "Hotel",
      "result_type": "NormalProperty",
      "review_count": 425,
      "review_score": 8,
      "room_size_sqm": null,
      "rooms_left": 2,
      "star_rating": 5,
      "supplier_id": 332,
      "url": "https://www.agoda.com/aura-collection-landmark-81-vinhomes/hotel/ho-chi-minh-city-vn.html"
    },
    {
      "accommodation_type_id": 120,
      "agoda_review_count": 1225,
      "agoda_review_score": 8.1,
      "area": "Bình Thạnh",
      "area_id": 61314,
      "bathrooms": null,
      "bedrooms": null,
      "beds": null,
      "cancellation_type": "FreeCancellation",
      "city": "Ho Chi Minh City",
      "city_id": 13170,
      "country": "Vietnam",
      "country_code": "VN",
      "default_name": "Sens House Saigon – Serviced Apartments in Vinhomes Central Park ",
      "free_cancellation_until": "2026-11-16T00:00:00.000+07:00",
      "image_url": "https://pix8.agoda.net/hotelImages/31317134/0/dd2aad2e32f53fbba3fcee1e15e1fbe3.jpeg?ce=3",
      "is_available": true,
      "is_ready": true,
      "is_sponsored": false,
      "latitude": 10.793919563293455,
      "longitude": 106.7211685180664,
      "name": "Sens House Saigon – Serviced Apartments in Vinhomes Central Park ",
      "nearest_landmark": {
        "distance_m": 2765.49,
        "name": "Saigon Opera House (Ho Chi Minh Municipal Theater)"
      },
      "pay_at_hotel": false,
      "pay_later": true,
      "price": {
        "currency": "USD",
        "per_night_exclusive": 45.67,
        "per_night_exclusive_original": 45.67,
        "per_night_inclusive": 49.32,
        "per_night_inclusive_original": 49.32,
        "total_exclusive": 91.34,
        "total_inclusive": 98.64,
        "total_inclusive_crossed_out": null
      },
      "property_id": 31317134,
      "property_type": "Hotel",
      "result_type": "NormalProperty",
      "review_count": 1797,
      "review_score": 8.1,
      "room_size_sqm": null,
      "rooms_left": 15,
      "star_rating": 4,
      "supplier_id": 332,
      "url": "https://www.agoda.com/sens-house-saigon-vinhomes-central-park/hotel/ho-chi-minh-city-vn.html"
    },
    {
      "accommodation_type_id": 120,
      "agoda_review_count": 33,
      "agoda_review_score": 8.5,
      "area": "Bình Thạnh",
      "area_id": 61314,
      "bathrooms": null,
      "bedrooms": null,
      "beds": null,
      "cancellation_type": "FreeCancellation",
      "city": "Ho Chi Minh City",
      "city_id": 13170,
      "country": "Vietnam",
      "country_code": "VN",
      "default_name": "Allen luxury apartment - Vinhomes central park",
      "free_cancellation_until": "2026-11-14T00:00:00.000+07:00",
      "image_url": "https://pix8.agoda.net/hotelImages/63143345/0/c5413e21d4742991ee42db595160662e.jpg?ce=3",
      "is_available": true,
      "is_ready": true,
      "is_sponsored": false,
      "latitude": 10.79475,
      "longitude": 106.72199,
      "name": "Allen luxury apartment - Vinhomes central park",
      "nearest_landmark": {
        "distance_m": 2894.25,
        "name": "Saigon Opera House (Ho Chi Minh Municipal Theater)"
      },
      "pay_at_hotel": false,
      "pay_later": true,
      "price": {
        "currency": "USD",
        "per_night_exclusive": 64.61,
        "per_night_exclusive_original": 64.61,
        "per_night_inclusive": 69.78,
        "per_night_inclusive_original": 69.78,
        "total_exclusive": 129.22,
        "total_inclusive": 139.56,
        "total_inclusive_crossed_out": null
      },
      "property_id": 63143345,
      "property_type": "Hotel",
      "result_type": "NormalProperty",
      "review_count": 152,
      "review_score": 9.2,
      "room_size_sqm": null,
      "rooms_left": 1,
      "star_rating": 5,
      "supplier_id": 332,
      "url": "https://www.agoda.com/landmark-1-vinhomes-central-park-high-floor-landmark-81-and-river-view/hotel/ho-chi-minh-city-vn.html"
    },
    {
      "accommodation_type_id": 29,
      "agoda_review_count": 220,
      "agoda_review_score": 9,
      "area": "Bình Thạnh",
      "area_id": 61314,
      "bathrooms": 1,
      "bedrooms": 1,
      "beds": 1,
      "cancellation_type": "FreeCancellation",
      "city": "Ho Chi Minh City",
      "city_id": 13170,
      "country": "Vietnam",
      "country_code": "VN",
      "default_name": "Landmark 81 Residence Signature",
      "free_cancellation_until": "2026-11-12T00:00:00.000+07:00",
      "image_url": "https://pix8.agoda.net/hotelImages/51440478/-1/d685c8102f91d9b324451d823f9056d6.jpg?ce=0",
      "is_available": true,
      "is_ready": true,
      "is_sponsored": false,
      "latitude": 10.794897079467772,
      "longitude": 106.72186279296876,
      "name": "Landmark 81 Residence Signature",
      "nearest_landmark": {
        "distance_m": 2895.89,
        "name": "Saigon Opera House (Ho Chi Minh Municipal Theater)"
      },
      "pay_at_hotel": false,
      "pay_later": true,
      "price": {
        "currency": "USD",
        "per_night_exclusive": 65.46,
        "per_night_exclusive_original": 65.46,
        "per_night_inclusive": 70.69,
        "per_night_inclusive_original": 70.69,
        "total_exclusive": 130.92,
        "total_inclusive": 141.38,
        "total_inclusive_crossed_out": null
      },
      "property_id": 51440478,
      "property_type": "NonHotel",
      "result_type": "NormalProperty",
      "review_count": 299,
      "review_score": 8.9,
      "room_size_sqm": 58,
      "rooms_left": 10,
      "star_rating": 5,
      "supplier_id": 332,
      "url": "https://www.agoda.com/landmark-81-residences-signature/hotel/ho-chi-minh-city-vn.html"
    }
  ],
  "rooms": 1,
  "scope": "landmark",
  "scope_name": "Landmark 81 SkyView",
  "sort": "recommended",
  "source_url": "https://www.agoda.com/search?poi=1518284&city=13170&checkIn=2026-11-19&los=2&rooms=1&adults=2&children=0&currency=USD",
  "total_properties": 395
}
```

### Suggest

- Capability: `hotels/suggest`
- Description: Agoda's search-box suggestions for a free-text query: cities, areas, landmarks, airports and properties with their Agoda ids. Landmark and city ids feed `search`; property ids feed `property_rooms`, `property_reviews` and `property_faq`.
- Instructions: Start here to turn a place or property name into Agoda ids.
- Cost: 5 credits per call
- Capability file: [Suggest](https://firecrawl.dev/alexandria/agents/providers/agoda-com/hotels/suggest)

Accepted options:
- `origin` (string): Traveller origin country (ISO 3166-1 alpha-2) Agoda ranks suggestions for. Default US. Pattern: ^[A-Za-z]{2}$. Example: `US`
- `query` (string, required): Free text: a city, landmark, area or property name. Example: `<query>`

Response schema example:
```json
{
  "count": 6,
  "observed_at_ms": 1792518149844,
  "origin": "US",
  "query": "Landmark 81",
  "results": [
    {
      "category": "Landmark",
      "city_id": 13170,
      "city_name": "Ho Chi Minh City",
      "country_code": "VN",
      "country_id": 38,
      "geo_hierarchy": "Ho Chi Minh City",
      "image_url": null,
      "is_property": false,
      "kind": "landmark",
      "name": "Landmark 81 SkyView",
      "object_id": 1518284,
      "object_type_id": 16,
      "page_type_id": 12,
      "property_count": 1667,
      "search_type": 3,
      "search_url": "https://www.agoda.com/search?city=13170&poi=1518284"
    },
    {
      "category": "Property",
      "city_id": 13170,
      "city_name": "Ho Chi Minh City",
      "country_code": "VN",
      "country_id": 38,
      "geo_hierarchy": "Ho Chi Minh City, Vietnam",
      "image_url": "https://pix6.agoda.net/hotelImages/66755965/0/6faabac7d309bb42890b75c0015dde02.jpg?ce=0",
      "is_property": true,
      "kind": "property",
      "name": "Landmark 81 & Vinhomes - ZEN Saigon Citypoint",
      "object_id": 66755965,
      "object_type_id": 32,
      "page_type_id": 103,
      "property_count": null,
      "search_type": 4,
      "search_url": "https://www.agoda.com/search?city=13170&hotel=66755965&selectedproperty=66755965"
    },
    {
      "category": "Property",
      "city_id": 13170,
      "city_name": "Ho Chi Minh City",
      "country_code": "VN",
      "country_id": 38,
      "geo_hierarchy": "Ho Chi Minh City, Vietnam",
      "image_url": "https://pix6.agoda.net/hotelImages/6428322/-1/4461bffd9ee59dcdf29459ab546d2bf1.jpg?ce=0",
      "is_property": true,
      "kind": "property",
      "name": "Vinpearl Landmark 81, Autograph Collection",
      "object_id": 6428322,
      "object_type_id": 32,
      "page_type_id": 103,
      "property_count": null,
      "search_type": 4,
      "search_url": "https://www.agoda.com/search?city=13170&hotel=6428322&selectedproperty=6428322"
    },
    {
      "category": "Property",
      "city_id": 13170,
      "city_name": "Ho Chi Minh City",
      "country_code": "VN",
      "country_id": 38,
      "geo_hierarchy": "Ho Chi Minh City, Vietnam",
      "image_url": "https://pix6.agoda.net/hotelImages/86286210/0/30e68ed4a4668a49714f4064be17fb97.jpg?ce=3",
      "is_property": true,
      "kind": "property",
      "name": "Landmark 81 Area - K's Luxury Residence",
      "object_id": 86286210,
      "object_type_id": 32,
      "page_type_id": 103,
      "property_count": null,
      "search_type": 4,
      "search_url": "https://www.agoda.com/search?city=13170&hotel=86286210&selectedproperty=86286210"
    },
    {
      "category": "Property",
      "city_id": 13170,
      "city_name": "Ho Chi Minh City",
      "country_code": "VN",
      "country_id": 38,
      "geo_hierarchy": "Ho Chi Minh City, Vietnam",
      "image_url": "https://pix6.agoda.net/hotelImages/90373064/0/4a13d327a934a23a251817efccff4a72.jpg?ce=3",
      "is_property": true,
      "kind": "property",
      "name": "Landmark 81 Apartments Service",
      "object_id": 90373064,
      "object_type_id": 32,
      "page_type_id": 103,
      "property_count": null,
      "search_type": 4,
      "search_url": "https://www.agoda.com/search?city=13170&hotel=90373064&selectedproperty=90373064"
    },
    {
      "category": "Property",
      "city_id": 13170,
      "city_name": "Ho Chi Minh City",
      "country_code": "VN",
      "country_id": 38,
      "geo_hierarchy": "Ho Chi Minh City, Vietnam",
      "image_url": "https://pix6.agoda.net/hotelImages/90716167/0/a8d23d4a7fc74fd7c7980730cee84b27.png?ce=3",
      "is_property": true,
      "kind": "property",
      "name": "Lavela Urban Residences - Landmark 81 & Vinhomes",
      "object_id": 90716167,
      "object_type_id": 32,
      "page_type_id": 103,
      "property_count": null,
      "search_type": 4,
      "search_url": "https://www.agoda.com/search?city=13170&hotel=90716167&selectedproperty=90716167"
    }
  ],
  "source_url": "https://www.agoda.com/api/cronos/search/GetUnifiedSuggestResult/3/1/1/0/en-us/?searchText=Landmark%2081&origin=US&cid=-1&pageTypeId=1&logTypeId=1&isHotelLandSearch=true&lastSearchedCity=0"
}
```

### Top destinations

- Capability: `hotels/top_destinations`
- Description: Agoda's most popular destination cities for travellers from an origin country (international or domestic), with city ids, country and property counts.
- Instructions: Discover city ids to search without a free-text query.
- Cost: 5 credits per call
- Capability file: [Top destinations](https://firecrawl.dev/alexandria/agents/providers/agoda-com/hotels/top_destinations)

Accepted options:
- `limit` (number): limit Example: `20`
- `origin` (string): Traveller origin country (ISO 3166-1 alpha-2). Pattern: ^[A-Za-z]{2}$. Example: `US`
- `scope` (string): scope Example: `international`

Response schema example:
```json
{
  "count": 20,
  "destinations": [
    {
      "city_id": 14524,
      "country": "Malaysia",
      "country_id": 198,
      "image_url": "https://pix6.agoda.net/geo/city/14524/0435b08918aeb5e6ba2c933def5a3b57.jpg?ce=0&s=396x298&ar=4x3",
      "name": "Kuala Lumpur",
      "name_english": "Kuala Lumpur",
      "property_count": 19902,
      "url": "https://www.agoda.com/city/kuala-lumpur-my.html"
    },
    {
      "city_id": 1622,
      "country": "Philippines",
      "country_id": 70,
      "image_url": "https://pix6.agoda.net/geo/city/1622/1_1622_02.jpg?ca=6&ce=1&s=396x298&ar=4x3",
      "name": "Manila",
      "name_english": "Manila",
      "property_count": 13223,
      "url": "https://www.agoda.com/city/manila-ph.html"
    },
    {
      "city_id": 16087,
      "country": "Malaysia",
      "country_id": 198,
      "image_url": "https://pix6.agoda.net/geo/city/16087/1_16087_02.jpg?ca=6&ce=1&s=396x298&ar=4x3",
      "name": "Penang",
      "name_english": "Penang",
      "property_count": 5161,
      "url": "https://www.agoda.com/city/penang-my.html"
    },
    {
      "city_id": 8691,
      "country": "Indonesia",
      "country_id": 192,
      "image_url": "https://pix6.agoda.net/geo/city/8691/1_8691_02.jpg?ca=6&ce=1&s=396x298&ar=4x3",
      "name": "Jakarta",
      "name_english": "Jakarta",
      "property_count": 14249,
      "url": "https://www.agoda.com/city/jakarta-id.html"
    },
    {
      "city_id": 2994,
      "country": "United Arab Emirates",
      "country_id": 64,
      "image_url": "https://pix6.agoda.net/geo/city/2994/0c2aae36625e3e958684d0d4ae5b12d0.jpg?ce=0&s=396x298&ar=4x3",
      "name": "Dubai",
      "name_english": "Dubai",
      "property_count": 19464,
      "url": "https://www.agoda.com/city/dubai-ae.html"
    },
    {
      "city_id": 9395,
      "country": "Thailand",
      "country_id": 106,
      "image_url": "https://pix6.agoda.net/geo/city/9395/1_9395_02.jpg?ca=6&ce=1&s=396x298&ar=4x3",
      "name": "Bangkok",
      "name_english": "Bangkok",
      "property_count": 12048,
      "url": "https://www.agoda.com/city/bangkok-th.html"
    },
    {
      "city_id": 15121,
      "country": "Malaysia",
      "country_id": 198,
      "image_url": "https://pix6.agoda.net/geo/city/15121/1_15121_02.jpg?ca=6&ce=1&s=396x298&ar=4x3",
      "name": "Malacca",
      "name_english": "Malacca",
      "property_count": 5883,
      "url": "https://www.agoda.com/city/malacca-my.html"
    },
    {
      "city_id": 1808,
      "country": "Malaysia",
      "country_id": 198,
      "image_url": "https://pix6.agoda.net/geo/city/1808/0fdfe2e24c886b78b03e2d0c0eb8df8e.jpg?ce=0&s=396x298&ar=4x3",
      "name": "Johor Bahru",
      "name_english": "Johor Bahru",
      "property_count": 6994,
      "url": "https://www.agoda.com/city/johor-bahru-my.html"
    },
    {
      "city_id": 5070,
      "country": "Malaysia",
      "country_id": 198,
      "image_url": "https://pix6.agoda.net/geo/city/5070/1_5070_02.jpg?ca=6&ce=1&s=396x298&ar=4x3",
      "name": "Kota Kinabalu",
      "name_english": "Kota Kinabalu",
      "property_count": 3417,
      "url": "https://www.agoda.com/city/kota-kinabalu-my.html"
    },
    {
      "city_id": 4001,
      "country": "Philippines",
      "country_id": 70,
      "image_url": "https://pix6.agoda.net/geo/city/4001/092eca9a1f0615374d2fcca17e130b61.jpg?ce=0&s=396x298&ar=4x3",
      "name": "Cebu",
      "name_english": "Cebu",
      "property_count": 5254,
      "url": "https://www.agoda.com/city/cebu-ph.html"
    },
    {
      "city_id": 1808,
      "country": "Malaysia",
      "country_id": 198,
      "image_url": "https://pix6.agoda.net/geo/city/1808/0fdfe2e24c886b78b03e2d0c0eb8df8e.jpg?ce=0&s=396x298&ar=4x3",
      "name": "Johor Bahru",
      "name_english": "Johor Bahru",
      "property_count": 6994,
      "url": "https://www.agoda.com/city/johor-bahru-my.html"
    },
    {
      "city_id": 4923,
      "country": "India",
      "country_id": 35,
      "image_url": "https://pix6.agoda.net/geo/city/4923/1_4923_02.jpg?ca=8&ce=1&s=396x298&ar=4x3",
      "name": "Bangalore",
      "name_english": "Bangalore",
      "property_count": 5372,
      "url": "https://www.agoda.com/city/bangalore-in.html"
    },
    {
      "city_id": 17193,
      "country": "Indonesia",
      "country_id": 192,
      "image_url": "https://pix6.agoda.net/geo/city/17193/1_17193_02.jpg?ca=6&ce=1&s=396x298&ar=4x3",
      "name": "Bali",
      "name_english": "Bali",
      "property_count": 32908,
      "url": "https://www.agoda.com/city/bali-id.html"
    },
    {
      "city_id": 18943,
      "country": "Indonesia",
      "country_id": 192,
      "image_url": "https://pix6.agoda.net/geo/city/18943/1_18943_02.jpg?ca=6&ce=1&s=396x298&ar=4x3",
      "name": "Bandung",
      "name_english": "Bandung",
      "property_count": 7196,
      "url": "https://www.agoda.com/city/bandung-id.html"
    },
    {
      "city_id": 15523,
      "country": "Malaysia",
      "country_id": 198,
      "image_url": "https://pix6.agoda.net/geo/city/15523/1_15523_02.jpg?ca=6&ce=1&s=396x298&ar=4x3",
      "name": "Ipoh",
      "name_english": "Ipoh",
      "property_count": 2516,
      "url": "https://www.agoda.com/city/ipoh-my.html"
    },
    {
      "city_id": 1399,
      "country": "Malaysia",
      "country_id": 198,
      "image_url": "https://pix6.agoda.net/geo/city/1399/1_1399_02.jpg?ca=6&ce=1&s=396x298&ar=4x3",
      "name": "Cameron Highlands",
      "name_english": "Cameron Highlands",
      "property_count": 1789,
      "url": "https://www.agoda.com/city/cameron-highlands-my.html"
    },
    {
      "city_id": 16850,
      "country": "India",
      "country_id": 35,
      "image_url": "https://pix6.agoda.net/geo/city/16850/1_16850_02.jpg?ca=6&ce=1&s=396x298&ar=4x3",
      "name": "Mumbai",
      "name_english": "Mumbai",
      "property_count": 4177,
      "url": "https://www.agoda.com/city/mumbai-in.html"
    },
    {
      "city_id": 14523,
      "country": "Malaysia",
      "country_id": 198,
      "image_url": "https://pix6.agoda.net/geo/city/14523/1_14523_02.jpg?ca=6&ce=1&s=396x298&ar=4x3",
      "name": "Kuching",
      "name_english": "Kuching",
      "property_count": 1465,
      "url": "https://www.agoda.com/city/kuching-my.html"
    },
    {
      "city_id": 4064,
      "country": "Singapore",
      "country_id": 114,
      "image_url": "https://pix6.agoda.net/geo/city/4064/1_4064_02.jpg?ca=6&ce=1&s=396x298&ar=4x3",
      "name": "Singapore",
      "name_english": "Singapore",
      "property_count": 1326,
      "url": "https://www.agoda.com/city/singapore-sg.html"
    },
    {
      "city_id": 11304,
      "country": "India",
      "country_id": 35,
      "image_url": "https://pix6.agoda.net/geo/city/11304/077a5dc2a344a604731be86537916ba0.jpg?ce=0&s=396x298&ar=4x3",
      "name": "Goa",
      "name_english": "Goa",
      "property_count": 9254,
      "url": "https://www.agoda.com/city/goa-in.html"
    }
  ],
  "header": "Most popular destinations",
  "observed_at_ms": 1792518188473,
  "origin": "US",
  "origin_country": "United States",
  "scope": "international",
  "source_url": "https://www.agoda.com/"
}
```
