Référence · Annonces
Chronologie des modifications d’une annonce
GET/v1/listings/{id}/historyDroit listings:read
Changements de prix, de lien, de titre, retraits et remises en ligne, nouvelles plateformes ; séries de prix par plateforme.
Paramètres
| Paramètre | Type | Description |
|---|---|---|
| iddans le chemin · requis | uuid | Identifiant du bien (id d’une annonce). |
Réponse 200
| Champ | Type | Description |
|---|---|---|
| id | uuid | Identifiant du bien. |
| on_sale_sincepeut être null | date-heure (ISO 8601) | Mise en vente déclarée par les plateformes. |
| events | tableau de objet | Modifications, de la plus ancienne à la plus récente. |
| ↳ at | date-heure (ISO 8601) | Date de la modification. |
| ↳ kind | price | price_removed | url_replaced | url_removed | merged | title | description | photo | bump | delisted | relisted | new_portal | Nature : prix, lien remplacé ou retiré, titre, description, photos, remontée, retrait, remise en ligne, nouvelle plateforme… |
| ↳ sourcepeut être null | objet | Plateforme concernée, si connue. |
| ↳ id | chaîne | Identifiant normalisé de la plateforme (seloger, leboncoin… ; autre si inconnue). |
| ↳ name | chaîne | Nom lisible de la plateforme. |
| ↳ old_pricepeut être null | entier | Prix avant (changement de prix). |
| ↳ new_pricepeut être null | entier | Prix après (changement de prix). |
| ↳ old_urlpeut être null | chaîne | Lien avant (changement de lien). |
| ↳ new_urlpeut être null | chaîne | Lien après (changement de lien, nouvelle plateforme). |
| price_series | tableau de objet | Séries de prix par plateforme. |
| ↳ source | objet | |
| ↳ id | chaîne | Identifiant normalisé de la plateforme (seloger, leboncoin… ; autre si inconnue). |
| ↳ name | chaîne | Nom lisible de la plateforme. |
| ↳ points | tableau de objet | |
| ↳ at | date-heure (ISO 8601) | |
| ↳ price | entier |
Erreurs
400 · Requête invalide401 · Clé absente ou invalide403 · Droit manquant ou accès coupé404 · Introuvable429 · Limite atteinte503 · Requête trop longue
Toutes les erreurs ont la forme { "error": { "code", "message", "request_id" } } : voir Erreurs.