Otodom

Search Otodom listings

get/otodom/search

Request

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

Query parameters

transaction'sprzedaz' | 'wynajem' required

sprzedaz for sale, wynajem for rent.

estate_slug'mieszkanie' | 'kawalerka' | 'dom' | 'lokal' | 'dzialka' | 'garaz' | 'haleimagazyny' | 'pokoj' | 'inwestycja' | 'mieszkanie,rynek-pierwotny' | 'mieszkanie,rynek-wtorny' | 'kawalerka,rynek-pierwotny' required

Estate slug. See the endpoint reference for the full list; an unlisted value silently returns the nationwide feed.

geo_pathstring required

Location path of 2 to 6 segments, taken from the Otodom locations endpoint.

price_mininteger nullable

Minimum price.

price_maxinteger nullable

Maximum price.

area_mininteger nullable

Minimum area in square meters.

area_maxinteger nullable

Maximum area in square meters.

price_per_meter_mininteger nullable
build_year_mininteger nullable
floors_number_mininteger nullable
days_since_createdinteger nullable
rooms_number[]string[]

Room counts: ONE, TWO, THREE, FOUR, FIVE or SIX_OR_MORE. Repeat the parameter for several values.

extras[]string[]

Amenities such as BALCONY, LIFT or GARAGE. Repeat the parameter for several values.

owner_type'DEVELOPER' | 'PRIVATE' | 'AGENCY' | 'null' nullable

DEVELOPER, PRIVATE or AGENCY.

is_private_ownerboolean nullable
has_discount'1' | 'null' nullable

Only true is supported. Omit it for listings both with and without a discount.

view_type'map' | 'listing' | 'null' nullable

map or listing. Only map changes the result set.

distance_radiusinteger nullable

Radius in kilometers. This filter is unstable upstream; responses using it carry a caveat.

by'DEFAULT' | 'LATEST' | 'PRICE' | 'AREA' | 'null' nullable

Sort field: DEFAULT, LATEST, PRICE or AREA.

direction'ASC' | 'DESC' | 'null' nullable

Sort direction: ASC or DESC.

pageinteger nullable

Page number. A page past the end is clamped rather than rejected.

limitinteger nullable

Items per page, up to 72.

Response

string required
OR
OR
OR
OR

Changes

No recorded changes to this operation across all 4 revisions of this API.