directrate

OTA channel

Agoda hotel rates API

Agoda's room grid for a property, in USD, with whether the figure is tax-inclusive stated per answer.

Public rate
✓
Member deal (reported apart)
✓
Award points
–
Native calendar
–
Comp set batch
–
Credits per shop
1
Comp set, per hotel
0.25
Calendar, per night
shop
  • ·Agoda answers in USD only and says per answer whether its figure is tax-inclusive; the after-tax field is filled only then.
  • ·Member deal rates are flagged `member_only`.
Start freeQuickstart
curl -s https://api.directrate.dev/v1/shop \
  -H "x-api-key: $DIRECTRATE_API_KEY" \
  -H "content-type: application/json" \
  -d '{"chain":"agoda","hotel_code":"2458383","checkin":"2026-11-10","los":1}'

2458383 is a documented Agoda property code.

# an OTA's hotel code is its own hotel id: the number in its URL, or
# the channel id a /parity call on the chain's hotel returns
curl -s https://api.directrate.dev/v1/parity \
  -H "x-api-key: $DIRECTRATE_API_KEY" -H "content-type: application/json" \
  -d '{"chain":"choice","hotel_code":"IL263","checkin":"2026-11-10","channels":["agoda"]}'
{
  "chain": "agoda",
  "hotel": {
    "code": "2458383",
    "name": "…",
    "currency": "USD"
  },
  "checkin": "2026-11-10",
  "los": 1,
  "status": "available",
  "rates": [
    {
      "room_name": "…",
      "rate_name": "…",
      "rate_type": "bar",
      "member_only": false,
      "price_per_night": 0,
      "price_per_night_after_tax": 0,
      "tax_included": true,
      "currency": "USD"
    }
  ],
  "lowest": {
    "bar": 0,
    "member": 0,
    "bar_after_tax": 0,
    "member_after_tax": 0
  },
  "shopped_at": "…",
  "source": "live",
  "cache_age_sec": 0
}

ShopResponse — the full schema is in the API reference.

No snapshot response is shown for Agoda on this page; the shape above is the contract every chain answers in. Run it live with a free key.

FAQ

Agoda questions

Where do I get a Agoda hotel id?

It is Agoda's own hotel id — the number in the listing URL — or the channel id that POST /parity on the chain's hotel returns after resolving the id map from Google Hotels. GET /hotels/{chain}/{code}/ids returns the mapping on its own.

Does the Agoda price include tax?

Agoda answers in USD only and says per answer whether its figure is tax-inclusive; the after-tax field is filled only then.

Can I get points or a calendar from Agoda?

No — an OTA carries no award points and no native calendar, and a hotel-code search is not offered on it. Shop it directly, use it as a /parity channel, or /calendar it a night at a time (one shop per night).

All sources: coverage matrix · chains & coverage docs · weights.