Skip to main content
GET
/
v2
/
protected
/
adverts
/
search
/
alerts
/
history
/
{flxId}
Get history of match adverts by its saved search flxId
curl --request GET \
  --url https://api.fluximmo.io/v2/protected/adverts/search/alerts/history/{flxId} \
  --header 'x-api-key: <api-key>'
{
  "data": [
    {
      "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
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://doc.fluximmo.io/llms.txt

Use this file to discover all available pages before exploring further.

GET /v2/protected/adverts/search/alerts/history/{flxId} renvoie l’historique des adverts qui ont matché l’alerte identifiée par flxId. Utile pour rejouer un backlog après une panne de votre webhook receiver, ou pour auditer la vie d’une alerte.
Pagination offset (skip / take) — incohérence assumée vs la pagination cursor (searchAfterHash) du search. Cette API a une histoire plus ancienne ; l’unification est sur la roadmap.

Cas d’usage

  • Recover after webhook outage — votre receiver a été down 4h ? Rejouez les matches manqués via cet endpoint plutôt qu’attendre les retries.
  • Audit produit — combien de matches une alerte a-t-elle généré sur les 30 derniers jours ? Combien d’events PRICE ?
  • Migration — exporter l’historique d’une alerte avant un grand changement de config.

Authorizations

x-api-key
string
header
required

Path Parameters

flxId
string
required

The flxId of the saved search

Query Parameters

skip
number

Skip the first N results

take
number

Take the first N results

Response

data
object[]