{
"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.
Show child attributes
Show child attributes
Breakdown of recurring property-related charges, taxes, rent supplements, and annual fees associated with the asset.
Show child attributes
Show child attributes
Currency of the advert
Available options:
CURRENCY_EUR, CURRENCY_USD Example:
null
Current price of the advert
Show child attributes
Show child attributes
Description of the advert as it is on the source
Date should be in ISO format (ex: 2022-10-21T11:31:33.593Z)
Example:
"2022-10-21T11:31:33.593Z"
Unique identifier of the advert
Habitation details of the property
Show child attributes
Show child attributes
An anomaly or incoherence have been detected
Is this advert an auction
Is this advert marked as urgent
Land details of the property
Show child attributes
Show child attributes
Date should be in ISO format (ex: 2022-10-21T11:31:33.593Z)
Example:
"2022-10-21T11:31:33.593Z"
Location details of the advert
Show child attributes
Show child attributes
Medias of the advert
Show child attributes
Show child attributes
Parking details of the property
Show child attributes
Show child attributes
Pricing scope of the advert - mensual or onetime
Available options:
PRICING_ONE_OFF, PRICING_MENSUAL Example:
null
Source of the advert
Show child attributes
Show child attributes
Unstructured tags of the advert
Title of the advert as it is on the source
Type of the advert
Available options:
CLASS_UNKNOWN, CLASS_HOUSE, CLASS_FLAT, CLASS_PROGRAM, CLASS_SHOP, CLASS_PREMISES, CLASS_OFFICE, CLASS_LAND, CLASS_BUILDING, CLASS_PARKING, CLASS_ROOM, CLASS_OTHER Example:
"CLASS_HOUSE"
Warranty deposit for renting this property
Offer details of the advert
Show child attributes
Show child attributes
FlxId of the first duplicated advert we found for this advertised property
FlxId of the property this advert is linked to
Is the advert online or not
Last time we saw this advert
Is the seller a professional or not
Seller details of the advert
Show child attributes
Show child attributes
Is the advert exclusive to the seller
Was this page helpful?