---
title: "Otodom location autocomplete"
method: GET
path: "/otodom/locations"
tags: ["Otodom"]
---

# Otodom location autocomplete

`GET /otodom/locations`

## Request

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

## Query parameters

- `query` string, required
- `limit` integer, nullable

## Response `200`

- union
  - string
  - object
    - `success` boolean, required
    - `data` object, required
      - `locations` object[], required
        - `id` string, nullable, required: Consumed verbatim as the search endpoint's `geo_path`.
        - `name` string, nullable, required
        - `full_name` string, nullable, required
        - `detailed_level` string, nullable, required
      - `query` string, required
      - `note` 'Results are not prefix-scoped upstream; use detailed_level to pick the intended granularity.', required: The upstream operation is not prefix-scoped: a `zoliborz` query returns villages in unrelated voivodeships. Every match is returned with its granularity so the caller chooses, rather than the service silently auto-selecting the first result.
  - object
    - `success` boolean, required
    - `error` object, required
      - `code` 'INVALID_PARAMETERS', required
      - `message` 'Otodom returned no locations for this query', required
  - object
    - `success` boolean, required
    - `error` object, required
      - `code` 'UPSTREAM_ERROR', required
      - `message` 'Failed to fetch Otodom locations', 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)