Agoda API Key: How to Get One (and What It Includes)

There's no signup page where you enter an email and receive an Agoda API key.
Every key Agoda issues comes through a partner program, each with its own application, review, and eligibility bar.
If you've been hunting for an Agoda API key, the first useful thing to know is which program you'd actually be applying to.
The second is that for the most common use case (reading hotel and review data), none of the programs may fit, and a different route exists.
This guide covers both.

Key Takeaways

• Agoda has no self-serve API key. Keys come through the affiliate program, the supplier-side YCS system, or B2B distribution agreements.
• Each key type covers something different. Affiliate keys serve monetized search and links, YCS keys manage your own listed property, distribution keys require a commercial contract.
• None of them provide general review or market data. Reading guest reviews for arbitrary hotels sits outside every official program.
• Review data has its own route. Third-party data APIs deliver Agoda review data as structured JSON, no partner application involved.
• Agoda's review pool is aggregated. Reviews from partner booking platforms appear alongside Agoda's own, and the data preserves which source each review came from.

The Official Routes to an Agoda API Key

Three programs issue keys, and they serve three different businesses.

The affiliate program is the openest door.
Signup is available to publishers, and the basic tier gives you links and widgets that earn commission on referred bookings.
An API tier exists above that, but Agoda typically grants it selectively, after you've demonstrated real traffic and conversions.
YCS (Yield Control System) is the supplier side: the console and connectivity APIs hotels use to manage their own rates, availability, and content on Agoda.
If you run a listed property or build channel management software, this is your program, and your key scope ends at properties you manage.
Distribution partnerships are commercial contracts for reselling inventory, with the application process and volume expectations that implies.
The common thread: every official key is scoped to your own business relationship with Agoda, whether that's your traffic, your property, or your contract.

What You Can Build with Official Access

With an affiliate key, you can build monetized hotel search into a travel site: search results, property links, price display, all earning commission.
For a content business, that's genuinely useful.
With a YCS connection, you can automate your own property's operations: rate updates, availability sync, booking retrieval.
Here's the gap.
Neither key answers questions about the market around you.
What are guests saying about the hotel across the street?
How does your review score trend against your comp set?
Which weaknesses do travelers mention most in your city?
That data exists on Agoda's pages, but no official key type exposes it.

If You Don't Qualify: Getting Agoda Data Anyway

For review and market data, three routes exist.
Applying anyway costs you weeks and usually ends in a polite rejection, because the programs aren't built for data use cases.
Scraping Agoda pages works until it doesn't.
Bot detection, markup changes, and session handling make Agoda scrapers an ongoing engineering commitment rather than a weekend project.
A third-party data API handles the extraction layer for you and issues its key the way you originally expected Agoda to: sign up, get the key, make requests.
The Agoda API from StayAPI works this way, with four endpoints covering hotel reviews, provider-specific review comments, URL-to-ID conversion, and review retrieval straight from a hotel page URL.
For the step-by-step extraction walkthrough, our guide on extracting Agoda reviews covers the full workflow.

The Agoda Reviews Endpoint in Practice

Here's what the working key looks like in use.
Hotel 319457 is a real property with 1,459 reviews.

curl -X GET "https://api.stayapi.com/v1/agoda/hotel/reviews/319457?page=1" \
  -H "x-api-key: YOUR_API_KEY"

The response (truncated):

{
  "success": true,
  "hotel_id": 319457,
  "hotel_name": "Omena Hotel Jyvaskyla",
  "review_score": {
    "overall": 7.9,
    "score_text": "Very good",
    "review_count": 1459
  },
  "reviews": [...],
  ...
}

One Agoda-specific detail worth knowing: Agoda displays reviews aggregated from partner booking platforms alongside its own, and the comments endpoint accepts a provider_id parameter so you can filter by review source.
That means you can compare how the same hotel scores across different booking channels from a single API.
Pagination and sorting are query parameters, and the full reference is in the Agoda reviews endpoint documentation.

Getting Started

1. Sign up at stayapi.com. The API key is issued immediately, free tier, no credit card.
2. Preview the data with the free Agoda reviews tool: paste a hotel URL and see the structured response first.
3. Find your hotel IDs. Paste any Agoda hotel page URL into the URL-to-ID endpoint, or send the URL directly to the reviews-from-URL endpoint and skip the ID step entirely.
4. Make your first call with the curl example above.
5. For a no-code setup, the Agoda reviews to Google Sheets integration lands the data in a spreadsheet, and the same pattern works for Looker Studio, Power BI, N8N, and Make.com. For multi-property review monitoring, book a demo call.

FAQ

How do I get an Agoda API key?

Officially, by joining a partner program: the affiliate program for monetized search and links, YCS for managing your own listed property, or a distribution agreement for resellers.
For review and hotel data use cases, third-party data APIs issue keys on signup without an application.

Is the Agoda API free?

The affiliate program is free to join, and its API tier is granted selectively rather than purchased.
Data APIs typically offer free tiers for evaluation (StayAPI includes one) with paid plans by request volume.

What is the Agoda affiliate API?

It's the API tier of Agoda's affiliate program: programmatic hotel search and links with your affiliate tracking attached, designed for monetization.
It serves commission earning, so review data and market analysis fall outside it.

How do I convert Agoda data to JSON?

Use an endpoint that returns JSON natively rather than converting scraped HTML.
A reviews API call returns the review text, scores, reviewer country, and stay details as structured JSON fields you can load into any database or spreadsheet.

Can I get review data for any hotel, or just my own?

Any hotel listed on Agoda.
Data APIs work from public hotel pages, so competitor properties and whole comp sets are as accessible as your own listings.