APIs / Otodom / Search

Otodom: Search

Search from Otodom as JSON. 1 credit per successful call.

GET /v1/otodom/search

Parameters

Send parameters in the query string.

ParameterTypeRequiredAllowed values
transactionstringRequiredsprzedaz, wynajem
estate_slugstringRequiredmieszkanie, kawalerka, dom, lokal, dzialka, garaz, haleimagazyny, pokoj, inwestycja, mieszkanie,rynek-pierwotny, mieszkanie,rynek-wtorny, kawalerka,rynek-pierwotny
geo_pathstringRequiredAny
price_minintegerOptionalAny
price_maxintegerOptionalAny
area_minintegerOptionalAny
area_maxintegerOptionalAny
price_per_meter_minintegerOptionalAny
build_year_minintegerOptionalAny
floors_number_minintegerOptionalAny
days_since_createdintegerOptionalAny
rooms_number[]list of stringOptionalONE, TWO, THREE, FOUR, FIVE, SIX_OR_MORE
extras[]list of stringOptionalBALCONY, LIFT, GARAGE, AIR_CONDITIONING, HEATING, FURNISHED, WASHING_MACHINE, DISHWASHER, FRIDGE, INTERNET, GARDEN, BASEMENT, ELEVATOR, SECURITY, OUTBUILDING, BALCONY_OR_TERRACE
owner_typestringOptionalDEVELOPER, PRIVATE, AGENCY
is_private_ownerbooleanOptionalAny
has_discountstringOptional1
view_typestringOptionalmap, listing
distance_radiusintegerOptionalAny
bystringOptionalDEFAULT, LATEST, PRICE, AREA
directionstringOptionalASC, DESC
pageintegerOptionalAny
limitintegerOptionalAny

Example request

cURLshell
curl "https://api.perceptlayer.com/v1/otodom/search?transaction=sprzedaz&estate_slug=mieszkanie%2Crynek-pierwotny&geo_path=mazowieckie%2Fwarszawa%2Fwarszawa%2Fwarszawa&limit=5" \
  -H "X-API-Key: $API_KEY"