# SiteCheck Health & Travel – Agoda Top Hotels by City

> SiteCheck Health & Travel – Agoda Top Hotels by City is a paid API for AI agents from api.healthtravel-api.workers.dev, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-29).

Returns top hotels in a city from Agoda's city guide page, including hotel ID, name, star rating, area, amenities, review score, guest quote, and average nightly price.

## Facts

- Endpoint: GET https://api.healthtravel-api.workers.dev/api/travel/agoda?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-29
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/sitecheck-health-travel-agoda-top-hotels-by-city-cd6054b6
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_pvcArIvT567jC0JKnycSW

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability sitecheck-health-travel-agoda-top-hotels-by-city-cd6054b6
```

Example prompt: Can you pull up the top hotels in Bangkok from Agoda — I want to see ratings, amenities like pools and free Wi-Fi, guest reviews, and average nightly prices?

## When to prefer this

Use this endpoint when you need a quick, no-dates-required snapshot of top hotels in a specific city as curated by Agoda's city guide — ideal for travel research, itinerary planning, or hotel discovery without needing to specify check-in/check-out dates. Prefer this over live booking APIs when you want editorial rankings with rich metadata (amenities, reviews, guest quotes, prices) rather than real-time availability.

## Known failure modes

- Invalid or unrecognized city slug returns empty results or an error
- City slug with wrong country code (e.g. bangkok-sg) may return no results
- Agoda page structure changes could break scraping and return partial or malformed data
- Limit values outside 1–20 may be ignored or cause an error
- Network timeouts if Agoda's servers are slow or block the request

## How this service works

Top hotels in a city from Agoda's city guide page (no dates needed): about 10 properties with Agoda hotel ID, name, star rating, area, amenities (Wi-Fi, parking, breakfast, pool …), review score out of 10 with its label and number of reviews, a recent guest quote, average price per night with currency, and the Agoda hotel link. The city is Agoda's URL slug, e.g. bangkok-th, tokyo-jp, bali-id, london-gb.

## Output

A JSON object with the city slug, count of results, page title, source URL, and an array of up to 20 hotel objects each containing: Agoda hotel ID, name, star rating, area, amenities list, review score (0–10) and label, number of reviews, a recent guest quote snippet, average price per night with currency, and direct Agoda hotel link. Also includes a checkedAt timestamp.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "city"
     ],
     "properties": {
      "city": {
       "type": "string",
       "description": "Agoda city slug: <city>-<2-letter country>, e.g. bangkok-th, singapore-sg, paris-fr"
      },
      "limit": {
       "type": "string",
       "description": "Hotels, 1 to 20 (default 20)"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "city": "bangkok-th",
  "count": 10,
  "title": "11 Best Hotels in Bangkok, Thailand",
  "source": "https://www.agoda.com/city/bangkok-th.html",
  "results": [
   {
    "url": "https://www.agoda.com/ibis-styles-bangkok-sukhumvit-50/hotel/bangkok-th.html",
    "area": "Sukhumvit,Bangkok",
    "name": "Sunday Harbour View Sukhumvit 50 Hotel",
    "stars": 3.5,
    "hotelId": 1254412,
    "reviews": 2750,
    "currency": "USD",
    "amenities": [
     "Free Wi-Fi",
     "Free parking"
    ],
    "guestQuote": "Very good. Even though it's no longer part of the Ibis chain, the quality is still there. The room is small, the air conditioning is cool, the bed is good, and the soundproofing is not great but it’s not bad. It's great to find cheap accommodation in the city. The hotel’s location may not be on the …",
    "reviewLabel": "Very good",
    "reviewScore": 7.7,
    "avgPricePerNight": 62
   },
   {
    "url": "https://www.agoda.com/solaria-nishitetsu-hotel-bangkok/hotel/bangkok-th.html",
    "area": "Sukhumvit,Bangkok",
    "name": "Solaria Nishitetsu Hotel Bangkok",
    "stars": 4,
    "hotelId": 14654101,
    "reviews": 16160,
    "currency": "USD",
    "amenities": [
     "Free Wi-Fi",
     "Pool with view"
    ],
    "guestQuote": "I'm glad I chose this hotel for my first time in Thailand. The room was lovely and clean, and the view of Terminal 21 and the intersection from the window was beautiful. There were always staff members who could speak Japanese, which gave me peace of mind. I apologize for any inconvenience caused wi…",
    "reviewLabel": "Exceptional",
    "reviewScore": 9.2,
    "avgPricePerNight": 151
   }
  ],
  "checkedAt": "2026-10-23T09:36:37.388Z"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/sitecheck-health-travel-agoda-top-hotels-by-city-cd6054b6/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.healthtravel-api.workers.dev](https://www.zero.xyz/host/api.healthtravel-api.workers.dev/llms.txt)
