---
title: "Search Agoda hotels by city"
method: GET
path: "/agoda/hotels/search"
tags: ["Agoda"]
---

# Search Agoda hotels by city

`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`

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.

## Query parameters

- `city_id` integer
- `city` string
- `page` integer
- `limit` integer

## Headers

- `x-api-key` string, required

## Response `200`

OK

- AgodaSearchResponseDoc
  - `code` integer
  - `data` AgodaSearchResponse
    - `city_id` integer
    - `count` integer
    - `limit` integer
    - `page` integer
    - `properties` AgodaPropertySummary[]
      - `property_id` integer
      - `source_url` string
  - `msg` string

## Other responses

- `400`: Bad Request
- `404`: Not Found
- `500`: Internal Server Error
- `503`: Service Unavailable

---

[API](https://skmtc.dev/crawlora/apis/crawlora-api.md) · [All operations](https://skmtc.dev/crawlora/apis/crawlora-api/llms.txt) · [OpenAPI document](https://skmtc.dev/crawlora/apis/crawlora-api/revisions/028417aa35bb?raw)