Report an issue on a property
Signalement & re-check
Signaler un problème sur une property
Nous remonter une donnée fausse ou un statut erroné et déclencher une revérification gratuite.
Report an issue on a property
À quoi ça sert
POST /v2/protected/properties/{flxId}/report sert à nous dire ce qui ne va pas sur un bien : prix faux, annonce toujours en ligne alors que nous la donnons disparue, doublon, mauvaise agence. L’appel est gratuit (0 crédit), répond 200 immédiatement et lance en tâche de fond une revérification des annonces auprès de leurs portails.
Rappel de vocabulaire : une property est un bien physique dédupliqué qui agrège N adverts, les annonces publiées sur des portails différents (voir Property vs Advert). Ce sont donc les annonces de la property qui repartent en collecte, pas la property elle-même.
Ce qui est réellement revérifié
- Seules les annonces en ligne — celles déjà hors ligne sont ignorées.
- 10 annonces au maximum, les plus récemment vues ; l’excédent est compté dans
skipped_count. - Une annonce sans url source exploitable est également comptée dans
skipped_count. skipped_countpeut aussi être non nul parce que certaines revérifications n’ont pas pu être lancées. Une rafale d’appels rapprochés rend ce cas plus probable. Ce n’est pas une erreur : espacez vos appels et réessayez.- Si aucune annonce en ligne n’est revérifiable, la réponse vaut
status: "nothing_to_check"avectriggered_count: 0, en HTTP 200 — là encore, ce n’est pas une erreur.
triggered liste les flx_id des annonces confiées au scraper, jamais celui de la property.
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 des annonces : 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.Cas d’usage
- Corriger une donnée fausse —
WRONG_DATAlorsque prix, surface ou nombre de pièces ne correspondent pas au portail. - Rétablir un statut —
STILL_ONLINEsi nous disons le bien hors ligne alors qu’il est visible,NOT_ONLINE_ANYMOREdans le cas inverse. - Signaler un doublon —
DUPLICATEquand le même bien existe déjà sous un autre flx_id. - Corriger la localisation ou le vendeur —
WRONG_LOCATIONpour une géoloc ou une adresse fausse,WRONG_AGENCYpour un pro/particulier ou une agence mal attribués. - Tout le reste —
OTHER, qui rend alors le champcommentobligatoire (1000 caractères maximum).
POST /v2/protected/properties/{flxId}/report).
Exemples
1 — Signaler un prix erroné
Réponse 200
message le dit : le suffixe 3 advert(s) skipped. est ajouté au message nominal, et si rien n’a pu partir alors que des annonces étaient éligibles, le message devient No advert queued: 3 advert(s) skipped (per-request cap, missing url, or too many scrapes already running).
2 — Motif libre, sur une property dont les annonces sont toutes hors ligne
curl
200 avec nothing_to_check :
Réponse 200
Erreurs spécifiques
- 404 — le flx_id n’existe pas :
{"error":{"message":"Property with flx_id 123456789 not found","code":10003}}. - 422 — corps invalide (et non 400), code
10002, avec un seul message :"comment is required when reason is OTHER"ou"reason must be one of the following values: STILL_ONLINE, NOT_ONLINE_ANYMORE, WRONG_DATA, WRONG_LOCATION, DUPLICATE, WRONG_AGENCY, OTHER". Un seul message est renvoyé par appel même si plusieurs champs sont invalides : branchez votre logique sur le code, pas sur le libellé. Les espaces de début et de fin du commentaire sont retirés : un commentaire composé uniquement d’espaces est donc refusé. Les clés inconnues envoyées dans le corps sont silencieusement ignorées. La liste complète des codes est sur Codes d’erreur.
Liens utiles
- Concept · Property vs Advert
- Relire la property après signalement
- Revérifier une property — même mécanique, sans diagnostic, facturée 1 crédit.
- Concept · Webhooks
- Ressources · Codes d’erreur
- Ressources · 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."

