Skip to main content
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).
La donnée rafraîchie 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 si vous êtes abonné à une alerte qui la couvre.
L’annonce est revérifiée même si Fluximmo la croit hors ligne — c’est exactement le cas STILL_ONLINE. Il n’y a aucun cooldown : chaque appel relance une vérification, sauf si le plafond de collectes simultanées est déjà atteint (voir skipped_count).

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 autre flx_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

Réponse 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

Réponse 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" } }.
  • 404flx_id inconnu : {"error":{"message":"Advert with flx_id 123456789 not found","code":10003}}.
  • 422 (validation, code 10002) — corps invalide, par exemple un reason hors é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é.
Détail des codes : Codes d’erreur.

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