Agoda logo Agoda API

The Agoda API for hotel search, details, prices, and reviews.

Search cities, find hotels by name, and pull property profiles, selected photos, dated room availability, tax-inclusive prices, cancellation terms, and guest reviews from Agoda as clean JSON.

REQUEST GET
USE CASE Search Phuket for a dated stay. Illustrative prices.
curl "https://api.stayapi.com/v1/agoda/search" \
  -G \
  -H "x-api-key: $STAYAPI_KEY" \
  -d "city_id=16056" \
  -d "check_in=2027-05-15" \
  -d "check_out=2027-05-17" \
  -d "adults=2" \
  -d "rooms=1" \
  -d "currency=USD" \
  -d "page=1"
RESPONSE 200 OK
2.41s
{
  "success": true,
  "city_id": 16056,
  "city_name": "Phuket",
  "search": {
    "check_in": "2027-05-15",
    "check_out": "2027-05-17",
    "adults": 2,
    "rooms": 1,
    "children": 0,
    "children_ages": []
  },
  "currency": "USD",
  "hotels": [
    {
      "hotel_id": 10884,
      "name": "Banyan Tree Phuket",
      "url": null,
      "star_rating": 5.0,
      "latitude": null,
      "longitude": null,
      "available": true,
      "price_per_room_per_night": {
        "exclusive": 150.0,
        "taxes_and_fees": 30.0,
        "total": 180.0
      },
      "stay_price": {
        "exclusive": 300.0,
        "taxes_and_fees": 60.0,
        "total": 360.0
      }
    }
  ],
  "pagination": {
    "page": 1,
    "page_size": 10,
    "returned_count": 1,
    "total_filtered_hotels": 1
  },
  "retrieved_at": "2026-10-14T12:00:00Z"
}
99.9% uptime Live, not cached

Trusted by hospitality teams at

Overview

What the Agoda API gives you.

Agoda's partner APIs are not an open self-serve data surface. Building directly against the public site means maintaining date-sensitive room pricing and review extraction yourself.

Search a city for a dated stay or look up a hotel by name, then choose a hotel ID. Pass the hotel ID to details for a date-free profile, address, available amenities, and selected photos. StayAPI also provides room rates and reviews. Send a hotel_id and stay dates for live room rates, tax-inclusive totals, breakfast and cancellation terms, or fetch structured review text and sub-ratings. If you only have a URL, resolve it once and reuse the stable ID.

01

Search, rates, and reviews in JSON.

x-api-key in, JSON out. Live room rates, availability, Agoda guest reviews, and sub-ratings behind one base URL.

02

We run the hard part.

Get structured hotel cards, prices, and reviews with consistent authentication and JSON responses.

03

Find a hotel by name or URL.

Look up a hotel name or resolve an Agoda hotel URL to its numeric hotel_id, or skip the step and pull reviews straight from the URL.

Use cases

What teams build on the Agoda API.

The same endpoints, pointed at different jobs. These are the ones we see most.

01

Live price comparison.

Check current Agoda inventory for a property and compare the cheapest all-inclusive whole-stay total with other hotel channels.

02

Review monitoring.

Request newest-first Agoda reviews. Agoda lists English-language reviews first (newest first with the default sort), then reviews in other languages, so for a complete date range, page until has_more is false.

03

Rating and sentiment benchmarking.

Track the overall score and category sub-ratings (cleanliness, location, service, value) over time to see where a property is gaining or slipping.

04

Reputation across OTAs.

Combine Agoda reviews with the same fields from other channels to build one cross-OTA reputation view per property instead of a per-site spreadsheet.

05

Review context for AI agents.

Feed structured Agoda reviews into an LLM tool call so your agent answers guest-sentiment questions from live review text, not stale embeddings.

Also over MCP

Agoda data, inside your AI agent.

The same endpoints are exposed as MCP tools. Connect Claude, Cursor, or Claude Code, ask in plain English, and the agent calls the tool and answers from live Agoda data.

Pricing

50 free requests on signup.
Pick a plan when you need more.

Flat monthly plans, every endpoint included on every plan. 1 request = 1 credit. No per-endpoint multipliers, no surprise overages.

01 Free

Wire it up. See the schema.

$0 to start
50 credits on signup
  • 50 free requests
  • Every endpoint included
  • No credit card required
  • Same schema as paid
Start free
02 Basic

Kick the tires in production.

$49 per month
1,500 requests / mo
  • 1,500 requests / month
  • Every endpoint included
  • Per-endpoint usage dashboard
  • Email support
Start Basic
50% off
04 Scale

Daily pulls in production.

$900 $450 per month
100,000 requests / mo
  • 100,000 requests / month
  • Every endpoint included
  • Per-endpoint usage dashboard
  • Priority email support
Start scaling
05 Custom

Above 100k / month, annual terms, white-glove onboarding.

Let's talk
1M+ requests / mo
  • 1M+ requests / month
  • Volume rate on the call
  • Per-endpoint usage dashboard
  • Priority email + Slack support
Book a scoping call

Every plan ships every endpoint. Same uptime, same schema, same response time.

Questions

What people ask about the Agoda API.

Don't see your question? Email us at info@stayapi.com.

Does hotel details include room counts and check-in times?

The useful_information object includes nullable number_of_rooms, year_opened, and check-in/check-out time fields, plus ordered source groups. Room count is the declared property total, not live inventory; year_opened is the opening year, not construction year. Missing information remains null or an empty array. A full locality address can have a null street.

Can I find an Agoda hotel by name?

Call /v1/agoda/hotel/lookup with a query of 2–200 characters. It returns hotel suggestions and IDs with location context, without prices or availability. Suggestions are not an exhaustive catalog and have no pagination. See the hotel lookup docs.

Does Agoda have a public API?

Agoda runs partner and affiliate programs, but there is no open, self-serve API for its full live room and review data. StayAPI provides both over plain REST with one API key.

How do I get live Agoda hotel prices?

Call /v1/agoda/hotel/prices with a numeric hotel_id, check-in and check-out dates. Optional children_ages accepts up to nine comma-separated ages 0–17 and overrides the children count. Omitted or blank ages use age 8 for each child. The response includes live inventory, the lowest all-inclusive stay total, taxes and fees, and room-level cancellation and breakfast terms. See the hotel prices docs.

How do I get Agoda reviews?

Call /v1/agoda/hotel/reviews/{hotel_id} with an Agoda hotel_id. You get paginated review text, the overall score, category sub-ratings, reviewer country and group type, and dates as JSON. No ID on hand? Use /v1/agoda/hotel/reviews-from-url with the hotel URL. See the reviews endpoint docs.

How do I get an Agoda hotel ID?

Call /v1/agoda/hotel/url-to-id with any Agoda hotel URL and it returns the numeric hotel_id. The ID never changes for a hotel, so cache it once and reuse it for hotel details, prices, or reviews. Details accepts only hotel_id, without dates, locale, or currency. See the URL to ID docs.

Which Agoda reviews does StayAPI return?

Agoda's own guest reviews only; reviews Agoda shows from partner sites are not included. /v1/agoda/hotel/reviews/{hotel_id} and /v1/agoda/hotel/reviews/{hotel_id}/comments return the same reviews. Agoda lists English-language reviews first (newest first with the default sort), then reviews in other languages, so for a complete date range, page until has_more is false. See the hotel reviews docs.

Is the Agoda API free?

You get 50 free requests on signup, every endpoint included, no credit card. After that it is flat monthly plans starting at $49. One request equals one credit, with no per-endpoint multipliers.

Two ways to start.

Both end with live Agoda data in your stack. The fast path is on the left.

01 · the fast path

Try it free

50 free requests after sign up. Fastest way to see if the schema fits.

Start free
  • Live API key in 30 seconds
  • No credit card required
  • Same schema as paid
02 · the scoped path

Book a scoping call

15 minutes. Volume + endpoint mix. Walk out with a quote.

Book a demo
  • Quote on the call, not after
  • Engineering, not sales
  • No deck, no slides