Skip to main content
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.
La donnée rafraîchie n’est pas dans la réponse. Relisez la property quelques minutes plus tard avec GET /v2/protected/properties/{flxId}, ou recevez-la sur votre webhook d’alerte si vous y êtes abonné.

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_count peut 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" avec triggered_count: 0, en HTTP 200 — là encore, ce n’est pas une erreur.
Le tableau 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 fausseWRONG_DATA lorsque prix, surface ou nombre de pièces ne correspondent pas au portail.
  • Rétablir un statutSTILL_ONLINE si nous disons le bien hors ligne alors qu’il est visible, NOT_ONLINE_ANYMORE dans le cas inverse.
  • Signaler un doublonDUPLICATE quand le même bien existe déjà sous un autre flx_id.
  • Corriger la localisation ou le vendeurWRONG_LOCATION pour une géoloc ou une adresse fausse, WRONG_AGENCY pour un pro/particulier ou une agence mal attribués.
  • Tout le resteOTHER, qui rend alors le champ comment obligatoire (1000 caractères maximum).
Le contrat exact est documenté plus bas par le bloc OpenAPI (POST /v2/protected/properties/{flxId}/report).

Exemples

1 — Signaler un prix erroné

Deux annonces en ligne sont reparties en collecte, aucune n’a été écartée :
Réponse 200
Quand des annonces sont écartées, 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
Le signalement est bien enregistré, mais il n’y avait rien à revérifier — d’où le 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.
Il n’y a aucun cooldown : chaque appel relance des vérifications. Signalez sans hésiter, c’est gratuit et cela améliore la base pour tout le monde. L’équivalent existe sur les annonces : POST /v2/protected/adverts/{flxId}/report.

Liens utiles

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

x-api-key
string
header
required

Path Parameters

flxId
string
required

Body

application/json
reason
enum<string>
required

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"

comment
string

Free-text details. Optional, except when reason is OTHER where it is required.

Maximum string length: 1000
Example:

"The ad is still visible on seloger, you flagged it offline."

Response

data
object