Aller au contenu principal

Quel est le coût de l'usage du SKU : Indicateur bien (PROPERTY_ANALYTIC) ?

Kim Yiv
  • Mise à jour
Solution API

Tarification

Offre Starter Essentiel Avancée Business
Min. Facturation 200€/mois 500€/mois 1000€/mois 2500€/mois
Endpoints Coût / SKU Coût / SKU Coût / SKU Coût / SKU
PROPERTY_ANALYTIC 0,02100€ 0,01050€ 0,00880€ 0,00780€

 

Endpoints

Endpoint : /properties/count

  • Requête
GET https://api.yanport.com/properties/count?marketingTypes=SALE&propertyTypes=LAND&cityIds=53284461&surfaceMin=800
  •  Réponse
{
  "count": 67
}
  • Consommation: 1 SKU
Offre Starter Essentiel Avancée Business
Endpoints 1 SKU 1 SKU 1 SKU 1 SKU
PROPERTY_ANALYTIC 0,02100€ 0,01050€ 0,00880€ 0,00780€

Le nombre de SKU est égal au nombre de requête HTTP. 

 

Endpoint : /properties/count/group-by-{groupBy}

  • Requête
GET https://api.yanport.com/properties/count/group-by-property-type?source=DVF&marketingTypes=SALE&propertyTypes=HOUSE&cityIds=48671445&propertyTypes=APARTMENT
  •  Réponse
{
  "HOUSE": {
    "count": 1371
  }
  "APARTMENT": {
    "count": 1509
  }
}
  • Consommation: 2 SKU 
Offre Starter Essentiel Avancée Business
Endpoints 2 SKU 2 SKU 2 SKU 2 SKU
PROPERTY_ANALYTIC 0,04200€ 0,02100€ 0,01760€ 0,01560€

Le nombre de SKU est égal au nombre de regroupement (propriétés count) dans la réponse HTTP. 

 

Endpoint : /properties/count/group-by-{groupBy}-and-{subGroupBy}

  • Requête
GET https://api.yanport.com/properties/count/group-by-property-type-and-room-count?source=DVF&marketingTypes=SALE&propertyTypes=APARTMENT&cityIds=48671445
  •  Réponse
{
  "APARTMENT": {
    "1": {
      "count": 862
    },
    "2": {
      "count": 687
    },
    "3": {
      "count": 607
    },
    "4": {
      "count": 410
    },
    "5": {
      "count": 135
    },
    "6": {
      "count": 5
    }
  },
  "HOUSE": {
    "1": {
      "count": 546
    },
    "2": {
      "count": 154
    },
    "3": {
      "count": 78
    },
    "4": {
      "count": 5
    }
  }
}
  • Consommation: 10 SKU
Offre Starter Essentiel Avancée Business
Endpoints 10 SKU 10 SKU 10 SKU 10 SKU
PROPERTY_ANALYTIC 0,21000€ 0,10500€ 0,08800€ 0,07800€

Le nombre de SKU est égal au nombre de sous-regroupement (propriétés count) renvoyé dans la réponse HTTP. 

 

Endpoint : /properties/count/ranges-by-{field}

  • Requête
GET https://api.yanport.com/properties/count/ranges-by-surface?active=true&source=AD&zipCodes=92300&intervals=*:60&intervals=60:*
  •  Réponse
{
  "ranges": [
    {
      "range": {
        "upperEndpoint": 60.0,
        "upperBoundType": "OPEN"
      },
      "count": {
        "count": 892
      }
    },
    {
      "range": {
        "lowerEndpoint": 60.0,
        "lowerBoundType": "CLOSED"
      },
      "count": {
        "count": 1346
      }
    }
  ]
}
  • Consommation: 2 SKU 
Offre Starter Essentiel Avancée Business
Endpoints 2 SKU 2 SKU 2 SKU 2 SKU
PROPERTY_ANALYTIC 0,04200€ 0,02100€ 0,01760€ 0,01560€

Le nombre de SKU est égal au nombre d'intervalles obtenues dans la réponse HTTP. 

 

Endpoint : /properties/distribution

  • Requête
GET https://api.yanport.com/properties/distribution?field=PRICE_M2&intervalField=ROOM_COUNT&interval=1&percentiles=25&percentiles=50&percentiles=75&zipCodes=92300&marketingTypes=SALE&roomCounts=1&roomCounts=2&roomCounts=3
  •  Réponse
{
  "points": [
    {
      "x": "1.0",
      "y": {
        "count": 2173,
        "values": {
          "75.0": 9898.930000000002,
          "25.0": 7942.8943891402705,
          "50.0": 8855.451650537634
        }
      }
    },
    {
      "x": "2.0",
      "y": {
        "count": 5291,
        "values": {
          "75.0": 9386.884932126697,
          "25.0": 7627.505633928572,
          "50.0": 8481.995576161247
        }
      }
    },
    {
      "x": "3.0",
      "y": {
        "count": 4438,
        "values": {
          "75.0": 9713.579792145594,
          "25.0": 7936.20127218935,
          "50.0": 8770.988205128204
        }
      }
    }
  ],
  "type": "PERCENTILES"
}
  • Consommation: 12 SKU
Offre Starter Essentiel Avancée Business
Endpoints 12 SKU 12 SKU 12 SKU 12 SKU
PROPERTY_ANALYTIC 0,25200€ 0,12600€ 0,10560€ 0,09360€

Le nombre de SKU est égal au nombre de percentiles (q25, q50, q75) + 1, multiplié par le nombre de point de la distribution.

 

Endpoint : /properties/evolution

  • Requête
GET https://api.yanport.com/properties/evolution?field=PRICE_M2&intervalField=DELETE_DATE&interval=1&percentiles=25&percentiles=50&percentiles=75&zipCodes=92300&marketingTypes=SALE&roomCounts=1&roomCounts=2&roomCounts=3&deleteDateMin=2020-01-01T00:00
  •  Réponse
{
  "points": [
    {
      "x": "2020-01-01",
      "y": {
        "count": 138,
        "values": {
          "75.0": 10884.7725,
          "25.0": 8895.0825,
          "50.0": 9978.095000000001
        }
      }
    },
    {
      "x": "2020-02-01",
      "y": {
        "count": 125,
        "values": {
          "75.0": 10987.805,
          "25.0": 9222.66,
          "50.0": 10298.97
        }
      }
    },
    {
      "x": "2020-03-01",
      "y": {
        "count": 3,
        "values": {
          "75.0": 11176.439999999999,
          "25.0": 9812.035,
          "50.0": 9980.0
        }
      }
    }
  ],
  "type": "PERCENTILES"
}
  • Consommation: 12 SKU
Offre Starter Essentiel Avancée Business
Endpoints 12 SKU 12 SKU 12 SKU 12 SKU
PROPERTY_ANALYTIC 0,25200€ 0,12600€ 0,10560€ 0,09360€

Le nombre de SKU est égal au nombre de percentiles (q25, q50, q75) + 1, multiplié par le nombre de points de l'histogramme.

 

Endpoint : /properties/evolution/stock

  • Requête
GET https://api.yanport.com/properties/evolution/stock?intervalUnit=MONTHS&zipCodes=92300&marketingTypes=SALE&dateMin=2020-01-01&dateMax=2020-03-01
  •  Réponse
{
  "in": {
    "points": [
      {
        "x": "2020-01-01",
        "y": {
          "count": 209,
          "values": {}
        }
      },
      {
        "x": "2020-02-01",
        "y": {
          "count": 224,
          "values": {}
        }
      }
    ],
    "type": "PERCENTILES"
  },
  "out": {
    "points": [
      {
        "x": "2020-01-01",
        "y": {
          "count": 306,
          "values": {}
        }
      },
      {
        "x": "2020-02-01",
        "y": {
          "count": 244,
          "values": {}
        }
      }
    ],
    "type": "PERCENTILES"
  },
  "global": {
    "points": [
      {
        "x": "2020-01-01",
        "y": {
          "count": 253,
          "values": {}
        }
      },
      {
        "x": "2020-02-01",
        "y": {
          "count": 233,
          "values": {}
        }
      }
    ],
    "type": "PERCENTILES"
  }
}
  • Consommation: 6 SKU 
Offre Starter Essentiel Avancée Business
Endpoints 6 SKU 6 SKU 6 SKU 6 SKU
PROPERTY_ANALYTIC 0,12600€ 0,06300€ 0,05280€ 0,04680€

Le nombre de SKU est égal au nombre total de points renvoyés dans la réponse HTTP.

 

Endpoint : /properties/percentiles

  • Requête
GET https://api.yanport.com/properties/percentiles?field=PRICE_M2&percentiles=50&percentiles=25&percentiles=75&marketingTypes=SALE&zipCodes=92300
  •  Réponse
{
  "count": 18149,
  "values": {
    "75.0": 9753.574377229656,
    "25.0": 7701.700425603809,
    "50.0": 8683.381504818384
  }
}
  • Consommation: 4 SKU
Offre Starter Essentiel Avancée Business
Endpoints 4 SKU 4 SKU 4 SKU 4 SKU
PROPERTY_ANALYTIC 0,08400€ 0,04200€ 0,03520€ 0,03120€

Le nombre de SKU est égal au nombre de percentiles demandés (q25, q50, q75) +1 (propriété count).

 

Endpoint : /properties/percentiles/group-by-{groupBy}

  • Requête
GET https://api.yanport.com/properties/percentiles/group-by-property-type?field=PRICE_M2&percentiles=50&marketingTypes=SALE&zipCodes=92300
  •  Réponse
{
  "BUILDING": {
    "count": 33,
    "values": {
      "50.0": 8309.04
    }
  },
  "APARTMENT": {
    "count": 16538,
    "values": {
      "50.0": 8780.869397480476
    }
  },
  "PREMISES": {
    "count": 815,
    "values": {
      "50.0": 3061.004
    }
  },
  "LAND": {
    "count": 3,
    "values": {
      "50.0": 89.66
    }
  },
  "HOUSE": {
    "count": 386,
    "values": {
      "50.0": 8252.48
    }
  },
  "PARKING": {
    "count": 374,
    "values": {
      "50.0": 2000.0
    }
  }
}
  • Consommation: 12 SKU
Offre Starter Essentiel Avancée Business
Endpoints 12 SKU 12 SKU 12 SKU 12 SKU
PROPERTY_ANALYTIC 0,25200€ 0,12600€ 0,10560€ 0,09360€

Le nombre de SKU est égal au nombre de percentiles (q50) + 1, multiplié par le nombre de regroupement renvoyés dans la réponse HTTP.

 

Endpoint : /properties/percentiles/group-by-{groupBy}-and-{subGroupBy}

  • Requête
GET https://api.yanport.com/properties/percentiles/group-by-property-type-and-room-count?field=PRICE_M2&percentiles=50&marketingTypes=SALE&zipCodes=34000&roomCounts=1&roomCounts=2&roomCounts=3&propertyTypes=APARTMENT&propertyTypes=HOUSE
  •  Réponse
{
  "APARTMENT": {
    "1": {
      "count": 10364,
      "values": {
        "50.0": 3864.9744653679654
      }
    },
    "2": {
      "count": 26784,
      "values": {
        "50.0": 3711.1476541176858
      }
    },
    "3": {
      "count": 30917,
      "values": {
        "50.0": 3407.2614602417534
      }
    }
  },
  "HOUSE": {
    "1": {
      "count": 87,
      "values": {
        "50.0": 2755.0299999999997
      }
    },
    "2": {
      "count": 264,
      "values": {
        "50.0": 3488.37
      }
    },
    "3": {
      "count": 1137,
      "values": {
        "50.0": 3313.7432000000003
      }
    }
  }
}
  • Consommation: 12 SKU
Offre Starter Essentiel Avancée Business
Endpoints 12 SKU 12 SKU 12 SKU 12 SKU
PROPERTY_ANALYTIC 0,25200€ 0,12600€ 0,10560€ 0,09360€

Le nombre de SKU est égal au nombre de percentiles (q50) + 1, multiplié par le nombre de sous-regroupement renvoyés dans la réponse HTTP.

 

Endpoint : /properties/stats

  • Requête
GET https://api.yanport.com/properties/stats?field=SURFACE&zipCodes=92300&marketingTypes=SALE
  •  Réponse
{
  "count": 17808,
  "min": 5.5,
  "max": 5360.0,
  "avg": 69.72658636567836,
  "sum": 1241691.0500000003
}
  • Consommation: 5 SKU
Offre Starter Essentiel Avancée Business
Endpoints 5 SKU 5 SKU 5 SKU 5 SKU
PROPERTY_ANALYTIC 0,10500€ 0,05250€ 0,04400€ 0,03900€

Le nombre de SKU est toujours égale à 5 pour ce type de requête.

 

Endpoint : /properties/stats/group-by-{groupBy}

  • Requête
GET https://api.yanport.com/properties/stats/group-by-room-count?field=SURFACE&zipCodes=92300&roomCounts=1&roomCounts=2&propertyTypes=APARTMENT
  •  Réponse
{
  "1": {
    "count": 8229,
    "min": 5.5,
    "max": 190.0,
    "avg": 23.172838741037797,
    "sum": 190689.29000000004
  },
  "2": {
    "count": 13009,
    "min": 10.0,
    "max": 330.0,
    "avg": 40.792986394034884,
    "sum": 530675.9599999998
  }
}
  • Consommation: 10 SKU
Offre Starter Essentiel Avancée Business
Endpoints 10 SKU 10 SKU 10 SKU 10 SKU
PROPERTY_ANALYTIC 0,21000€ 0,10500€ 0,08800€ 0,07800€

Le nombre de SKU est égal à 5 multiplié par le nombre de regroupements dans la réponse HTTP.

 

Endpoint : /properties/stats/group-by-{groupBy}-and-{subGroupBy}

  • Requête
GET https://api.yanport.com/properties/stats/group-by-room-count-and-surface?field=PRICE&zipCodes=92300&roomCounts=1&roomCounts=2&propertyTypes=APARTMENT&termsSize=10
  •  Réponse
{
  "1": {
    "16.0": {
      "count": 302,
      "min": 45.0,
      "max": 199500.0,
      "avg": 29192.973741721857,
      "sum": 8816278.07
    },
    "15.0": {
      "count": 316,
      "min": 40.0,
      "max": 215000.0,
      "avg": 32444.512911392405,
      "sum": 1.025246608E7
    },
    "25.0": {
      "count": 430,
      "min": 80.0,
      "max": 379000.0,
      "avg": 45944.225581395345,
      "sum": 1.9756017E7
    },
    "24.0": {
      "count": 300,
      "min": 375.0,
      "max": 320000.0,
      "avg": 51635.471633333334,
      "sum": 1.549064149E7
    },
    "23.0": {
      "count": 288,
      "min": 400.0,
      "max": 392000.0,
      "avg": 38050.05868055556,
      "sum": 1.09584169E7
    },
    "22.0": {
      "count": 284,
      "min": 375.0,
      "max": 269000.0,
      "avg": 33894.22503521127,
      "sum": 9625959.91
    },
    "20.0": {
      "count": 462,
      "min": 35.0,
      "max": 220000.0,
      "avg": 29688.700259740257,
      "sum": 1.371617952E7
    },
    "30.0": {
      "count": 425,
      "min": 50.0,
      "max": 385000.0,
      "avg": 71447.72724705882,
      "sum": 3.036528408E7
    },
    "18.0": {
      "count": 321,
      "min": 480.0,
      "max": 259000.0,
      "avg": 39360.51981308411,
      "sum": 1.263472686E7
    },
    "28.0": {
      "count": 303,
      "min": 250.0,
      "max": 460000.0,
      "avg": 72731.37768976898,
      "sum": 2.203760744E7
    }
  },
  "2": {
    "36.0": {
      "count": 381,
      "min": 369.0,
      "max": 445000.0,
      "avg": 113036.01257217847,
      "sum": 4.306672079E7
    },
    "35.0": {
      "count": 534,
      "min": 75.0,
      "max": 399000.0,
      "avg": 82422.8095692884,
      "sum": 4.401378031E7
    },
    "50.0": {
      "count": 504,
      "min": 550.0,
      "max": 970000.0,
      "avg": 187359.27984126986,
      "sum": 9.442907704E7
    },
    "40.0": {
      "count": 644,
      "min": 60.0,
      "max": 740000.0,
      "avg": 139611.75400621118,
      "sum": 8.990996958E7
    },
    "32.0": {
      "count": 344,
      "min": 550.0,
      "max": 470000.0,
      "avg": 90337.49418604652,
      "sum": 3.1076098E7
    },
    "30.0": {
      "count": 522,
      "min": 60.0,
      "max": 390000.0,
      "avg": 95117.68582375479,
      "sum": 4.9651432E7
    },
    "42.0": {
      "count": 470,
      "min": 875.0,
      "max": 545000.0,
      "avg": 167306.72634042552,
      "sum": 7.863416138E7
    },
    "45.0": {
      "count": 463,
      "min": 500.0,
      "max": 520689.0,
      "avg": 161209.2836285097,
      "sum": 7.463989832E7
    },
    "37.0": {
      "count": 378,
      "min": 500.0,
      "max": 399000.0,
      "avg": 118731.98682539682,
      "sum": 4.4880691019999996E7
    },
    "38.0": {
      "count": 400,
      "min": 500.0,
      "max": 470000.0,
      "avg": 132925.0925,
      "sum": 5.3170037E7
    }
  }
}
  • Consommation: 100 SKU
Offre Starter Essentiel Avancée Business
Endpoints 100 SKU 100 SKU 100 SKU 100 SKU
PROPERTY_ANALYTIC 2,10000€ 1,05000€ 0,88000€ 0,78000€

Le nombre de SKU est égal à 5 multiplié par le nombre de sous-regroupements dans la réponse HTTP.

 

Endpoint : /properties/average

  • Requête
GET https://api.yanport.com/properties/average?field=PRICE_M2&source=AD&marketingTypes=SALE&propertyTypes=APARTMENT&active=true&zipCodes=92300
  •  Réponse
{
  "count": 302,
  "value": 10058.364916864608
}
  • Consommation: 2 SKU
Offre Starter Essentiel Avancée Business
Endpoints 2 SKU 2 SKU 2 SKU 2 SKU
PROPERTY_ANALYTIC 0,04200€ 0,02100€ 0,01760€ 0,01560€

Le nombre de SKU est égal à 2 pour toute requête sur ce endpoint.

 

Endpoint : /properties/average/group-by-{groupBy}

  • Requête
GET https://api.yanport.com/properties/average/group-by-surface?field=PRICE_M2&source=AD&marketingTypes=SALE&zipCodes=78300
  •  Réponse
{
  "70.0": {
    "count": 504,
    "value": 4011.6121868787277
  },
  "90.0": {
    "count": 414,
    "value": 4075.1121549636805
  }
}
  • Consommation: 4 SKU
Offre Starter Essentiel Avancée Business
Endpoints 4 SKU 4 SKU 4 SKU 4 SKU
PROPERTY_ANALYTIC 0,08400€ 0,04200€ 0,02520€ 0,02120€

Le nombre de SKU est égal au nombre de résultats multiplié par le coût unitaire lié à l'obtention de la moyenne : 2 x 2 = 4 SKU.

 

Endpoint : /properties/average/group-by-{groupBy}-and-{subGroupBy}

  • Requête
GET https://api.yanport.com/properties/average/group-by-surface-and-dealers-type?field=PRICE_M2&source=AD&marketingTypes=SALE&zipCodes=78300
  •  Réponse
{
  "70.0": {
    "AGENCY": {
      "count": 354,
      "value": 4139.735423728814
    },
    "MANDATARY": {
      "count": 59,
      "value": 3707.628813559322
    }
  },
  "90.0": {
    "AGENCY": {
      "count": 307,
      "value": 4230.253876221498
    },
    "MANDATARY": {
      "count": 39,
      "value": 3676.440769230769
    }
  }
}
  • Consommation: 8 SKU
Offre Starter Essentiel Avancée Business
Endpoints 8 SKU 8 SKU 8 SKU 8 SKU
PROPERTY_ANALYTIC 0,16800€ 0,08400€ 0,05040€ 0,04240€

Le nombre de SKU est égal au nombre de résultats multiplié par le coût unitaire lié à l'obtention de la moyenne : 4 x 2 = 8 SKU.

 

Endpoint : /properties/evolution/reliable-zone

  • Requête
GET https://api.yanport.com/properties/evolution/reliable-zone?propertyTypes=APARTMENT&marketingType=SALE&agglomerationId=4762789834677248&cityId=52421209&irisId=751062402&dateMin=2021-01-01T00:00:00&dateMax=2021-12-31T23:59:59&source=AD
  •  Réponse
{
  "zones": [
    {
      "id": "751062101",
      "type": "IRIS",
      "selected": false,
      "eligible": true
    },
    {
      "id": "751041501",
      "type": "IRIS",
      "selected": false,
      "eligible": false
    },
    {
      "id": "751062102",
      "type": "IRIS",
      "selected": true,
      "eligible": true
    }
  ],
  "query": {
    "roomCounts": [
      1,
      2,
      3,
      4,
      5
    ],
    "intervalUnit": "MONTHS",
    "dateMin": "2021-01-01T00:00:00",
    "dateMax": "2021-12-31T23:59:59",
    "source": "AD",
    "field": "PRICE_M2"
  },
  "reliability": {
    "reliable": true,
    "score": 63
  }
}
  • Consommation: 1 SKU
Offre Starter Essentiel Avancée Business
Endpoints 1 SKU 1 SKU 1 SKU 1 SKU
PROPERTY_ANALYTIC 0,02100€ 0,01050€ 0,00880€ 0,00780€

Le nombre SKU est de 1 par requête.

 

Endpoint : /properties/percentiles/reliable-zone

  • Requête
GET https://api.yanport.com/properties/percentiles/reliable-zone?propertyTypes=APARTMENT&marketingType=SALE&agglomerationId=4762789834677248&cityId=52421209&irisId=751062402&dateMin=2021-01-01T00:00:00&dateMax=2021-12-31T23:59:59&source=AD
  •  Réponse
{
  "zones": [
    {
      "id": "751062101",
      "type": "IRIS",
      "selected": false,
      "eligible": true
    },
    {
      "id": "751041501",
      "type": "IRIS",
      "selected": false,
      "eligible": false
    },
    {
      "id": "751062102",
      "type": "IRIS",
      "selected": true,
      "eligible": true
    }
  ],
  "query": {
    "roomCounts": [
      1,
      2,
      3,
      4,
      5
    ],
    "intervalUnit": "MONTHS",
    "dateMin": "2021-01-01T00:00:00",
    "dateMax": "2021-12-31T23:59:59",
    "source": "AD",
    "field": "PRICE_M2"
  },
  "reliability": {
    "reliable": true,
    "score": 63
  }
}
  • Consommation: 1 SKU
Offre Starter Essentiel Avancée Business
Endpoints 1 SKU 1 SKU 1 SKU 1 SKU
PROPERTY_ANALYTIC 0,02100€ 0,01050€ 0,00880€ 0,00780€

Le nombre SKU est de 1 par requête.

 

Endpoint : /properties/stats/reliable-zone

  • Requête
GET https://api.yanport.com/properties/stats/reliable-zone?propertyTypes=APARTMENT&marketingType=SALE&agglomerationId=4762789834677248&cityId=52421209&irisId=751062402&dateMin=2021-01-01T00:00:00&dateMax=2021-12-31T23:59:59&source=AD
  •  Réponse
{
  "zones": [
    {
      "id": "751062101",
      "type": "IRIS",
      "selected": false,
      "eligible": true
    },
    {
      "id": "751041501",
      "type": "IRIS",
      "selected": false,
      "eligible": false
    },
    {
      "id": "751062102",
      "type": "IRIS",
      "selected": true,
      "eligible": true
    }
  ],
  "query": {
    "roomCounts": [
      1,
      2,
      3,
      4,
      5
    ],
    "intervalUnit": "MONTHS",
    "dateMin": "2021-01-01T00:00:00",
    "dateMax": "2021-12-31T23:59:59",
    "source": "AD",
    "field": "PRICE_M2"
  },
  "reliability": {
    "reliable": true,
    "score": 63
  }
}
  • Consommation: 1 SKU
Offre Starter Essentiel Avancée Business
Endpoints 1 SKU 1 SKU 1 SKU 1 SKU
PROPERTY_ANALYTIC 0,02100€ 0,01050€ 0,00880€ 0,00780€

Le nombre SKU est de 1 par requête.

Articles associés