{"uid":"cap_XhvqLL_QZW72D9Ao7RrP2","slug":"agoda-hotel-reviews-scraper-d86537f9","name":"Agoda Hotel Reviews Scraper","description":"Pay-per-call structured web data. Failed or empty runs are not charged.","url":"https://api.scrapeforagents.tech/v1/agoda?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"rating":{"type":"array","items":{"enum":["exceptional","excellent","very_good","good","below_expectation"],"type":"string","enumTitles":["9+ Exceptional","8–9 Excellent","7–8 Very good","6–7 Good","Below 6"]},"default":[],"description":"Include only these rating bands on the 0–10 scale; leave empty for all ratings."},"sortBy":{"enum":["recent","ratingHigh","ratingLow","helpful"],"type":"string","default":"recent","description":"Order supplied by the review service."},"hotelUrl":{"type":"string","description":"Public Agoda accommodation URL ending in /hotel/...html or /reviews/...html."},"language":{"type":"string","default":"all","description":"Original review language code, such as en, de, or ko. Use all for every language."},"cutoffDate":{"type":"string","description":"Return only reviews after this date, in YYYY-MM-DD form. Leave blank for all dates."},"aggregateRatings":{"type":"boolean","default":true,"description":"Add provider scores, category breakdowns, and review counts to every record."},"enabledProviders":{"type":"array","items":{"enum":["Agoda","Booking.com"],"type":"string","enumTitles":["Agoda","Booking.com"]},"default":["Agoda","Booking.com"],"description":"Include reviews from these displayed providers."},"maxReviewsPerHotel":{"type":"integer","default":100,"minimum":0,"description":"Maximum review records to return. Zero reads until public pagination ends, up to 100 pages."}}},"responseSchema":{"type":"json","example":{"count":1,"items":[{"rating":null,"hotelId":null,"hotelUrl":null,"hotelName":null,"ratingText":null,"reviewTitle":null,"hotelReviewId":null,"reviewPageUrl":null}],"product":"agoda"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.025","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.025/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.025","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.025","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_sNGlpFNEIvVjgn2SJi8_5","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.025","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Scrapes structured hotel reviews and aggregate ratings from Agoda and Booking.com for a given accommodation URL","exampleAgentPrompt":"Can you pull the 50 most recent Agoda and Booking.com reviews for this hotel — https://www.agoda.com/hotel/grand-hyatt-bangkok.html — filtered to only exceptional and excellent ratings in English, with aggregate scores included?","exampleUseCases":[{"title":"Competitor hotel sentiment analysis","prompt":"Grab the last 100 reviews from this Agoda listing — https://www.agoda.com/hotel/marina-bay-sands.html — from both Agoda and Booking.com, sorted by most helpful, and include the aggregate ratings breakdown so I can see how guests rate cleanliness and location."},{"title":"Recent negative review monitoring","prompt":"Fetch up to 50 reviews posted after 2024-01-01 for https://www.agoda.com/hotel/hilton-tokyo.html, but only show me the below_expectation and good rating bands so I can see what guests are complaining about recently."},{"title":"Multilingual review collection for a new market","prompt":"Pull all available Korean reviews from this Agoda hotel page — https://www.agoda.com/hotel/paradise-city-resort.html — sorted by highest rating first, with aggregate scores, up to 200 reviews total."}],"resultDescription":"A JSON object containing a count of returned reviews and an array of review records, each with hotel ID, hotel name, hotel URL, review rating, rating text, review title, review ID, and review page URL. When aggregateRatings is enabled, provider scores, category breakdowns (e.g. cleanliness, location, value), and total review counts are appended to each record.","failureModes":["Invalid or non-Agoda hotel URL returns empty result set (not charged)","Hotel with no public reviews returns empty items array","Unsupported language code may return zero results","cutoffDate in wrong format causes parameter rejection","Rate limits or anti-scraping measures on Agoda side may return partial data","Requesting providers not available for that property returns empty provider results"],"whenToPreferThis":"Choose this endpoint when you need structured, paginated review data from Agoda or Booking.com listings — especially when you need filtering by rating band, language, date, or provider, and when aggregate score breakdowns matter. Prefer this over general web scrapers when the target URL is an Agoda accommodation or reviews page and you need clean JSON output with hotel metadata included. Best suited for competitive intelligence, sentiment analysis pipelines, or travel recommendation systems that require fresh, per-property review data.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-02T00:47:17.129Z","isFirstParty":false,"canonicalSlug":"agoda-hotel-reviews-scraper-d86537f9"}