Agoda
Agoda API endpoints
Available Agoda Endpoints
Explore 11 endpoints for accessing Agoda real estate data. Each endpoint is designed for a specific use case and returns structured JSON.
/details/byid/details/byid
Full hotel / property detail for any Agoda `propertyId` — returns name, address, star rating, guest review score, photo gallery, amenities, room types, latitude / longitude, parent-city, and live nightly pricing for the requested check-in window. Pass `cityId` if you already know it; otherwise Bangkok is used as a neutral anchor (Agoda surfaces the property via `extraHotelIds` regardless of city match). Need the id from a URL? Use [/details/byurl](https://realtyapi.io/dashboard?tab=playground&api=agoda&endpoint=details_byurl) instead.
/details/byurl/details/byurl
Full property detail by Agoda hotel URL. Accepts the canonical hotel page URL — either with the id embedded (`-h<propertyId>/hotel/...`) or a clean slug URL (we fetch the page once and extract the id from the embedded `hotel_id=` attribute). Returns the same shape as [/details/byid](https://realtyapi.io/dashboard?tab=playground&api=agoda&endpoint=details_byid).
/search/bylocation/search/bylocation
Free-text location → hotel list. Resolves `location` via Agoda's autocomplete to the best-matching `cityId`, then runs a citySearch for the requested check-in window. Each row returns `propertyId`, `name`, `starRating`, `reviewScore`, `reviewCount`, `priceFrom`, `currency`, `address`, `photo`, and amenity highlights. Use `propertyId` to fetch deeper detail via [/details/byid](https://realtyapi.io/dashboard?tab=playground&api=agoda&endpoint=details_byid).
/search/bycoordinates/search/bycoordinates
Latitude / longitude → hotel list. Reverse-geocodes the coordinates (OpenStreetMap Nominatim) to the nearest city, resolves the city name to an Agoda `cityId` via autocomplete, then runs a citySearch. Returns the same hotel-row shape as [/search/bylocation](https://realtyapi.io/dashboard?tab=playground&api=agoda&endpoint=search_bylocation). **Note**: Agoda's search response does not expose per-property lat/lng, so a `radius` post-filter is **not applied** — the `message` field reports the resolved city for verification.
/search/byurl/search/byurl
Hotel list from an Agoda search URL. Supports: - `https://www.agoda.com/search?city=<id>&checkIn=YYYY-MM-DD&checkOut=...&adults=...&rooms=...` — uses the `city` id directly - `https://www.agoda.com/city/<slug>.html` — slug → autocomplete → `cityId` - `https://www.agoda.com/country/<slug>.html` — slug → autocomplete → `cityId` Any of the date / occupancy params below override what's embedded in the URL.
/property/reviews/property/reviews
Paginated guest review list for an Agoda property — returns each review's text, score, traveler type, stay date, language, and provider (Agoda + major OTA partners). Use `propertyId` from any [/search/*](https://realtyapi.io/dashboard?tab=playground&api=agoda&endpoint=search_bylocation) result or from the `propertyId` field returned by [/details/byid](https://realtyapi.io/dashboard?tab=playground&api=agoda&endpoint=details_byid). Response top-level includes `score` — Agoda's aggregated review summary (overall, demographics breakdown).
/property/rooms/property/rooms
Room rates + availability for a single Agoda property over the requested check-in window. Returns `masterRooms[]` — each master room includes pricing, photos, bed configuration, room size, amenities, and a `rooms[]` array of individual rate plans (refundable / non-refundable / breakfast-included etc.). Dates default to +30 / +32 days from today if omitted. For a calendar-wide price trend across many check-in dates, use [/property/price-grid](https://realtyapi.io/dashboard?tab=playground&api=agoda&endpoint=property_price-grid) instead.
/property/price-grid/property/price-grid
Calendar price trend for an Agoda property — one nightly price per check-in date across the requested window (typically 30–60 days). Useful for rendering a date picker / cheapest-night picker in a client UI. Both `propertyId` and `cityId` are required. Resolve a `cityId` for the property via [/autocomplete](https://realtyapi.io/dashboard?tab=playground&api=agoda&endpoint=autocomplete) (the property's parent city name) or by inspecting the `cityId` field on a [/details/byid](https://realtyapi.io/dashboard?tab=playground&api=agoda&endpoint=details_byid) response. Default window: today → today + 60 days, 1-night stay, 2 adults, USD.
/flights/search/flights/search
One-way or round-trip flight search via Agoda Flights (`flights.agoda.com`). Returns the list of itineraries matching the route + date, each with price, total duration, airline carrier(s), stop count, full leg / segment breakdown (origin / destination / departure / arrival / flight number), and a `resultId` you can pass to [/flights/details](https://realtyapi.io/dashboard?tab=playground&api=agoda&endpoint=flights_details) for the full booking-grade itinerary. Pass `returnDate` to make the search round-trip; omit for one-way. `origin` and `destination` must be 3-letter IATA airport codes (e.g. `BKK`, `SIN`, `JFK`).
/flights/details/flights/details
Full itinerary detail for a single flight result — booking-grade fare breakdown, baggage policy, fare rules, full segment timing, and aircraft type. Two ways to call: 1. **Direct**: pass `searchId` + `resultId` returned by [/flights/search](https://realtyapi.io/dashboard?tab=playground&api=agoda&endpoint=flights_search). These are tied to a single browser session — call shortly after the search. 2. **From a URL**: pass a shareable Agoda Flights URL (e.g. `/flights/BKK-SIN/2026-08-10/<token>`); we'll re-run the search internally to mint a fresh `searchId` / `resultId` and return the matching result.
/autocomplete/autocomplete
Universal location & property typeahead. Returns Agoda destinations (city / region / neighborhood / point-of-interest) plus individual properties matching the query — each hit carries `cityId`, `objectId`, `name`, `type`, `latitude`, `longitude`, and `numberOfHotels`. Use the top `cityId` to feed any of the `/search/*` endpoints, or `objectId` (when it's a property suggestion) for [/details/byid](https://realtyapi.io/dashboard?tab=playground&api=agoda&endpoint=details_byid).
Why Choose RealtyAPI for Agoda Data
We built RealtyAPI so developers can focus on their products, not on data collection infrastructure.
Real-Time Data Access
Get the most current Agoda data without dealing with rate limits, IP blocks, or anti-bot protections. Our infrastructure handles the heavy lifting.
Simple Integration
Clear documentation and a straightforward REST API make it easy to start pulling Agoda data into your application within minutes.
High Reliability
Our infrastructure is built for uptime and performance. Rely on consistent, uninterrupted access to Agoda data for your production applications.
Comprehensive Data
Access a wide range of Agoda data points through carefully designed endpoints that cover properties, listings, agents, and market metrics.
Lightning Fast Responses
Optimized data pipelines deliver Agoda results in milliseconds. Low latency means a better experience for your end users.
Structured JSON Output
Every Agoda endpoint returns clean, well-structured JSON that is ready to parse and use directly in your application logic.
Agoda API Use Cases
From property valuation to market analysis, the Agoda powers a wide range of real estate applications.
Property Valuation
Analyze Agoda property data to determine accurate market values, estimate appreciation, and identify undervalued investment opportunities.
Market Research
Track Agoda listing trends, pricing shifts, and inventory changes to make informed, data-driven investment and development decisions.
Portfolio Management
Monitor your real estate portfolio with live Agoda data. Track current values, rental comps, and market conditions in one place.
Lead Generation
Identify high-potential properties and neighborhoods using Agoda data to power targeted outreach and marketing campaigns.
Competitive Analysis
Compare listings, pricing, and agent activity across Agoda to understand market positioning and stay ahead of competition.
Custom Dashboards
Build real-time dashboards that aggregate Agoda data for internal teams, clients, or investors with always-current information.
Frequently Asked Questions
Common questions about using the Agoda through RealtyAPI.
Is the Agoda API official?
How current is the data?
Can I use this API in production?
What response format does the API use?
Do I need a credit card to get started?
What programming languages are supported?
Ready to Access Agoda Data?
Get started with 250 free API calls. No credit card required.