API d’Andorra Listings

Autenticació

Crea una clau al teu tauler de l’API i envia-la com a bearer token. Les claus comencen al pla gratuït; el tauler mostra el pla, la quota i les peticions per dia i endpoint de cada clau.

curl -H "Authorization: Bearer al_live_…" \
  "https://api.andorralistings.com/v1/properties?op=rent&parish=escaldes_engordany&limit=5"

Endpoints

• GET /v1/properties — search. op (sale, rent, seasonal_rent), type, parish, town, minPrice, maxPrice, minRooms, minSurface, maxAge, minAge, priceChange, nearBus, nearShop, bbox, sort, limit, cursor. Without type you get homes; land, parking and premises only when asked for.
• GET /v1/properties/{id} — one property with every source advert: outbound URL, agency, reference, description, photos. Price history per advert on the Pro plan.
• GET /v1/changes?since= — properties created, updated or delisted since a moment, for keeping a copy in sync. Starter plan and up.
• GET /v1/stats?op= — active homes per parish and type with median and mean price, price per m² and size. Pro plan and up.
• GET /v1/parishes, GET /v1/towns — reference data with centroids.

{
  "data": [{
    "id": "4f1c…", "url": "https://andorralistings.com/en/property/4f1c…",
    "title": "Pis en venda a Escaldes-Engordany", "operation": "sale", "type": "flat",
    "parish": "escaldes_engordany", "town": "Escaldes-Engordany",
    "price": { "min": 636000, "max": 636000, "currency": "EUR", "period": null },
    "surface_m2": 110, "rooms": 3, "bathrooms": 2, "features": ["elevator", "terrace"],
    "location": { "lat": 42.5099, "lng": 1.5358, "precision": "street" },
    "status": "active", "source_count": 3, "first_seen_at": "2026-09-04T08:37:12Z", …
  }],
  "meta": { "total": 812, "limit": 25, "sort": "newest", "next_cursor": "MjAyNi0…" }
}

Plans i límits

Cada resposta porta capçaleres X-RateLimit-* i X-Quota-*. Els preus, l’excés i com demanar-ne més són a la pàgina de preus.