---
title: "Search Otomoto vehicle listings"
method: GET
path: "/otomoto/search"
tags: ["Otomoto"]
---

# Search Otomoto vehicle listings

`GET /otomoto/search`

## Request

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

## Query parameters

- `make_id` string, nullable
- `model_id` string, nullable
- `generation` string, nullable
- `price_min` integer, nullable
- `price_max` integer, nullable
- `year_min` integer, nullable
- `year_max` integer, nullable
- `mileage_min` integer, nullable
- `mileage_max` integer, nullable
- `engine_power_max` integer, nullable
- `fuel[]` string[]
- `transmission[]` string[]
- `body_type[]` string[]
- `city_id` integer, nullable
- `dist` integer, nullable
- `sort` string, nullable
- `page` integer, nullable

## Response `200`

- union
  - string
  - object
    - `success` boolean, required
    - `data` object, required
      - `listings` array[], required
        - unknown[]
          - unknown
      - `pagination` object, required
        - `page` unknown, required
        - `page_size` integer, required
        - `current_offset` integer, required
        - `total` integer, required
        - `has_more` boolean, required: The real upstream signal: the offset of the next page exists while the current offset plus the page size stays below the total. An empty page is "no items here", not "end".
        - `live_snapshot` boolean, required
      - `facets` object, required
        - `make` string, nullable, required
        - `model` string, nullable, required
        - `sort` string, nullable, required
    - `meta` object, required
      - `endpoint_family` 'search', required
  - object
    - `success` boolean, required
    - `error` object, required
      - `code` 'INVALID_PARAMETERS', required
      - `message` string, nullable, required
  - object
    - `success` boolean, required
    - `error` object, required
      - `code` 'PROXY_EXHAUSTION' | 'UPSTREAM_ERROR', required
      - `message` 'Otomoto search page carried no result state', required
  - object
    - `success` boolean, required
    - `error` object, required
      - `code` 'PROXY_EXHAUSTION' | 'UPSTREAM_ERROR', required
      - `message` 'Otomoto search page carried no render state', required
  - object
    - `success` boolean, required
    - `error` object, required
      - `code` 'PROXY_EXHAUSTION' | 'UPSTREAM_ERROR', required
      - `message` 'Failed to fetch Otomoto 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)