Agoda

Search Agoda hotels by city

Returns hotel search results for an Agoda city: the matching property ids for that city plus a direct link to each property's listing page. Callers may supply a known Agoda city id or a free-text city name; when both are supplied city_id takes precedence.

get/agoda/hotels/search

Request

  • Base URL: https://api.crawlora.net/api/v1
  • URL: https://api.crawlora.net/api/v1/agoda/hotels/search
  • Auth: API key in header x-api-key

Query parameters

city_idinteger

Numeric Agoda city id, e.g. 9395 for Bangkok. Either city_id or city is required; city_id takes precedence when both are supplied.

citystring

Free-text city name, resolved to a numeric city id via Agoda's own destination search. Ignored when city_id is also supplied.

pageinteger

1-indexed result page, defaults to 1

limitinteger

Results per page, defaults to 10, maximum 50

Headers

x-api-keystring required

API key required

Response

OK

codeinteger
msgstring

Example response

{
  "code": 200,
  "data": {
    "city_id": 9395,
    "count": 10,
    "limit": 10,
    "page": 1,
    "properties": [
      {
        "property_id": 10630,
        "source_url": "https://www.agoda.com/search?cid=-1&selectedproperty=10630&city=9395"
      }
    ]
  },
  "msg": "OK"
}

Changes

No recorded changes to this operation across all 3 revisions of this API.