Supercasa

Search Properties

Search Supercasa listings for sale, for rent or in new-build developments.

get/supercasa/search

Request

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

Query parameters

locationstring nullable

Place name to search, e.g. Lisboa, Porto or Caldas da Rainha.

location_level'state' | 'town' | 'neighborhood' | 'zone' | 'null' nullable

How to interpret the location: state, town, neighborhood or zone. Sent only when you supply it — a level sent with an ambiguous name resolves to no match instead of the disambiguation options, so leaving it unset is what gets you those options and a selection token.

location_selection_tokenstring nullable

Opaque token from the autocomplete endpoint. Pass it instead of location — never alongside it — to resume an unambiguous search. Either this or location is required.

business'sale' | 'rent' | 'holiday_rent' | 'null' nullable

sale (default), rent or holiday_rent.

categorystring nullable

Search profile. property (default) covers the full filter set, rooms adds room preferences, new_construction covers empreendimentos.

category_ids[]integer[]

Specific category ids from the filters endpoint.

conditioninteger nullable

Condition id from the filters endpoint.

min_pricenumber nullable

Minimum asking price in EUR.

max_pricenumber nullable

Maximum asking price in EUR.

min_areanumber nullable

Minimum area in m².

max_areanumber nullable

Maximum area in m².

min_bedroomsinteger nullable

Minimum bedroom count.

max_bedroomsinteger nullable

Maximum bedroom count.

bathroomsinteger nullable

Minimum bathroom count.

features[]string[]

Feature names from the filters endpoint, e.g. elevador.

sort'relevance' | 'newest' | 'price_asc' | 'price_desc' | 'null' nullable

relevance (default), newest, price_asc or price_desc.

pageinteger nullable

Result page, 1 to 75. Each page holds 25 listings, so a single query tops out at 1,875 results.

Response

string required
OR

Changes

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