Imovirtual listing
One Imovirtual listing: title, description, status, category, transaction, new or resale, price, currency, price per m², area, rooms, every characteristic the advert gives, attributes and features, dates, reference, exclusive flag, location with coordinates, street and place names, photos, floor plans, video and 3D tour links, the development, the agency (name, type, page, logo, phones, address) and the agency contact (a private owner's name and phone are left out), plus the advertiser's other listings. Give an imovirtual.com/pt/anuncio/ link as url, its slug as id, or latest=true with the search params to open the first current result.
Every response includes credits_used: the credits this call cost.
Parameters
| name | type | description |
|---|---|---|
url | string | An imovirtual.com/pt/anuncio/<slug>-ID... link. |
id | string | The listing slug ending in -ID... |
latest | boolean | true: run the search with the other params and open its first current result. Example: true |
location | string | With latest=true: the search place. Example: lisboa |
transaction | sale | rent | With latest=true: buy or rent. |
estate | flat | house | room | plot | commercial | warehouse | garage | development | With latest=true: property type. |
Every endpoint also takes fresh, raw, fields (see lean responses and caching).
Example
curl "https://api.api.sh/imovirtual/v1/listing" \
-H "x-api-key: $APISH_KEY" import os, requests
res = requests.get(
"https://api.api.sh/imovirtual/v1/listing",
params={},
headers={"x-api-key": os.environ["APISH_KEY"]},
timeout=120,
)
res.raise_for_status()
data = res.json() const url = new URL("https://api.api.sh/imovirtual/v1/listing");
const res = await fetch(url, { headers: { "x-api-key": process.env.APISH_KEY } });
if (!res.ok) throw new Error(`${res.status} ${await res.text()}`);
const data = await res.json(); Response
A JSON object with the fields described above, plus raw (the source's own data), cached, fetched_at and credits_used. Errors return {"success": false, "error": "…"} with the HTTP status (see errors). A lookup that ran but found nothing (404) costs the price above; refused calls and errors on our side are free (what's charged).