Sign in Get API key
Otodom API

Polish Property Listings and Market Search via REST API

Search listings, resolve locations and retrieve property or development details from Otodom, Poland’s largest real estate portal. Scrappa turns Otodom data into a structured API for building Polish property search, rental analysis, new-build tracking and market-sizing tools.

500 free credits
No card needed
From $0.20 / 1k
Pay as you go
Structured JSON
Ready for apps
API key access
Test in minutes
Start for free View documentation
Browse endpoints Try first endpoint
5
Endpoints
Poland’s largest
Property portal
$0.20
Per 1k requests

Try it now

Make one request. Inspect structured JSON.

Use the first endpoint in this API family with a Scrappa API key. Every account includes 500 free monthly credits, so you can validate the response shape before buying credits.

Get free API key Try in Playground Open docs
Request preview
Request 
curl -X GET "https://scrappa.co/api/otodom/search?transaction=sprzedaz&estate_slug=mieszkanie&geo_path=mazowieckie/warszawa/warszawa/warszawa&limit=5" \
  -H "Accept: application/json" \
  -H "X-API-KEY: YOUR_API_KEY"
JSON response 
{
  "success": true,
  "data": {
    "items": [
      {
        "id": "64629218",
        "slug": "mieszkanie-3-pokojowe-warszawa-ID4nb0K",
        "title": "Mieszkanie 3 pokojowe, Warszawa",
        "estate": "FLAT",
        "transaction": "SELL",
        "totalPrice": {"value": 899000, "currency": "PLN"},
        "areaInSquareMeters": 68.5,
        "roomsNumber": "THREE"
      }
    ],
    "pagination": {"total_items": 20226, "total_pages": 281, "current_page": 1, "items_per_page": 72},
    "result_count": 20226
  }
}

What you can build

Structured data for real applications. Here are some ideas.

Polish Property Search

Build search experiences for apartments, houses, rooms, plots and commercial premises across Warsaw, Kraków, Wrocław, Gdańsk and every other covered Polish location.

Rental and Sales Market Analysis

Compare asking prices and listing supply by city, district, transaction type and property category using repeatable Otodom search and count queries.

New-Build Monitoring

Track primary-market apartments and residential developments, then inspect development pages for per-unit prices, sizes and availability signals.

Listing Enrichment

Enrich a matching Otodom search result with its detailed description, characteristics, location, agency and image URLs.

Available endpoints

Everything you need in one API.

GET

Property Search

/api/otodom/search

Search Otodom listings by Polish location, transaction, property type, price, area and other filters

Try in Playground View docs
GET

Property Details

/api/otodom/property

Get a listing description, characteristics, location, agency and images by numeric advert id

Try in Playground View docs
GET

Development Details

/api/otodom/development

Retrieve development details and available per-unit pricing from a development slug

Try in Playground View docs
GET

Search Count

/api/otodom/count

Count listings matching a location and Otodom property filters without paging through results

Try in Playground View docs

Scrappa vs Otodom (no public developer API)

See how Scrappa compares to the official API.

API available
Scrappa: Yes (5 endpoints)
Otodom (no public developer API): No public developer API
Property search
Scrappa: Programmatic filters
Otodom (no public developer API): Website interface
Property details
Scrappa: Structured JSON
Otodom (no public developer API): Individual listing pages
Location lookup
Scrappa: Geo paths for search
Otodom (no public developer API): Website interface
Development units
Scrappa: Per-unit details
Otodom (no public developer API): Individual development pages
Market sizing
Scrappa: Count endpoint
Otodom (no public developer API): Manual search results
Free tier
Scrappa: 500 credits/month
Otodom (no public developer API): N/A
Integration ready
Scrappa: REST API
Otodom (no public developer API): No public API

Key features

Search Polish listings for sale and rent across cities, districts and quarters
Filters for property type, price, area, rooms, amenities and owner type
Full listing detail with characteristics, location, agency and image URLs
Development detail with per-unit prices and unit availability signals
Location autocomplete returns ready-to-use Otodom geo paths
Count matching listings without paging through search results
Structured JSON responses and one Scrappa API key
No public Otodom developer API is required

Frequently asked questions

Search property listings across Poland, resolve locations into Otodom geo paths, retrieve full listing and development details, and count ads matching a filter set.

Use the locations endpoint to resolve cities, districts and other supported places into the exact geo_path accepted by search and count. Warsaw, Kraków, Wrocław, Gdańsk and other regions are supported by the source portal.

Yes. Set transaction to wynajem for rent or sprzedaz for sale, then refine the query with a supported property slug and optional filters such as price, area and rooms.

Search the primary market with estate_slug=mieszkanie,rynek-pierwotny, then pass a result developmentUrl slug to the development endpoint. Its response includes unit pricing and marks a truncated unit list when Otodom renders only part of the inventory.

Send your Scrappa API key in the X-API-KEY header. No Otodom partner agreement or separate upstream API credentials are needed.

No. Failed requests return a non-success HTTP response with an error object and are not charged.

Start using the Otodom API

Sign up and get 500 free credits. No credit card required.

Create Free Account View Documentation