/agoda/hotels

curl --request POST \
  --url https://api.anysite.io/api/agoda/hotels \
  --header 'Content-Type: application/json' \
  --header 'access-token: <api-key>' \
  --data '
{
  "hotel": "<string>",
  "timeout": 300
}
'

[
  {
    "id": "<string>",
    "@type": "@agoda_hotel",
    "name": "<string>",
    "property_type": "<string>",
    "accommodation_type": "<string>",
    "star_rating": 123,
    "is_luxury": true,
    "description": "<string>",
    "address": "<string>",
    "area": "<string>",
    "city": "<string>",
    "city_id": 123,
    "country": "<string>",
    "country_code": "<string>",
    "postal_code": "<string>",
    "latitude": 123,
    "longitude": 123,
    "check_in_time": "<string>",
    "check_out_time": "<string>",
    "is_infant_cot_available": true,
    "response_rate": 123,
    "ranking": {
      "@type": "@agoda_property_ranking",
      "property_count": 123,
      "metrics": []
    },
    "review_score": {
      "@type": "@agoda_review_score",
      "score": 123,
      "max_score": 123,
      "review_count": 123,
      "grades": []
    },
    "recommendation_score": 123,
    "frequent_traveller_recommendation_score": 123,
    "review_tags": [],
    "review_snippets": [],
    "ai_summary_positive": "<string>",
    "ai_summary_negative": "<string>",
    "gold_circle_year": 123,
    "highlights": [],
    "favorite_features": [],
    "location_highlights": [],
    "facility_highlights": [],
    "amenity_groups": [],
    "info_groups": [],
    "policies": {
      "@type": "@agoda_policies",
      "children": {
        "@type": "@agoda_children_policy",
        "stay_free_min_age": 123,
        "stay_free_max_age": 123,
        "details": []
      },
      "adult": [],
      "extra_bed": [],
      "additional": []
    },
    "nearby_places": [],
    "nearby_properties": [],
    "images": [],
    "ugc_images": [],
    "video_url": "<string>"
  }
]

/agoda

/agoda/hotels

Get full Agoda hotel details by property id (or hotel URL): name, property type, star rating, full address, coordinates, description, check-in/check-out times, guest review score with category subscores, guest recommendation scores, per-aspect review tags, guest review snippets, AI review summary, property highlights, favorite features, location highlights, facility highlights, grouped amenities, useful information (year opened, number of rooms, floors), property policies (children, adult, extra bed), city ranking metrics, host response rate, infant cot availability, nearby places, nearby airports and transport, official photos, guest photos and video.

Price: 1 credit

💡 AI Hint: Fetch a single Agoda hotel by numeric property id or a hotel URL containing hotelId. Returns one item with id, name, property_type, accommodation_type, star_rating, is_luxury, description, address, area, city, city_id, country, country_code, postal_code, latitude, longitude, check_in_time, check_out_time, is_infant_cot_available, response_rate (host responsiveness 0-1), ranking (property_count = hotels in the city, plus metrics with name, rank and absolute_value — e.g. facility count, average room size, location rating ranks), review_score (score, max_score, review_count, grades with category scores and city averages), recommendation_score, frequent_traveller_recommendation_score (0-100 guest recommendation %), review_tags (per-aspect sentiment: name, positive_percentage, rating_type), review_snippets (guest quotes: text, rating, author, demographic, country, country_code, created_at), ai_summary_positive, ai_summary_negative, gold_circle_year, highlights, favorite_features, location_highlights, facility_highlights, amenity_groups (grouped facilities), info_groups (useful property info), policies (children stay-free age range and details, adult definition, extra_bed and additional rules), nearby_places (name, distance_km, type_name, abbr), nearby_properties (airports and transport grouped by category), images, ugc_images (guest photos) and video_url.

⚠️ Common errors: 412: Hotel not found (well-formed but nonexistent property id)

POST

api

agoda

hotels

/agoda/hotels

curl --request POST \
  --url https://api.anysite.io/api/agoda/hotels \
  --header 'Content-Type: application/json' \
  --header 'access-token: <api-key>' \
  --data '
{
  "hotel": "<string>",
  "timeout": 300
}
'

[
  {
    "id": "<string>",
    "@type": "@agoda_hotel",
    "name": "<string>",
    "property_type": "<string>",
    "accommodation_type": "<string>",
    "star_rating": 123,
    "is_luxury": true,
    "description": "<string>",
    "address": "<string>",
    "area": "<string>",
    "city": "<string>",
    "city_id": 123,
    "country": "<string>",
    "country_code": "<string>",
    "postal_code": "<string>",
    "latitude": 123,
    "longitude": 123,
    "check_in_time": "<string>",
    "check_out_time": "<string>",
    "is_infant_cot_available": true,
    "response_rate": 123,
    "ranking": {
      "@type": "@agoda_property_ranking",
      "property_count": 123,
      "metrics": []
    },
    "review_score": {
      "@type": "@agoda_review_score",
      "score": 123,
      "max_score": 123,
      "review_count": 123,
      "grades": []
    },
    "recommendation_score": 123,
    "frequent_traveller_recommendation_score": 123,
    "review_tags": [],
    "review_snippets": [],
    "ai_summary_positive": "<string>",
    "ai_summary_negative": "<string>",
    "gold_circle_year": 123,
    "highlights": [],
    "favorite_features": [],
    "location_highlights": [],
    "facility_highlights": [],
    "amenity_groups": [],
    "info_groups": [],
    "policies": {
      "@type": "@agoda_policies",
      "children": {
        "@type": "@agoda_children_policy",
        "stay_free_min_age": 123,
        "stay_free_max_age": 123,
        "details": []
      },
      "adult": [],
      "extra_bed": [],
      "additional": []
    },
    "nearby_places": [],
    "nearby_properties": [],
    "images": [],
    "ugc_images": [],
    "video_url": "<string>"
  }
]

Authorizations

access-token

string

header

required

API token from the dashboard

Headers

access-token

string

required

Body

application/json

hotel

string

required

Agoda property id or a hotel URL containing it

Minimum string length: 1

Examples:

"10696"

"https://www.agoda.com/shangri-la-hotel-bangkok/hotel/bangkok-th.html?hotelId=10696"

timeout

integer

default:300

Max scrapping execution timeout (in seconds)

Required range: 20 <= x <= 1500

Response

Successful Response

string

required

@type

string

default:@agoda_hotel

name

string | null

property_type

string | null

accommodation_type

string | null

star_rating

number | null

is_luxury

boolean | null

description

string | null

address

string | null

area

string | null

city

string | null

city_id

integer | null

country

string | null

country_code

string | null

postal_code

string | null

latitude

number | null

longitude

number | null

check_in_time

string | null

check_out_time

string | null

is_infant_cot_available

boolean | null

response_rate

number | null

ranking

AgodaPropertyRanking · object

Show child attributes

review_score

AgodaReviewScore · object

Show child attributes

recommendation_score

integer | null

frequent_traveller_recommendation_score

integer | null

review_tags

AgodaReviewTag · object[]

Show child attributes

review_snippets

AgodaReviewSnippet · object[]

Show child attributes

ai_summary_positive

string | null

ai_summary_negative

string | null

gold_circle_year

integer | null

highlights

string[]

favorite_features

string[]

location_highlights

string[]

facility_highlights

string[]

amenity_groups

AgodaAmenityGroup · object[]

Show child attributes

info_groups

AgodaInfoGroup · object[]

Show child attributes

policies

AgodaPolicies · object

Show child attributes

nearby_places

AgodaNearbyPlace · object[]

Show child attributes

nearby_properties

AgodaNearbyProperty · object[]

Show child attributes

images

string[]

ugc_images

string[]

video_url

string | null

/agoda/destinations/search /agoda/hotels/prices