# Otodom Warsaw Real Estate Listings

> Otodom Warsaw Real Estate Listings is a paid API for AI agents from api.timzinin.com, paid per call via x402, $0.02/call, status unknown (last checked 2026-09-15).

Fetches current real estate listings from Otodom.pl for the Warsaw market, returning property details including price, area, rooms, location, and images

## Facts

- Endpoint: POST https://api.timzinin.com/api/otodom-warsaw
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/otodom-warsaw-real-estate-listings-caaa5906
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_W_xA7Ab6LKvgPI_ks64tO

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability otodom-warsaw-real-estate-listings-caaa5906 -d '<json body>'
```

Example prompt: Can you pull the latest 2-room apartment listings for sale in Wola, Warsaw from Otodom, and show me the prices, sizes, and locations?

## When to prefer this

Use this endpoint when you need live Warsaw real estate listing data from Otodom.pl, including prices, room counts, areas, and locations, without maintaining your own scraper. Prefer this over generic web search when you need structured property data (price, sqm, rooms) rather than plain text results. Best suited for Warsaw-specific residential property searches (sale or rent) on the Otodom platform.

## Known failure modes

- Otodom website structure changes breaking the scraper — returns empty results or parsing errors
- No listings found matching the query — item_count returns 0
- Network timeout if Otodom is slow — run_ms exceeds threshold
- Invalid or malformed query parameters — may return error or empty result set
- Rate limiting or blocking by Otodom — returns failed scrape

## How this service works

Pay-per-call data & tool APIs

## Output

A JSON object containing metadata (run time in ms, settlement status, item count) and a results array of property listings, each with: listing URL, found status, price in PLN, number of rooms, title, array of image URLs, area in sqm, currency, location string (district/borough/city), deal type (sale/rent), posted date, and property type (e.g. FLAT).

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "city": {
   "type": "string"
  },
  "deal_type": {
   "enum": [
    "sprzedaz",
    "wynajem"
   ],
   "type": "string"
  },
  "max_items": {
   "type": "integer",
   "maximum": 2000,
   "minimum": 1
  },
  "max_pages": {
   "type": "integer",
   "maximum": 20,
   "minimum": 1
  },
  "property_type": {
   "enum": [
    "mieszkanie",
    "dom"
   ],
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "meta": {
   "run_ms": 1200,
   "settled": true,
   "item_count": 1
  },
  "results": [
   {
    "url": "https://www.otodom.pl/pl/oferta/2-pokojowe-mieszkanie-38m2-loggia-bez-prowizji-ID4uooW",
    "found": true,
    "price": 878000,
    "rooms": 2,
    "title": "2-pokojowe mieszkanie 38m2 + loggia Bez Prowizji",
    "images": [
     "https://ireland.apollo.olxcdn.com/v1/files/....image;s=655x491;q=80"
    ],
    "area_sqm": 38.15,
    "currency": "PLN",
    "location": "Odolany, Wola, Warszawa, mazowieckie",
    "deal_type": "sale",
    "posted_date": "2026-07-30 09:16:08",
    "property_type": "FLAT"
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/otodom-warsaw-real-estate-listings-caaa5906/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.timzinin.com](https://www.zero.xyz/host/api.timzinin.com/llms.txt)