{"uid":"cap_yIuxKSLiaZ0ZeKOtyS2W5","slug":"otodom-poland-real-estate-scraper-a228b7ed","name":"Otodom Poland Real Estate Scraper","description":"Pay-per-call structured web data. Failed or empty runs are not charged.","url":"https://api.scrapeforagents.tech/v1/otodom?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"market":{"enum":["ALL","PRIMARY","SECONDARY"],"type":"string","default":"ALL","description":"Primary or secondary market, or both."},"areaMax":{"type":"integer","minimum":0,"description":"Maximum property area in square meters."},"areaMin":{"type":"integer","minimum":0,"description":"Minimum property area in square meters."},"location":{"type":"string","description":"Path after the property category in a search URL, such as mazowieckie/warszawa/warszawa/warszawa. Use cala-polska for all Poland."},"maxItems":{"type":"integer","default":50,"minimum":0,"description":"Stop after this many unique properties across all start URLs. Zero means no actor cap."},"priceMax":{"type":"integer","minimum":0,"description":"Maximum advertised price in PLN."},"priceMin":{"type":"integer","minimum":0,"description":"Minimum advertised price in PLN."},"roomsMax":{"type":"integer","maximum":10,"minimum":1,"description":"Upper room count included in the search."},"roomsMin":{"type":"integer","maximum":10,"minimum":1,"description":"Lower room count included in the search."},"buildYear":{"type":"integer","maximum":2100,"minimum":1800,"description":"Minimum construction year. This filter is applied by the search page."},"startUrls":{"type":"array","description":"Public search result or property URLs. When supplied, search filters below are ignored."},"postedDate":{"enum":["","1","3","7","14"],"type":"string","default":"","description":"Keep listings first created within this number of days. The date filter is applied after fetching search results."},"searchType":{"enum":["sprzedaz","wynajem"],"type":"string","default":"sprzedaz","description":"Choose properties for sale or rent."},"propertyType":{"enum":["mieszkanie","dom","dzialka","lokal","haleimagazyny","garaz"],"type":"string","default":"mieszkanie","description":"Property category used to construct a search."},"extractDetails":{"type":"boolean","default":true,"description":"Retrieve full descriptions, coordinates, building attributes and complete image galleries."}}},"responseSchema":{"type":"json","example":{"count":1,"items":[{"id":null,"price":null,"title":null,"propertyUrl":null,"transaction":null,"propertyType":null,"priceCurrency":null,"priceFormatted":null}],"product":"otodom"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.04","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.04/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.04","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.04","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_7XHCu-IN0ayzBXn1OqPEe","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.04","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Scrapes structured property listings from Otodom.pl, Poland's leading real estate portal, with filters for price, area, rooms, location, and transaction type.","exampleAgentPrompt":"Search Otodom for apartments for sale in Warsaw (mazowieckie/warszawa/warszawa/warszawa) with 2 to 3 rooms, priced between 400000 and 800000 PLN, minimum 50 sqm, listed in the last 7 days — give me up to 30 results with full details.","exampleUseCases":[{"title":"Warsaw apartment hunting on a budget","prompt":"Find me apartments for sale in Warsaw on Otodom — 2 or 3 rooms, between 40 and 70 sqm, priced up to 600000 PLN, secondary market only, posted within the last 14 days. Show me up to 25 listings."},{"title":"Rental flat search in Krakow","prompt":"I'm looking for flats to rent in Krakow on Otodom — at least 2 rooms, max rent 3000 PLN per month, anywhere in the Malopolskie region. Give me up to 50 results with full property details."},{"title":"Investment land plot search across Poland","prompt":"Search all of Poland on Otodom for land plots (dzialka) for sale, primary market, built no earlier than 2000, priced between 100000 and 500000 PLN. Return up to 30 listings."}],"resultDescription":"Returns a JSON object with a count of matched listings and an array of property items, each containing the property ID, title, price, formatted price, currency, property URL, transaction type, and property type. With extractDetails enabled, full descriptions and coordinates are also included.","failureModes":["Invalid location path returns no results or an error","Overly restrictive filter combination yields zero listings (not charged)","Otodom site structure changes may break extraction temporarily","Invalid enum values for propertyType or searchType cause request rejection","Network or scraping timeout for very large result sets"],"whenToPreferThis":"Use this endpoint when you need structured property listing data from Otodom.pl — Poland's largest real estate portal — with precise filtering by location, price, area, rooms, market type, or recency. Prefer this over generic web scrapers when targeting Polish real estate specifically, as it understands Otodom's URL schema and search filters natively.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-02T00:47:58.047Z","isFirstParty":false,"canonicalSlug":"otodom-poland-real-estate-scraper-a228b7ed"}