Retrieve advert by url
Refetch
Récupérer une advert par URL
Retrouve une annonce à partir de son URL portail, en la collectant à la demande si nécessaire.
Retrieve advert by url
GET /v2/protected/adverts/url?url=… retrouve une annonce à partir de l’URL de sa page sur un portail. Si l’annonce est déjà indexée chez Fluximmo, elle est renvoyée directement. Sinon elle est collectée à la demande, et la requête attend son indexation.
Le paramètre url est obligatoire et doit être une url http(s) valide pointant vers une annonce, par exemple https://www.leboncoin.fr/ad/ventes_immobilieres/3246347062. Le contrat exact est documenté plus bas par le bloc OpenAPI (GET /v2/protected/adverts/url).
1 crédit est facturé uniquement quand un document est renvoyé (
200). Les réponses 202 (indexation en cours) et 422 (rejetée par l’ingestion) ne sont pas facturées.Les trois issues possibles
200— l’annonce est disponible. Le corps est l’objet advert, enveloppé :{ "data": { … } }. 1 crédit.202— collectée, pas encore indexée. Réessayez la même url aprèsretry_after_ssecondes. Ce délai est dans le corps ; il n’y a pas d’en-tête HTTPRetry-After.
422— collectée mais rejetée par l’ingestion (données incohérentes ou manquantes, hors périmètre). Cette annonce ne deviendra jamais disponible : ne réessayez pas.
data (ce sont des issues métier, pas des erreurs) et portent un champ status lisible par une machine, ainsi que website_ref pour corréler un retry ultérieur. Ne traitez pas website_ref comme garanti : il peut valoir null lorsque l’annonce n’a pas de référence canonique.
Cas d’usage
- Import d’une annonce repérée à la main — un utilisateur colle l’url d’une annonce, vous la rapatriez dans votre base.
- Enrichissement d’un lien existant — retrouver le
flx_idFluximmo derrière une url portail déjà stockée chez vous. - Vérification ponctuelle — obtenir la fiche complète (prix, surface, vendeur) d’une annonce vue sur un portail.
Exemples
1 — Récupérer une annonce par son url
Notez le--max-time 60, supérieur aux ~45 s d’attente maximale.
2 — Gérer le 202 en réessayant après retry_after_s
202 et 422 se distinguent par le code HTTP : on réessaie le premier, jamais le second.
Erreurs
Les erreurs, elles, ne sont pas enveloppées dansdata mais dans { "error": { "message", "code" } }.
- 404 — portail non couvert, url invalide, ou url ne désignant pas une annonce unique (page de recherche, url tronquée).
- 422 (validation, code
10002) — paramètreurlabsent, vide ou mal formé. Les trois cas renvoient le même message,"Url query parameter must be a valid http(s) url"; branchez tout de même sur le code10002plutôt que sur le libellé. À ne pas confondre avec le422de rejet d’ingestion ci-dessus, qui est un succès métier enveloppé dansdataet porte unstatus.
Liens utiles
- Récupérer une advert par flxId — une fois le
flx_idconnu, c’est la voie la plus directe. - Property vs Advert — une url portail désigne toujours une advert ; l’équivalent existe sur les properties :
GET /v2/protected/properties/url. - Consommation de crédits · Limites et rate limits
- Bonnes pratiques — timeouts, retries et gestion des statuts métier.
Clé test gratuite — 1 semaine
Créez un compte sur my.fluximmo.io pour récupérer une clé API test gratuite (1 semaine, accès limité). Aucun paiement requis.

