Report an issue on an advert
Signalement & re-check
Signaler un problème sur une advert
Signalement gratuit d’un problème sur une annonce, avec revérification en tâche de fond.
Report an issue on an advert
POST /v2/protected/adverts/{flxId}/report sert à nous dire ce qui ne va pas sur une annonce : prix faux, annonce toujours en ligne alors que nous la disons hors ligne, doublon, mauvaise agence… L’appel est gratuit (0 crédit), répond 200 immédiatement et déclenche une revérification de l’annonce contre son portail en tâche de fond.
Le contrat exact est documenté plus bas par le bloc OpenAPI (POST /v2/protected/adverts/{flxId}/report).
Cas d’usage
- Annonce fantôme côté Fluximmo — vos utilisateurs voient l’annonce sur le portail alors que nous la donnons hors ligne :
STILL_ONLINE. - Annonce déjà retirée — vous constatez une 404 sur le portail alors que nous la donnons en ligne :
NOT_ONLINE_ANYMORE. - Contrôle qualité de vos données — un prix ou une surface incohérente détectée par vos règles métier :
WRONG_DATA. - Dédoublonnage — vous retrouvez le même bien sous un autre
flx_id:DUPLICATE.
Choisir le motif
reason est obligatoire et prend l’une de ces 7 valeurs :
STILL_ONLINE— nous la disons hors ligne, elle est visible sur le portail.NOT_ONLINE_ANYMORE— nous la disons en ligne, elle a disparu du portail.WRONG_DATA— prix, surface ou nombre de pièces faux.WRONG_LOCATION— géolocalisation ou adresse fausse.DUPLICATE— doublon déjà présent sous un autreflx_id.WRONG_AGENCY— pro/particulier ou agence mal attribué.OTHER— autre cas.
comment est optionnel (1000 caractères maximum), mais obligatoire quand reason vaut OTHER. Les espaces de début et de fin sont retirés : un commentaire fait uniquement d’espaces est refusé. Les clés inconnues envoyées dans le corps sont silencieusement ignorées.
Le motif détermine la profondeur de la revérification.
STILL_ONLINE et NOT_ONLINE_ANYMORE portent sur la disponibilité : ils déclenchent un contrôle léger qui met à jour le statut en ligne — le même que /check. Les cinq autres motifs portent sur le contenu de l’annonce : ils déclenchent une réextraction complète, seule capable de corriger un prix, une surface, une adresse ou une agence. Choisir le motif juste n’est donc pas cosmétique.Exemples
1 — Annonce encore en ligne sur le portail
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.
2 — Motif OTHER : le commentaire devient obligatoire
422 — un seul message est renvoyé par appel :
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}}. - 422 (validation, code
10002) — corps invalide, par exemple unreasonhors énumération :"reason must be one of the following values: STILL_ONLINE, NOT_ONLINE_ANYMORE, WRONG_DATA, WRONG_LOCATION, DUPLICATE, WRONG_AGENCY, OTHER". Notez le 422, pas un 400. Un seul message est renvoyé par appel même si plusieurs champs sont invalides : branchez votre logique sur le code, pas sur le libellé. - 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."Le signalement ne peut pas être traité.
Liens utiles
- Récupérer une advert par flxId — relire la donnée rafraîchie quelques minutes plus tard.
- Revérifier une advert — même mécanique de revérification, sans diagnostic et facturée 1 crédit.
- Webhooks — recevoir la mise à jour sans repoller.
- Property vs Advert — l’équivalent existe sur les properties :
POST /v2/protected/properties/{flxId}/report. - Bonnes pratiques
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.
Authorizations
Path Parameters
Body
application/json
What is wrong with this advert or property
Available options:
STILL_ONLINE, NOT_ONLINE_ANYMORE, WRONG_DATA, WRONG_LOCATION, DUPLICATE, WRONG_AGENCY, OTHER Example:
"STILL_ONLINE"
Free-text details. Optional, except when reason is OTHER where it is required.
Maximum string length:
1000Example:
"The ad is still visible on seloger, you flagged it offline."

