Endpoint API

Analyse flexible

Effectue une analyse de marché flexible avec des critères personnalisables.

Retour à la documentation
GET/v1/analyse-flex

Analyse avancée du marché pour un véhicule donné. Retourne des points de comparaison, statistiques et insights basés sur les critères fournis. Permet de filtrer par similarité et fraîcheur des annonces.

Sécurité : X-API-Key: <clé API>

Prix : 0,49€ par analyse

Paramètres de requête

brand

Marque du véhicule

string
model_name

Nom du modèle

string
fuel_type

Type de carburant

string
gearbox_type

Type de boîte de vitesses

string
year

Année (1900-2100)

integer
doors

Nombre de portes (1-7)

integer
seats

Nombre de places (1-9)

integer
horsepower

Puissance fiscale (CV)

integer
horse_power_din

Puissance DIN (ch)

integer
mileage

Kilométrage

integer
vehicle_type

Typologie véhicule (ex: 'Berline')

string
color_type

Couleur (défaut: 'noir')

string (optionnel)
delta_t

Fenêtre fraîcheur annonces en jours (défaut: 15)

integer (optionnel)
ref

Annonce de référence

integer (optionnel)
nb_de_points_min

Nombre minimal de points à conserver (défaut: 550)

integer (optionnel)
min_similarity

Seuil de similarité (%) prioritaire sur nb_de_points_min

integer (optionnel)
fields

Champs à renvoyer dans 'points' (CSV). Ex: 'price,mileage,year' ou '*' pour tout

string (optionnel)
max_points

Nombre maximal de points renvoyés (défaut: 1000)

integer (optionnel)

Réponses

200 — Résultats de l'analyse de marché

{
  "similarity_min": 84,
  "count": 657,
  "positionings": {
    "price_ref_pos": null,
    "count": null,
    "threshold_percentage": null
  },
  "temps_vente": 91,
  "vehicle_prediction": { "prediction": 10870, "version": "6" },
  "temps_api": "0:01:32.512835",
  "points_fields": [
    "ad_id",
    "similarity",
    "brand_name",
    "model_name",
    "year",
    "location_id",
    "lat",
    "lng",
    "first_publication_date",
    "first_deactivated_date",
    "first_price",
    "price",
    "mileage",
    "owner_type",
    "horse_power_din"
  ],
  "ignored_fields": [],
  "points": [
    ...
  ]
}

422 — Erreur de validation des paramètres

Exemples

cURL

curl "https://api.mytracks.fr/v1/analyse-flex?brand=peugeot&model_name=208&fuel_type=Essence&gearbox_type=Manuelle&year=2020&doors=5&seats=5&horsepower=5&horse_power_din=90&mileage=45000&vehicle_type=Citadine" \
  -H "X-API-Key: {{API_KEY}}"
MyTracks | Application