Référence API / Véhicules
Rechercher les véhicules aux enchères actifs
/carsTaille de page 50 / 1000Recherchez les véhicules ayant des annonces Copart ou IAAI actives. Idéal pour le sourcing, le stock d’un importateur, la veille et l’analyse de marché.
- Filtrez par source, constructeur, modèle, génération, année, kilométrage, prix, lieu, dommages et détails de l’enchère. Tous les paramètres de requête sont facultatifs.
- La taille de page par défaut est de 50 avec toutes les formules ; le maximum est de 1000 avec Unlimited. Les véhicules sont triés par ID interne, croissant par défaut. Utilisez minutes pour les mises à jour des 4320 dernières minutes (72 heures) et
/archived-lotspour suivre les retraits. - Renvoie les véhicules dans data, avec la pagination dans links et meta. Chaque véhicule comprend ses caractéristiques et un tableau lots avec identifiants de source, photos, kilométrage, prix, dates de vente et état quand ils sont disponibles. Ajoutez
prices_history=1pour inclure le tableau prices de chaque lot. - Une annonce active ne garantit pas que les enchères sont ouvertes. Voir
exclude_expired_auctionspour une limite actuelle de l’implémentation.
- Modifiez les valeurs ci-dessous
- La requête à droite se met à jourLa requête ci-dessus se met à jour
- Lancez-la en direct avec votre clé
Paramètres de requête 46
ID de la plateforme source : 1 = IAAI, 3 = Copart. Omettez-le pour chercher dans toutes les sources de votre compte. Filtre les véhicules correspondants ; leurs lots imbriqués peuvent inclure d’autres sources.
Véhicules ou annonces mis à jour au cours des N dernières minutes. De 1 à 4320 (jusqu’à 72 heures), par exemple 60. Omettez-le pour le flux normal.
Enregistrements par page. 50 par défaut. Maximum 1000 avec Unlimited ; Demo et Small sont limités à 50.
Numéro de page, à partir de 1. Omettez-le pour la page 1.
1 pour ne pas calculer les totaux, 0 pour les inclure. Omettez-le pour garder le réglage par défaut du compte. La pagination simple convient aux grandes synchronisations.
Trie les véhicules par ID interne : asc (par défaut) ou desc. Ne trie ni par date de vente ni par prix.
1 pour inclure le tableau de l’historique des prix de chaque lot. Omettez-le ou indiquez 0 pour la réponse standard.
Un ID de constructeur ou plusieurs séparés par des virgules, issus de /manufacturers/{type}, par exemple 16 (BMW) ou 16,20. Envoyez une seule chaîne, pas un tableau.
ID interne du modèle, issu de /models/{manufacturer_id}/{type}.
ID interne de la génération, issu de /generations/{model_id}/{type}.
Millésime exact, par exemple 2020. Sur /cars, il s’applique avec toute plage d’années.
Millésime minimum, inclus. Peut se combiner avec to_year.
Millésime maximum, inclus. Peut se combiner avec from_year.
Un VIN (correspondance avec la valeur enregistrée, insensible à la casse) ou un numéro de lot de la source. Pour filtrer uniquement par VIN, utilisez vin ; pour une recherche dans les actifs et l’archive, utilisez /search-vin ou /search-lot.
Filtre VIN insensible à la casse. Utilisez _ comme joker multicaractère : YV1MC_ correspond aux VIN qui commencent par YV1MC. Sans joker, il porte sur la valeur enregistrée complète.
Sous-chaîne du titre du véhicule, insensible à la casse, par exemple Corvette.
ID de catégorie de véhicule. Voir les valeurs acceptées ci-dessous.
ID du type de carrosserie. Voir les valeurs acceptées ci-dessous.
ID de la couleur extérieure. Voir les valeurs acceptées ci-dessous.
ID du type de carburant. Voir les valeurs acceptées ci-dessous.
ID de la boîte de vitesses : 1 = automatique, 2 = manuelle.
ID de la transmission : 1 = propulsion, 2 = traction, 3 = intégrale.
ID de l’état de l’annonce. Voir les valeurs acceptées ci-dessous.
Nombre exact de cylindres, par exemple 4, 6 ou 8.
Sous-chaîne du nom du moteur, insensible à la casse, par exemple 2.0.
Code pays à deux lettres du lieu du véhicule, par exemple US ou CA. Omettez-le pour inclure tous les pays disponibles.
Code d’État ou de province issu de /usa/states, par exemple CA ou FL. Insensible à la casse ; combinez-le avec country pour distinguer des lieux au même code.
Sous-chaîne, insensible à la casse, d’un nom de dommage principal ou secondaire issu de /usa/damages, par exemple hail ou front. Envoyez une chaîne simple. Si aucun dommage du dictionnaire ne correspond, le filtre n’est pas appliqué.
Sous-chaîne, insensible à la casse, d’un titre de propriété issu de /usa/titles, par exemple salvage. Vérifie le titre de l’annonce, détaillé et court. Si aucun titre du dictionnaire ne correspond, le filtre n’est pas appliqué.
ID du statut de l’enchère. Voir les valeurs acceptées ci-dessous. Pour plusieurs statuts, utilisez plutôt status[] ; n’envoyez pas les deux.
Plusieurs ID de statut d’enchère (1–10) en clés répétées avec crochets, par exemple status[]=4&status[]=5. À utiliser à la place de status. N’envoyez pas status=[] ni une chaîne JSON.
1 pour exiger un prix Buy Now positif. 0 ou l’omission ne filtre pas sur Buy Now.
Prix Buy Now minimum, inclus (1 ou plus, décimales acceptées). Les montants sont dans les unités de prix enregistrées de la source, sans conversion ni frais.
Prix Buy Now maximum, inclus (1 ou plus, décimales acceptées). Les montants sont dans les unités de prix enregistrées de la source, sans conversion ni frais.
Enchère enregistrée minimum, incluse (1 ou plus, décimales acceptées). Ce n’est pas le montant de la vente finale.
Enchère enregistrée maximum, incluse (1 ou plus, décimales acceptées). Ce n’est pas le montant de la vente finale.
Kilométrage relevé minimum en kilomètres, inclus. Si des filtres en kilomètres et en miles sont tous deux définis, les deux doivent correspondre.
Kilométrage relevé maximum en kilomètres, inclus. Si des filtres en kilomètres et en miles sont tous deux définis, les deux doivent correspondre.
Kilométrage relevé minimum en miles, inclus. Si des filtres en kilomètres et en miles sont tous deux définis, les deux doivent correspondre.
Kilométrage relevé maximum en miles, inclus. Si des filtres en kilomètres et en miles sont tous deux définis, les deux doivent correspondre.
Date de vente strictement postérieure à cette date (YYYY-MM-DD). L’heure est ignorée. Prime sur sale_date_in_days ; ignoré avec without_sale_date=1.
Date de vente strictement antérieure à cette date (YYYY-MM-DD). L’heure est ignorée. Ignoré avec without_sale_date=1.
Lots dont la date de vente est postérieure à il y a N jours, dates futures comprises. Remplacé par sale_date_from ; ignoré avec without_sale_date=1.
Horodatages de vente entre maintenant et dans N heures, inclus, par exemple 24. Se combine avec les autres filtres de date actifs.
1 pour sélectionner les lots sans date de vente. Prime sur sale_date_from, sale_date_to et sale_date_in_days.
Limite actuelle de l’implémentation : malgré son nom, 1 sélectionne les lots sans date de vente ou dont la date de vente est passée ; il n’exclut donc pas les enchères passées. Omettez-le ou indiquez 0 ; utilisez next_hours_auction pour une fenêtre à venir.