# Otodom Development API Documentation

Scrappa's `GET /api/otodom/development` endpoint returns a Polish investment or development with its per-unit pricing as JSON.

## What the response contains

Development title, description, location, decoded developer URL, image URLs and a `units` block. Each unit carries `unit_number`, `price`, `currency`, `price_per_square_meter`, `area_in_square_meters`, `rooms`, `floor`, `build_year`, `construction_status`, `available_from` and `market`.

## Truncated unit lists

Otodom renders at most 10 units on this page and offers no way to page further. The response therefore always includes `units.total_count` alongside `units.items` and sets `units.truncated` when the two disagree, so a short list is never mistaken for a complete one.

## Related Otodom endpoints

- `GET /api/otodom/search` with `estate_slug=mieszkanie,rynek-pierwotny` to find development slugs
- `GET /api/otodom/property` for a single unit listing

- **Documentation:** [https://scrappa.co/docs/otodom-api/otodom_development](https://scrappa.co/docs/otodom-api/otodom_development)
- **API group:** Otodom API
- **Endpoint:** `GET https://scrappa.co/api/otodom/development`

## Authentication

Send your Scrappa API key in the `X-API-KEY` request header. Paid endpoints also support accountless x402 payments when called without an API key.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `slug` | string | Yes | Development slug from the `developmentUrl` of a search result. |

## Example request

```bash
#!/bin/bash

curl -X GET \
    -H "x-api-key: YOUR_API_KEY_HERE" \
    "https://scrappa.co/api/otodom/development?slug=willa-kasprowicza-ID4CuW2"
```

## Example response

```json
{
    "success": true,
    "data": {
        "slug": "willa-kasprowicza-ID4CuW2",
        "title": "Willa Kasprowicza",
        "developer_url": "https://www.otodom.pl/pl/firmy/deweloperzy/example",
        "units": {
            "items": [
                {
                    "unit_number": "12",
                    "price": 1784692,
                    "currency": "PLN",
                    "price_per_square_meter": 18200,
                    "area_in_square_meters": 98.06,
                    "rooms": "3",
                    "floor": "2",
                    "construction_status": "available"
                }
            ],
            "total_count": 13,
            "truncated": true
        }
    }
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
|  | Error | No development carries that slug. This response is not billed. |
|  | Error | Otodom could not be reached. This response is not billed. |

## Frequently asked questions

### Where do I get a development slug?

From the `developmentUrl` field on any search result, or by searching with `estate_slug=mieszkanie,rynek-pierwotny`.

### Why do I get fewer units than total_count?

Otodom renders at most 10 units on the page. `units.truncated` is true when the list is incomplete.

### Is the developer contact block returned?

No. Developer contact details are removed along with owner phone numbers.

## More Scrappa resources

- [API documentation](https://scrappa.co/docs)
- [Full LLM-readable API reference](https://scrappa.co/llms-full.txt)
- [OpenAPI specification](https://scrappa.co/docs/api.json)
- [Pricing](https://scrappa.co/pricing)