{"uid":"cap_icwmel_O6T-bCwKMOy17f","slug":"agoda-hotel-review-scraper-x402-97929cfa","name":"Agoda Hotel Review Scraper (x402)","description":"Pay-per-call structured web data. Failed or empty runs are not charged.","url":"https://x402.186-241-26-229.sslip.io/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_6jHSpr2xyKjyN2A2uH3ur","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 review data from Agoda (and optionally Booking.com) for a given accommodation URL, returning reviews with ratings, titles, and aggregate scores.","exampleAgentPrompt":"Pull the 50 most recent English reviews for the Grand Hyatt Bangkok from its Agoda page at https://www.agoda.com/hotel/grand-hyatt-bangkok.html, only include reviews rated 'excellent' or above, and include the aggregate rating breakdown.","exampleUseCases":[{"title":"Hotel vetting before booking","prompt":"Grab the 30 most recent guest reviews in English for the Marriott Tokyo from its Agoda page at https://www.agoda.com/hotel/marriott-tokyo.html — include the aggregate scores and category breakdowns so I can see how it performs on cleanliness and service."},{"title":"Competitive review benchmarking","prompt":"Scrape up to 100 reviews from both Agoda and Booking.com for the Hilton Bali Resort at https://www.agoda.com/hotel/hilton-bali-resort.html, sorting by highest rating first, and include all languages so I can compare cross-platform sentiment."},{"title":"Monitoring recent negative feedback","prompt":"Get all reviews posted after 2024-01-01 for the Park Hotel Singapore at https://www.agoda.com/hotel/park-hotel-singapore.html that fall in the 'below_expectation' or 'good' rating bands, so I can flag recurring complaints."}],"resultDescription":"A JSON object containing a count of returned records and an array of review items, each with hotel ID, hotel name, hotel URL, rating, rating text, review title, review ID, and review page URL. When aggregateRatings is enabled, provider scores, category breakdowns, and total review counts are also included per record.","failureModes":["Invalid or non-Agoda hotel URL returns empty results (not charged)","Hotel page with no public reviews returns count:0 items:[] (not charged)","Unsupported language code may return no filtered results","cutoffDate in wrong format (not YYYY-MM-DD) may cause parsing errors","Rate limiting or bot detection by Agoda may result in failed run (not charged)","maxReviewsPerHotel=0 with large review count may time out on deeply paginated hotels"],"whenToPreferThis":"Choose this endpoint when you need structured, per-review data from Agoda hotel pages — including ratings, review text, and aggregate scores — without building your own scraper. Prefer it over generic web scrapers because it handles Agoda's pagination, multi-provider display (Agoda + Booking.com), and review filtering natively. It is pay-per-successful-call, so failed or empty scrapes cost nothing, making it safe to use speculatively.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-02T00:47:50.797Z","isFirstParty":false,"canonicalSlug":"agoda-hotel-review-scraper-x402-97929cfa"}