API Andorra Listings

Authentification

Créez une clé sur votre tableau de bord de l’API et envoyez-la comme bearer token. Les clés commencent sur le plan gratuit ; le tableau de bord montre le plan, le quota et les requêtes par jour et par endpoint de chaque clé.

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 et limites

Chaque réponse porte des en-têtes X-RateLimit-* et X-Quota-*. Les prix, le dépassement et la façon d’en demander plus sont sur la page des tarifs.