{
"contactInCharge": {
"email": "<string>",
"firstName": "<string>",
"lastName": "<string>",
"phoneNumber": "<string>",
"pseudonym": "<string>"
},
"charges": {
"yearlyCondoniumFees": 123,
"yearlyElectricityFees": 123,
"yearlyHeatingFees": 123,
"yearlyHousingTax": 123,
"yearlyLivingTax": 123,
"yearlyRentalFees": 123,
"monthlyRentSupplement": 123
},
"currency": null,
"currentPrice": {
"value": 123,
"valuePerArea": 123
},
"description": "<string>",
"firstSeenAt": "2022-10-21T11:31:33.593Z",
"flxId": "<string>",
"habitation": {
"bathroomCount": 123,
"bedroomCount": 123,
"characteristics": {
"hasAlarm": true,
"hasBalcony": true,
"hasCellar": true,
"hasConcierge": true,
"hasDigicode": true,
"hasFireplace": true,
"hasGarage": true,
"hasGarden": true,
"hasGrenier": true,
"hasInterphone": true,
"hasJacuzzi": true,
"hasLand": true,
"hasLift": true,
"hasMezzanine": true,
"hasParking": true,
"hasPool": true,
"hasTerrace": true,
"hasVisAVis": true,
"isPeaceful": true
},
"climate": {
"epcClimate": "GREENHOUSE_CLASSIFICATION_C",
"epcClimateScore": 123,
"epcEnergy": "ENERGY_CLASSIFICATION_C",
"epcEnergyScore": 123,
"epcClimateDate": "2022-10-21T11:31:33.593Z",
"epcEnergyDate": "2022-10-21T11:31:33.593Z"
},
"features": {
"exposure": null,
"furniture": null,
"propertyFloor": 123,
"propertyTotalFloor": 123,
"viewTypes": [],
"constructionMaterials": [],
"hasThroughExposure": true,
"viewOns": []
},
"heatTypes": [],
"heatTypeDetails": [],
"heatings": [],
"propertyCondition": {
"constructionYear": 123,
"interiorCondition": null,
"renovationYear": 123,
"generalConditions": []
},
"roomCount": 123,
"surface": {
"balconies": 123,
"floorSpace": 123,
"gardens": 123,
"groundFloor": 123,
"kitchen": 123,
"livingSpace": 123,
"livingRoom": 123,
"terraces": 123,
"total": 123
},
"type": [],
"wcCount": 123
},
"hasAnomaly": true,
"isAuction": true,
"isUrgent": true,
"land": {
"canConstruct": true,
"hasBuildingPermit": true,
"hasElectricity": true,
"hasTelecom": true,
"hasWater": true,
"isServiced": true,
"surface": 123,
"surfaceConstructable": 123,
"type": null
},
"lastModifiedAt": "2022-10-21T11:31:33.593Z",
"location": {
"city": "<string>",
"cityCoordinate": {
"location": [
123
],
"isExactLocation": true
},
"department": "<string>",
"inseeCode": "<string>",
"irisCode": "<string>",
"locationCoordinate": {
"location": [
123
],
"isExactLocation": true
},
"postalCode": "<string>"
},
"medias": {
"images": [
{
"gaussianHash": "<string>",
"imageId": "<string>",
"meanHash": "<string>",
"perceptualHash": "<string>",
"colorHash": "<string>",
"differenceHash": "<string>",
"url": "<string>"
}
],
"virtualVisitExternalUrl": [
"<string>"
]
},
"parking": {
"count": 123,
"numberOfCars": 123,
"surface": 123,
"type": null
},
"scope": null,
"source": {
"flxId": "<string>",
"url": "<string>",
"website": "<string>"
},
"tags": [
"<string>"
],
"title": "<string>",
"type": "CLASS_HOUSE",
"warrantyDeposit": 123,
"offer": {
"isCurrentlyOccupied": true,
"renting": {
"isColocation": true,
"isLongTerm": true,
"isShortTerm": true,
"isSubLease": true
},
"type": "OFFER_BUY"
},
"mainPropertyAdFlxId": "<string>",
"propertyFlxId": "<string>",
"isOnline": true,
"lastSeenAt": "2023-11-07T05:31:56Z",
"isPro": true,
"seller": {
"flxId": "<string>",
"name": "<string>",
"siren": "<string>",
"type": "SELLER_TYPE_AGENCY"
},
"isExclusive": true
}Modèles
Modèle Advert
Schéma complet d’une advert — annonce individuelle sur un portail (1 URL = 1 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
Échantillon live : Déduplication côté client (
Chaque advert porte un
Côté DB, vous savez que
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 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 blocmetaséparé :firstSeenAt,lastSeenAt,lastModifiedAt,isOnlinesont au niveau racine de l’advert.
Events spécifiques aux adverts
L’Advert est l’objet dynamique (ce qui change dans le temps). Les webhooksALERT_MATCH_ADVERT_EVENT couvrent :
PRICE— toute variation de prix (même 1 €).REPUBLISHED— passageisOnline: false→true.UNPUBLISHED— passageisOnline: true→false.
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"
}
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>" } }
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 ? SouscrivezALERT_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.
Was this page helpful?

