Modèle Advert

Une Advert = annonce individuelle sur un portail. 1 URL = 1 Advert. Plusieurs adverts décrivant le même bien physique sont rattachées à une même Property parente après déduplication.

Champs principaux

Schéma OpenAPI complet rendu plus bas par Mintlify (AdvertDto). Tableau ci-dessous : champs métier + champs spécifiques advert.

Champ	Type	Description
`flxId`	`string`	Identifiant unique Fluximmo de l’advert.
`propertyFlxId`	`string`	flxId de la `Property` parente côté Fluximmo (toujours présent en prod). Deux adverts avec le même `propertyFlxId` sont des doublons d’un même bien physique.
`mainPropertyAdFlxId`	`string`	flxId de l’Advert primaire (premier dupliqué détecté) au sein du groupe. À distinguer de `propertyFlxId` qui pointe vers la Property parente. (déprécié — utiliser `propertyFlxId` à la place. Conservé pour rétro-compatibilité.)
`type`	`enum`	Mêmes valeurs que `PropertyDto.type`.
`title`	`string`	Titre de l’annonce tel que sur le portail source.
`description`	`string`	Description telle que sur le portail source.
`source`	`SourceDto`	`{ flxId, url, website }` — `website` = identifiant interne du portail/source (grands réseaux d’agences, mandataires indépendants, agences locales, etc.) + URL canonique.
`seller`	`LightSellerDto`	`{ flxId, name, siren, type }` avec `type` ∈ `SELLER_TYPE_AGENCY`, `SELLER_TYPE_NETWORK`, `SELLER_TYPE_UNKNOWN`.
`contactInCharge`	`ContactDto`	Contact en charge (quand disponible).
`isOnline`	`boolean`	Annonce actuellement en ligne sur le portail.
`isPro`	`boolean`	Vendeur professionnel.
`isExclusive`	`boolean`	Annonce déclarée exclusive par le vendeur.
`isAuction`	`boolean`	Annonce de type enchère.
`isUrgent`	`boolean`	Marquée urgent.
`firstSeenAt`	`Date`	Première fois que Fluximmo a vu cette advert (ISO 8601).
`lastSeenAt`	`Date`	Dernière fois vue.
`lastModifiedAt`	`Date`	Dernière modification détectée (ISO 8601).
`currentPrice`	`AdvertPriceDto`	`{ value, valuePerArea }` — prix courant de l’advert (€).
`currency`	`enum`	`CURRENCY_EUR` ou `CURRENCY_USD`.
`scope`	`enum`	`PRICING_ONE_OFF` ou `PRICING_MENSUAL`.
`charges`	`ChargesDto`	Charges récurrentes, taxes, suppléments de loyer, frais annuels.
`warrantyDeposit`	`number`	Dépôt de garantie (location).
`offer`	`OfferDto`	Voir Property → offer.
`location`	`AdLocationDto`	Voir Property → location (équivalent, sans `region`/`country` natifs — utiliser `department` et `postalCode`).
`habitation`	`TypeHabitationDto`	Idem Property : `{ surface, roomCount, bedroomCount, climate (DPE/GES), characteristics, features, … }`.
`land`	`TypeLandDto`	Détails terrain.
`parking`	`TypeParkingDto`	Détails parking.
`medias`	`MediasDto`	Photos / médias de cette advert.
`tags`	`string[]`	Tags non structurés.
`hasAnomaly`	`boolean`	Incohérence détectée.

Note — pour les structures partagées (OfferDto, TypeHabitationDto, MetaDto-like), voir la page Property. L’Advert n’a pas de bloc meta séparé : firstSeenAt, lastSeenAt, lastModifiedAt, isOnline sont au niveau racine de l’advert.

Events spécifiques aux adverts

L’Advert est l’objet dynamique (ce qui change dans le temps). Les webhooks ALERT_MATCH_ADVERT_EVENT couvrent :

PRICE — toute variation de prix (même 1 €).
REPUBLISHED — passage isOnline: false → true.
UNPUBLISHED — passage isOnline: true → false.

Le check interne CHECK (vérification sans changement détecté) ne déclenche pas de webhook. Détails : Match types & cycle alerte.

JSON exemple

{
  "flxId": "adv_01HXY...",
  "propertyFlxId": "prop_01HXY...",
  "mainPropertyAdFlxId": "adv_01HXY_main",
  "type": "CLASS_FLAT",
  "title": "T3 75m² Bastille - terrasse",
  "source": {
    "website": "<portail-a>",
    "url": "https://<portail-a>.example/annonces/...",
    "flxId": "src_01HXY..."
  },
  "seller": { "name": "Agence Bastille Immo", "type": "SELLER_TYPE_AGENCY", "siren": "812345678" },
  "isOnline": true,
  "isPro": true,
  "isExclusive": false,
  "isAuction": false,
  "currency": "CURRENCY_EUR",
  "scope": "PRICING_ONE_OFF",
  "currentPrice": { "value": 435000, "valuePerArea": 5800 },
  "offer": { "type": "OFFER_BUY", "isCurrentlyOccupied": false },
  "location": {
    "postalCode": "75011", "inseeCode": "75111", "city": "Paris",
    "locationCoordinate": { "lat": 48.857, "lng": 2.376 }
  },
  "habitation": { "surface": { "total": 75 }, "roomCount": 3, "bedroomCount": 2 },
  "firstSeenAt": "2025-04-22T09:11:00.000Z",
  "lastSeenAt":  "2025-04-30T18:42:00.000Z",
  "lastModifiedAt": "2025-04-29T07:00:00.000Z"
}

Échantillon live : GET /v2/sample/adverts — voir Sample data.

Différences clés vs Property

Détails conceptuels : Property vs Advert.

Déduplication côté client (`propertyFlxId`)

Chaque advert porte un propertyFlxId qui pointe vers sa Property parente côté Fluximmo. Deux adverts avec le même propertyFlxId sont des doublons d’un même bien physique. Pour identifier l’advert primaire d’un groupe (le premier dupliqué détecté), utilisez mainPropertyAdFlxId.

// Advert 1 — racine de la chaîne
{ "flxId": "adv_aaa", "propertyFlxId": "prop_xxx", "mainPropertyAdFlxId": "adv_aaa", "source": { "website": "<portail-a>" } }

// Advert 2 — doublon ingéré 12 h plus tard sur un autre portail
{ "flxId": "adv_bbb", "propertyFlxId": "prop_xxx", "mainPropertyAdFlxId": "adv_aaa", "source": { "website": "<portail-b>" } }

Côté DB, vous savez que adv_bbb est doublon de adv_aaa (même propertyFlxId). Un client ADVERTS-only peut ainsi reconstruire sa propre vue agrégée à la Property en groupant par propertyFlxId — sans dépendre de l’API properties côté Fluximmo.

Cas d’usage

Alerte chasseur temps réel. Vous voulez chaque variation de prix, chaque republication d’annonce ? Souscrivez ALERT_MATCH_ADVERT_EVENT — payload complet dans le webhook (pas de refetch nécessaire). Réplication BDD source-par-source. 1 advert = 1 ligne par portail. Idéal pour reconstituer en local le flux brut multi-portail, garder la trace de chaque URL et de qui (quel seller) a publié quoi. Tracking concurrentiel par agence. seller.flxId + source.website permettent de suivre l’inventaire d’une agence donnée sur un portail donné, et de mesurer firstSeenAt → UNPUBLISHED (durée de vie de l’annonce).

Endpoints associés

GET /v2/protected/adverts/{flxId} — fetch direct par flxId.
PUT /v2/protected/adverts/search/alerts — alerte temps réel sur les nouveaux adverts.
Match types & cycle alerte — events PRICE, REPUBLISHED, UNPUBLISHED.

contactInCharge

object

required

Show child attributes

charges

object

Breakdown of recurring property-related charges, taxes, rent supplements, and annual fees associated with the asset.

Show child attributes

currency

enum<string>

Currency of the advert

Available options:

CURRENCY_EUR,

CURRENCY_USD

Example:

null

currentPrice

object

Current price of the advert

Show child attributes

description

string

Description of the advert as it is on the source

firstSeenAt

string<date-time>

Date should be in ISO format (ex: 2022-10-21T11:31:33.593Z)

Example:

"2022-10-21T11:31:33.593Z"

flxId

string

Unique identifier of the advert

habitation

object

Habitation details of the property

Show child attributes

hasAnomaly

boolean

An anomaly or incoherence have been detected

isAuction

boolean

Is this advert an auction

isUrgent

boolean

Is this advert marked as urgent

land

object

Land details of the property

Show child attributes

lastModifiedAt

string<date-time>

Date should be in ISO format (ex: 2022-10-21T11:31:33.593Z)

Example:

"2022-10-21T11:31:33.593Z"

location

object

Location details of the advert

Show child attributes

medias

object

Medias of the advert

Show child attributes

parking

object

Parking details of the property

Show child attributes

scope

enum<string>

Pricing scope of the advert - mensual or onetime

Available options:

PRICING_ONE_OFF,

PRICING_MENSUAL

Example:

null

source

object

Source of the advert

Show child attributes

Modèles

Properties

Adverts

Système

Agences immobilières

Champs principaux

Events spécifiques aux adverts

JSON exemple

Différences clés vs Property

Déduplication côté client (`propertyFlxId`)

Cas d’usage

Endpoints associés

Modèles

Properties

Adverts

Système

Agences immobilières

Documentation Index

​Champs principaux

​Events spécifiques aux adverts

​JSON exemple

​Différences clés vs Property

​Déduplication côté client (propertyFlxId)

​Cas d’usage

​Endpoints associés

Champs principaux

Events spécifiques aux adverts

JSON exemple

Différences clés vs Property

Déduplication côté client (`propertyFlxId`)

Cas d’usage

Endpoints associés