---
title: "Count Otodom listings"
method: GET
path: "/otodom/count"
tags: ["Otodom"]
---

# Count Otodom listings

`GET /otodom/count`

## Request

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

## Query parameters

- `transaction` 'sprzedaz' | 'wynajem', required
- `geo_path` string, required
- `estate` 'FLAT' | 'HOUSE' | 'GARAGE' | 'HALL' | 'INVESTMENT' | 'TERRAIN' | 'COMMERCIAL_PROPERTY' | 'OFFICE' | 'BUILDING' | 'ROOM' | 'null', nullable
- `market` 'PRIMARY' | 'SECONDARY' | 'null', nullable
- `use_types[]` string[]
- `rooms_number[]` string[]
- `owner_type` 'DEVELOPER' | 'PRIVATE' | 'AGENCY' | 'null', nullable
- `price_min` integer, nullable
- `price_max` integer, nullable
- `area_min` integer, nullable
- `area_max` integer, nullable
- `has_discount` boolean, nullable

## Response `200`

- union
  - string
  - object
    - `success` boolean, required
    - `data` object, required
      - `total` string, nullable, required
      - `facets` object, required
        - `location` string, nullable, required
        - `estate` union, required
          - string
          - 'FLAT'
        - `transaction` union, required
          - string
          - 'SELL'
        - `market` union, required
          - string
          - 'ALL'
        - `owner_type` string, nullable, required
        - `rooms_number` string, nullable, required
        - `use_types` string, nullable, required
        - `price` object, required
          - `min` string, nullable, required
          - `max` string, nullable, required
        - `area` object, required
          - `min` string, nullable, required
          - `max` string, nullable, required
        - `discount` string, nullable, required
      - `point_in_time` boolean, required: Counts are a point-in-time read and drift between calls, so no caller should assert an exact total across time.
  - object
    - `success` boolean, required
    - `error` object, required
      - `code` 'INVALID_PARAMETERS', required
      - `message` 'Otodom rejected these count filters', required
  - object
    - `success` boolean, required
    - `error` object, required
      - `code` 'COUNT_HASH_ROTATED' | 'UPSTREAM_ERROR', required
      - `message` 'Failed to fetch Otodom listing counts', required
  - object
    - `success` boolean, required
    - `error` object, required
      - `code` 'UPSTREAM_ERROR', required
      - `message` 'Otodom count operation is not configured', 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)