Imovirtual
Portugal's property portal: flats, houses, plots and new developments for sale and rent, with price in EUR, m² price, market and the advertiser.
/imovirtual/v1/search3 creditsSearch sale or rental listings on imovirtual.com (Portugal, prices in EUR): property type, location (an id from `locations`), price, price per m², area, rooms, floor, build year, advertiser type (private / agency / developer), market (primary / secondary), listing age, keyword in the description, extras, building type, sort and page. Each row: listing id, title, URL, total price or monthly rent, price per m², area, rooms, floor, location down to the parish, advertiser type and agency, dates, number of photos. Plus the source's own total and page count. Every filter is checked against the source's own echo: a value the site did not apply is refused, never silently ignored.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| transaction = sell | optional | sell · rent | Sale or rent (comprar / arrendar). For `rent`, `price` is the monthly rent in EUR. |
| estate = flat | optional | flat · house · plot · commercial · hall · garage · room · investment | Property type. `investment` lists new-development projects (empreendimentos); flat results also contain development rows (`kind`=investment). |
| location | optional | — | Location id as imovirtual.com writes it in its URLs, taken from the `locations` action (`location_id`), e.g. `lisboa` (Lisbon district), `porto/porto` (Porto council), `lisboa/oeiras/porto-salvo` (a parish). Omit for the whole of Portugal. An unknown id is rejected (INVALID_PARAM). |
| min_price | optional | 0– | Minimum price in EUR (total price; monthly rent for `rent`). |
| max_price | optional | 0– | Maximum price in EUR (total; monthly rent for `rent`). |
| min_price_per_m2 | optional | 0– | Minimum price per m². |
| max_price_per_m2 | optional | 0– | Maximum price per m². |
| min_area | optional | 0– | Minimum area in m². |
| max_area | optional | 0– | Maximum area in m². |
| rooms | optional | 1 · 2 · 3 · 4 · 5 · 6+ | Number of rooms, one or more (`2` or `2,3`); `6+` = six or more (the site's own top class). Several values are combined with OR in ONE request. |
| floors | optional | cellar · ground · 1 · 2 · 3 · 4 · 5 · 6 · 7 · 8 · 9 · 10 · above_10 · garret | Floor(s): `cellar`, `ground`, `1`…`10`, `above_10`, `garret`. Several values combine with OR. |
| min_build_year | optional | 1700–2100 | Built in or after this year. |
| max_build_year | optional | 1700–2100 | Built in or before this year. |
| owner_type | optional | private · agency · developer | Who placed the ad (the site's own advertiser filter). |
| market | optional | primary · secondary | Primary market (new build sold by the developer) or secondary (resale). |
| days_since_created | optional | 1 · 3 · 7 · 14 · 30 | Only listings added in the last N days. |
| description | optional | — | A word that must appear in the listing description (the site's own keyword filter), e.g. `piscina`, `garagem`, `terraço`. |
| extras | optional | balcony · terrace · garage · lift · basement · garden · separate_kitchen | Required extras (AND): balcony, terrace, garage, lift, basement, garden, separate_kitchen. |
| building_type | optional | block · tenement · house · apartment · infill · ribbon · loft | Building type(s): block, tenement, house, apartment, infill, ribbon, loft. |
| sort = relevance | optional | relevance · newest · price_asc · price_desc · area_asc · area_desc | Result order (the site's own options). |
| page = 1 | optional | 1–100000 | Result page. Past the last page the source would re-serve the last page; the engine returns 0 rows with `page_clamped: true` and `last_page` instead. |
| limit = 36 | optional | 24 · 36 · 48 · 72 | Rows per page requested from the site: 24, 36, 48 or 72 (the site's own options; the actual count varies). |
/imovirtual/v1/listing2 creditsFull imovirtual.com listing by `listing_id` (the ID… token from a search row) or URL: price in EUR, the price as the site prints it, price per m², area, rooms, floor, build year, energy certificate and the other characteristics the advert fills, full description, photos, location with coordinates, dates, market (primary / secondary), and the advertiser (type, contact name, agency name / page / logo, owner address). For a new-development project (empreendimento): price-from per m², area range, number of units and the first page of its units.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| listing_id | optional | — | The ID… token at the end of an imovirtual.com listing URL (`…-ID1jfCX`), returned as `listing_id` in every search row. The numeric `ad_id` does not address a page on the site. Provide listing_id OR url. |
| url | optional | — | An imovirtual.com anúncio / empreendimento URL; alternative to listing_id. |
/imovirtual/v1/locations1 creditImovirtual.com location lookup: type a Portuguese place name and get the site's own location ids with level (district / council / parish) and full name. Feed `location_id` to `search`. Diacritics are optional.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| query | required | — | Place name or its beginning (2+ characters), e.g. `Porto`, `Lisboa`, `Cascais`. The site matches loosely, so check `full_name`. |
curl -X POST https://api.reefapi.com/imovirtual/v1/search \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"transaction":"sell","estate":"flat","location":"lisboa"}'{
"ok": true,
"data": { /* the result */ },
"meta": {
"latency_ms": 240,
"record_count": 12,
"completeness_pct": 100
},
"error": null
}Measured at 60 requests a second across the fleet, with no central bottleneck. Volume pricing is on request, and per-key limits are raised for high-volume accounts.
Tell us a site we do not cover yet and it becomes an engine. A customer asked for bestprice.gr on a Sunday and it was in the catalog the next day.
Median time from a question in the live chat to the first answer, measured across every answered conversation. Setup help included, no support tier to buy.
No per-site plans and no separate subscriptions. One key and one credit pool across the whole catalog, so adding a source costs nothing up front.
Planning something large? Tell us the volume and the sources and we will come back with what it costs and what we would have to build.