---
title: "Search Agoda Homes & Apartments by city"
method: GET
path: "/agoda/homes/search"
tags: ["Agoda"]
---

# Search Agoda Homes & Apartments by city

`GET /agoda/homes/search`

## Request

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

Returns Homes & Apartments results for an Agoda city: full listing detail for every matching property whose accommodation type is Apartment. 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

- AgodaHomesSearchResponseDoc
  - `code` integer
  - `data` AgodaHomesSearchResponse
    - `city_id` integer
    - `count` integer
    - `homes` AgodaDetailResponse[]
      - `accommodation_type` integer: AccommodationType is Agoda's own numeric property-type code (contentSummary.accommodationType), confirmed live 2026-08-05. Known values: 34 = Hotel, 33 = Hostel, 37 = Resort, 120 = Apartment.
      - `address` AgodaAddress
        - `address1` string
        - `city` AgodaCity
          - `id` integer
          - `name` string
        - `country` AgodaCountry
          - `id` integer
          - `name` string
        - `postal_code` string
      - `chain_id` integer
      - `children_stay_free_type_id` integer
      - `description_long` string
      - `description_short` string
      - `display_name` string
      - `formerly_name` string
      - `main_image_url` string: MainImageURL is the property's primary photo, resolved from Agoda's own content API (contentImages.mainImage.urls) and normalized to an absolute https:// URL. Empty if Agoda has no main image on file.
      - `number_of_rooms` string
      - `policy` AgodaPolicy
        - `additional` string[]
        - `adult` string[]
        - `extra_bed` string[]
        - `min_age` string[]
      - `property_id` integer
      - `rating` number
      - `source_url` string: SourceURL is a real, live-verified Agoda URL that resolves directly to this property (Agoda's own affiliate redirect target), even though it is not the pretty slug-based hotel page.
    - `limit` integer
    - `page` integer
  - `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/afac9b012a27?raw)