> ## Documentation Index
> Fetch the complete documentation index at: https://docs.melo.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Price / Meter Evolution

> This endpoint returns the price per meter `average`, `median` and `time series` of properties matching the given criteria.

### Query parameters

<ParamField query="aggregationInterval" type="string" default="month" placeholder="month, year">
  Date histogram granularity for time series. Can be `month` or `year`.
</ParamField>

<ParamField query="bedroomMax" type="integer">
  The maximum number of bedrooms in the property.
</ParamField>

<ParamField query="bedroomMin" type="integer">
  The minimum number of bedrooms in the property.
</ParamField>

<ParamField query="budgetMax" type="integer">
  The maximum budget for the property.
</ParamField>

<ParamField query="budgetMin" type="integer">
  The minimum budget for the property.
</ParamField>

<ParamField query="condominiumFeesMax" type="integer">
  The maximum condominium fees for the property.
</ParamField>

<ParamField query="condominiumFeesMin" type="integer">
  The minimum condominium fees for the property.
</ParamField>

<ParamField query="constructionYearMax" type="integer">
  The maximum construction year of the property.
</ParamField>

<ParamField query="constructionYearMin" type="integer">
  The minimum construction year of the property.
</ParamField>

<ParamField query="energyCategories" type="array">
  The energy efficiency categories of the property.
</ParamField>

<ParamField query="energyValueMax" type="integer">
  The maximum energy value of the property.
</ParamField>

<ParamField query="energyValueMin" type="integer">
  The minimum energy value of the property.
</ParamField>

<ParamField query="eventPriceVariationFromCreatedAt" type="date">
  The date from which an event of type price is created (inclusive).
</ParamField>

<ParamField query="eventPriceVariationMax" type="number">
  The maximum variation of an event of type price. Expressed in percent.
</ParamField>

<ParamField query="eventPriceVariationMin" type="number">
  The minimum variation of an event of type price. Expressed in percent.
</ParamField>

<ParamField query="eventPriceVariationToCreatedAt" type="date">
  The date before which an event of type price is created (inclusive).
</ParamField>

<ParamField query="eventSurfaceVariationFromCreatedAt" type="date">
  The date from which an event of type surface is created (inclusive).
</ParamField>

<ParamField query="eventSurfaceVariationMax" type="number">
  The maximum variation of an event of type surface. Expressed in percent.
</ParamField>

<ParamField query="eventSurfaceVariationMin" type="number">
  The minimum variation of an event of type surface. Expressed in percent.
</ParamField>

<ParamField query="eventSurfaceVariationToCreatedAt" type="date">
  The date before which an event of type surface is created (inclusive).
</ParamField>

<ParamField query="excludedCities" type="array">
  Cities to be excluded.
</ParamField>

<ParamField query="excludedInseeCodes" type="array">
  Insee codes to be excluded.
</ParamField>

<ParamField query="excludedProperties" type="array">
  Properties to be excluded.
</ParamField>

<ParamField query="excludedZipcodes" type="array">
  Zipcodes to be excluded.
</ParamField>

<ParamField query="expired" type="boolean">
  Filter for expired properties.
</ParamField>

<ParamField query="expressions" type="array">
  Full text matching including/excluding words & phrases in the title or the description of the property.
  Example: `expressions[0][0][word]=travaux&expressions[0][0][options][includes]=true&expressions[0][0][options][strict]=false&expressions[0][1][word]=lumineux&expressions[0][1][options][includes]=true&expressions[0][1][options][strict]=false` which will search for properties that contain both the keywords `lumineux` and `travaux`.
</ParamField>

<ParamField query="feesPercentageMax" type="number">
  The maximum percentage of fees.
</ParamField>

<ParamField query="feesPercentageMin" type="number">
  The minimum percentage of fees.
</ParamField>

<ParamField query="feesResponsibility" type="integer">
  Responsibility for fees (0 for seller, 1 for purchaser).
</ParamField>

<ParamField query="floorQuantityMax" type="integer">
  The maximum number of floors in the property.
</ParamField>

<ParamField query="floorQuantityMin" type="integer">
  The minimum number of floors in the property.
</ParamField>

<ParamField query="fromDate" type="date">
  The date from which the property is created (inclusive).
</ParamField>

<ParamField query="fromUpdatedAt" type="date">
  The date from which the property is updated (inclusive).
</ParamField>

<ParamField query="furnished" type="boolean">
  Filter for furnished properties.
</ParamField>

<ParamField query="greenHouseGasCategories" type="array">
  Green house gas performance letter array of the property.
</ParamField>

<ParamField query="greenHouseGasValueMax" type="integer">
  The maximum value of green house gas of the property.
</ParamField>

<ParamField query="greenHouseGasValueMin" type="integer">
  The minimum value of green house gas of the property.
</ParamField>

<ParamField query="includedCities" type="array">
  Located in given cities. Example: includedCities\[]=/cities/30953\&includedCities\[]=/cities/30952
</ParamField>

<ParamField query="includedDepartments" type="array">
  Located in given departments. Example: includedDepartments\[]=includedDepartments\[]=/departments/77
</ParamField>

<ParamField query="includedInseeCodes" type="array">
  Located in given insee codes. Example: includedInseeCodes\[]=75117\&includedInseeCodes\[]=75118
</ParamField>

<ParamField query="includedZipcodes" type="array">
  Located in given zipcodes. Example: includedZipcodes\[]=75017\&includedZipcodes\[]=75018
</ParamField>

<ParamField query="inventoryPriceMax" type="number">
  Lower than or equal to inventoryPriceMax. Example: inventoryPriceMax=500
</ParamField>

<ParamField query="inventoryPriceMin" type="number">
  Greater than or equal to inventoryPriceMin. Example: inventoryPriceMin=250
</ParamField>

<ParamField query="itemsPerPage" type="integer" default="30">
  The number of items per page. Max is 30.
</ParamField>

<ParamField query="lat" type="number">
  Latitude. Used if radius & lat/lon are set. Example: lat=48.864716
</ParamField>

<ParamField query="lon" type="number">
  Longitude. Used if radius & lat/lon are given. Example: lon=2.349014
</ParamField>

<ParamField query="lotCountMax" type="integer">
  Lower than or equal to lotCountMax. Example: lotCountMax=12
</ParamField>

<ParamField query="lotCountMin" type="integer">
  Greater than or equal to lotCountMin. Example: lotCountMin=4
</ParamField>

<ParamField query="order[createdAt]" type="integer" default="desc">
  Order properties by creation date.
</ParamField>

<ParamField query="order[updatedAt]" type="integer">
  Order properties by update date.
</ParamField>

<ParamField query="page" type="integer" default="1">
  The collection page number.
</ParamField>

<ParamField query="priceExcludingFeesMax" type="number">
  Lower than or equal to priceExcludingFeesMax. Example: priceExcludingFeesMax=427500
</ParamField>

<ParamField query="priceExcludingFeesMin" type="number">
  Greater than or equal to priceExcludingFeesMin. Example: priceExcludingFeesMin=405000
</ParamField>

<ParamField query="pricePerMeterMax" type="integer">
  Lower than or equal to pricePerMeterMax. Example: pricePerMeterMax=11500
</ParamField>

<ParamField query="pricePerMeterMin" type="integer">
  Greater than or equal to pricePerMeterMin. Example: pricePerMeterMin=9500
</ParamField>

<ParamField query="propertyTypes" type="array">
  0: FLAT, 1: HOUSE, 2: BUILDING, 3: PARKING, 4: OFFICE, 5: LAND, 6: SHOP
</ParamField>

<ParamField query="publisherTypes" type="array">
  0 : INDIVIDUAL, 1 : PROFESSIONAL
</ParamField>

<ParamField query="radius" type="integer">
  Distance expressed in kilometers. Used if lat & lon are set. Example: radius=20
</ParamField>

<ParamField query="rentalChargesMax" type="number">
  Lower than or equal to rentalChargesMax. Example: rentalChargesMax=100
</ParamField>

<ParamField query="rentalChargesMin" type="number">
  Greater than or equal to rentalChargesMin. Example: rentalChargesMin=50
</ParamField>

<ParamField query="rentalPledgeMax" type="number">
  Lower than or equal to rentalPledgeMax. Example: rentalPledgeMax=800
</ParamField>

<ParamField query="rentalPledgeMin" type="number">
  Greater than or equal to rentalPledgeMin. Example: rentalPledgeMin=500
</ParamField>

<ParamField query="renterFeesMax" type="number">
  Lower than or equal to renterFeesMax. Example: renterFeesMax=80
</ParamField>

<ParamField query="renterFeesMin" type="number">
  Greater than or equal to renterFeesMin. Example: renterFeesMin=50
</ParamField>

<ParamField query="roomMax" type="integer">
  Having maximum x rooms. Example: roomMax=6
</ParamField>

<ParamField query="roomMin" type="integer">
  Having minimum x rooms. Example: roomMin=3
</ParamField>

<ParamField query="sortMode" type="string" default="property">
  Property: fromDate/toDate criteria will be applied to property root object. Items will be sorted by property createdAt dates. Advert: fromDate/toDate criteria will be applied to adverts nested objects. Items will be sorted by advert createdAt dates. Example: sortMode=property
</ParamField>

<ParamField query="surfaceMax" type="integer">
  Lower than or equal to surfaceMax. Example: surfaceMax=84
</ParamField>

<ParamField query="surfaceMin" type="integer">
  Greater than or equal to surfaceMin. Example: surfaceMin=42
</ParamField>

<ParamField query="toDate" type="date">
  To datetime (inclusive). Example: toDate=2021-05-07 12:42:42
</ParamField>

<ParamField query="toUpdatedAt" type="date">
  Since datetime (inclusive). Example: toUpdatedAt=2021-05-07 12:42:42
</ParamField>

<ParamField query="transactionType" type="integer">
  0 : SELL, 1 : RENT
</ParamField>

<ParamField query="withCoherentPrice" type="boolean" default="true">
  Filter properties with coherent price. Example: withCoherentPrice=true
</ParamField>

<ParamField query="withVirtualTour" type="boolean">
  Having a virtual tour video link. Example: withVirtualTour=true
</ParamField>

<RequestExample>
  ```bash Example Request theme={null}
  curl --location -g --request GET 'https://api.notif.immo/indicators/price_per_meter?includedDepartments[]=departments/77&fromDate=2020-01-10&propertyTypes[]=1&transactionType=0&withCoherentPrice=true&budgetMin=1800000&budgetMax=1900000' \
  --header 'Content-Type: application/json' \
  --header 'X-API-KEY: <api_key>'
  ```
</RequestExample>

<ResponseExample>
  ```json Example Response theme={null}
  {
    "hydra:member": [
      {
      "average": 7532.48,
      "average_min": 6250.75,
      "average_max": 8814.21,
      "median": 7601.50,
      "series": {
          "2023-01": 7450.60,
          "2023-02": 7520.00,
          "2023-03": 7605.30,
          "2023-04": 7680.40,
          "2023-05": 7750.50,
          "2023-06": 7820.60,
          "2023-07": 7890.70,
          "2023-08": 7960.80,
          "2023-09": 8030.90,
          "2023-10": 8101.00,
          "2023-11": 8171.10,
          "2023-12": 8241.20
      }
  }
    ],
    "hydra:totalItems": 0,
    "hydra:view": {
      "@id": "string",
      "@type": "string",
      "hydra:first": "string",
      "hydra:last": "string",
      "hydra:next": "string"
    },
    "hydra:search": {
      "@type": "string",
      "hydra:template": "string",
      "hydra:variableRepresentation": "string",
      "hydra:mapping": [
        {
          "@type": "string",
          "variable": "string",
          "property": "string",
          "required": true
        }
      ]
    }
  }
  ```
</ResponseExample>