Request an on-demand check of an advert
Signalement & re-check
Demander la revérification d'une advert
Contrôle à la demande de la disponibilité d’une annonce sur son portail, facturé 1 crédit.
Request an on-demand check of an advert
POST /v2/protected/adverts/{flxId}/check répond à une seule question : cette annonce est-elle toujours en ligne sur son portail ? L’appel n’a aucun corps de requête ni paramètre de requête : seul le flxId du chemin est nécessaire. Il répond 200 immédiatement, le contrôle est lancé en tâche de fond.
Le contrat exact est documenté plus bas par le bloc OpenAPI (POST /v2/protected/adverts/{flxId}/check).
Le résultat n’est pas dans la réponse. Relisez l’annonce quelques minutes plus tard avec
GET /v2/protected/adverts/{flxId}, ou recevez-la sur votre webhook d’alerte. L’annonce est contrôlée même si Fluximmo la croit hors ligne — c’est justement le cas qui permet de la faire repasser en ligne./check ou /report ?
/check— « est-elle toujours en ligne ? » : vous n’avez pas de diagnostic, vous voulez confirmer la disponibilité. Payant (1 crédit), sans corps de requête./report— nous dire ce qui ne va pas : vous avez un diagnostic (STILL_ONLINE,WRONG_DATA,DUPLICATE…). Gratuit, avec motif obligatoire. Et le motif détermine la profondeur : un problème de disponibilité déclenche le même contrôle léger que/check, tandis qu’un problème de donnée déclenche une réextraction complète de l’annonce.
Cas d’usage
- Avant d’afficher une fiche — confirmer qu’une annonce vue il y a plusieurs jours est toujours publiée avant de la présenter à un utilisateur final.
- Confirmation de disponibilité — vérifier qu’une annonce est toujours publiée avant de déclencher une prise de contact.
- Rattrapage ciblé — revérifier un petit lot d’annonces sensibles sans attendre le cycle de collecte automatique.
Exemples
1 — Demander la revérification
200 :
status vaut accepted ou nothing_to_check. triggered liste les flx_id confiés au scraper. Sur une annonce, skipped_count ne peut valoir que 0 ou 1 : il passe à 1 lorsque la revérification n’a pas pu être lancée, et status vaut alors nothing_to_check. Une rafale d’appels rapprochés rend ce cas plus probable — espacez-les et réessayez. Le plafond de 10 annonces et le cas « url source absente » ne concernent que les properties. Le crédit est débité dans les deux cas, puisque la réponse est un 2xx.
2 — Revérifier, puis relire la donnée
Le200 ne contient pas l’annonce : il faut la relire quelques minutes plus tard.
Erreurs spécifiques
Les réponses en succès sont enveloppées dans{ "data": … }, les erreurs dans { "error": { "message", "code" } }.
- 404 —
flx_idinconnu :{"error":{"message":"Advert with flx_id 123456789 not found","code":10003}}. Aucun crédit débité. - 422 (code
10003) — l’annonce n’a pas d’url source exploitable :"Advert with flx_id 123456789 has no source url: it cannot be re-checked."Il n’y a pas d’erreur de validation de corps sur cette route, puisqu’elle n’en prend pas.
Liens utiles
- Récupérer une advert par flxId — relire l’annonce et son statut après le contrôle.
- Signaler un problème sur une advert — gratuit, avec un motif, et seul moyen de faire corriger une donnée fausse.
- Consommation de crédits — suivre ce que coûtent vos revérifications.
- Créer une alerte adverts — recevoir les mises à jour sans repoller.
- Limites et rate limits · Bonnes pratiques
- Property vs Advert — l’équivalent existe sur les properties :
POST /v2/protected/properties/{flxId}/check.
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.

