---
title: "Search Otodom listings"
method: GET
path: "/otodom/search"
tags: ["Otodom"]
---

# Search Otodom listings

`GET /otodom/search`

## Request

- Base URL: `https://scrappa.co/api`
- URL: `https://scrappa.co/api/otodom/search`
- Auth: API key in header `X-API-KEY`

## Query parameters

- `transaction` 'sprzedaz' | 'wynajem', required
- `estate_slug` 'mieszkanie' | 'kawalerka' | 'dom' | 'lokal' | 'dzialka' | 'garaz' | 'haleimagazyny' | 'pokoj' | 'inwestycja' | 'mieszkanie,rynek-pierwotny' | 'mieszkanie,rynek-wtorny' | 'kawalerka,rynek-pierwotny', required
- `geo_path` string, required
- `price_min` integer, nullable
- `price_max` integer, nullable
- `area_min` integer, nullable
- `area_max` integer, nullable
- `price_per_meter_min` integer, nullable
- `build_year_min` integer, nullable
- `floors_number_min` integer, nullable
- `days_since_created` integer, nullable
- `rooms_number[]` string[]
- `extras[]` string[]
- `owner_type` 'DEVELOPER' | 'PRIVATE' | 'AGENCY' | 'null', nullable
- `is_private_owner` boolean, nullable
- `has_discount` '1' | 'null', nullable
- `view_type` 'map' | 'listing' | 'null', nullable
- `distance_radius` integer, nullable
- `by` 'DEFAULT' | 'LATEST' | 'PRICE' | 'AREA' | 'null', nullable
- `direction` 'ASC' | 'DESC' | 'null', nullable
- `page` integer, nullable
- `limit` integer, nullable

## Response `200`

- union
  - string
  - object
    - `success` boolean, required
    - `data` object, required
      - `items` array[], required
        - unknown[]
          - unknown
      - `pagination` object, required
        - `total_items` string, nullable, required
        - `total_pages` string, nullable, required
        - `current_page` string, nullable, required
        - `items_per_page` string, nullable, required
      - `requested` object, required
        - `page` unknown, required
        - `limit` unknown, required
      - `resolved_location` string, nullable, required
      - `result_count` string, nullable, required
      - `page_clamped` boolean, required
      - `limit_clamped` boolean, required
      - `caveats` unknown[], required
        - unknown
  - object
    - `success` boolean, required
    - `error` object, required
      - `code` 'INVALID_LOCATION', required
      - `message` 'Otodom search returned no listings for this location', required
  - object
    - `success` boolean, required
    - `error` object, required
      - `code` 'INVALID_PARAMETERS', required
      - `message` 'Otodom search page carried no result state', required
  - object
    - `success` boolean, required
    - `error` object, required
      - `code` 'INVALID_PARAMETERS' | 'UPSTREAM_ERROR', required
      - `message` 'Failed to fetch Otodom search results', required

## Other responses

- `401`: Unauthorized - API key is missing or invalid
- `422`: Validation error

---

[API](https://skmtc.dev/scrappa/apis/scrappa-api-documentation.md) · [All operations](https://skmtc.dev/scrappa/apis/scrappa-api-documentation/llms.txt) · [OpenAPI document](https://skmtc.dev/scrappa/apis/scrappa-api-documentation/revisions/1e1aa78ff103?raw)