Aller au contenu

Référence API / Véhicules

Rechercher les véhicules aux enchères actifs

GET/carsTaille de page 50 / 1000

Recherchez 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-lots pour 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=1 pour inclure le tableau prices de chaque lot.
  • Une annonce active ne garantit pas que les enchères sont ouvertes. Voir exclude_expired_auctions pour une limite actuelle de l’implémentation.
  1. Modifiez les valeurs ci-dessous
  2. La requête à droite se met à jourLa requête ci-dessus se met à jour
  3. Lancez-la en direct avec votre clé

Paramètres de requête 46

integer

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.

integer · 1–4320

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.

integer · 1–1000

Enregistrements par page. 50 par défaut. Maximum 1000 avec Unlimited ; Demo et Small sont limités à 50.

integer · 1+

Numéro de page, à partir de 1. Omettez-le pour la page 1.

integer · 0–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.

string

Trie les véhicules par ID interne : asc (par défaut) ou desc. Ne trie ni par date de vente ni par prix.

integer · 0–1

1 pour inclure le tableau de l’historique des prix de chaque lot. Omettez-le ou indiquez 0 pour la réponse standard.

string

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.

integer · 1+

ID interne du modèle, issu de /models/{manufacturer_id}/{type}.

integer · 1+

ID interne de la génération, issu de /generations/{model_id}/{type}.

integer

Millésime exact, par exemple 2020. Sur /cars, il s’applique avec toute plage d’années.

integer

Millésime minimum, inclus. Peut se combiner avec to_year.

integer

Millésime maximum, inclus. Peut se combiner avec from_year.

string

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.

string

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.

string

Sous-chaîne du titre du véhicule, insensible à la casse, par exemple Corvette.

integer

ID de catégorie de véhicule. Voir les valeurs acceptées ci-dessous.

integer

ID du type de carrosserie. Voir les valeurs acceptées ci-dessous.

integer

ID de la couleur extérieure. Voir les valeurs acceptées ci-dessous.

integer

ID du type de carburant. Voir les valeurs acceptées ci-dessous.

integer

ID de la boîte de vitesses : 1 = automatique, 2 = manuelle.

integer

ID de la transmission : 1 = propulsion, 2 = traction, 3 = intégrale.

integer

ID de l’état de l’annonce. Voir les valeurs acceptées ci-dessous.

integer

Nombre exact de cylindres, par exemple 4, 6 ou 8.

string

Sous-chaîne du nom du moteur, insensible à la casse, par exemple 2.0.

string

Code pays à deux lettres du lieu du véhicule, par exemple US ou CA. Omettez-le pour inclure tous les pays disponibles.

string

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.

string

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é.

string

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é.

integer

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.

array of integers

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.

integer · 0–1

1 pour exiger un prix Buy Now positif. 0 ou l’omission ne filtre pas sur Buy Now.

number · 1+

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.

number · 1+

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.

number · 1+

Enchère enregistrée minimum, incluse (1 ou plus, décimales acceptées). Ce n’est pas le montant de la vente finale.

number · 1+

Enchère enregistrée maximum, incluse (1 ou plus, décimales acceptées). Ce n’est pas le montant de la vente finale.

integer · 1+

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.

integer · 1+

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.

integer · 1+

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.

integer · 1+

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.

string (date)

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.

string (date)

Date de vente strictement antérieure à cette date (YYYY-MM-DD). L’heure est ignorée. Ignoré avec without_sale_date=1.

integer · 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.

integer · 1+

Horodatages de vente entre maintenant et dans N heures, inclus, par exemple 24. Se combine avec les autres filtres de date actifs.

integer · 0–1

1 pour sélectionner les lots sans date de vente. Prime sur sale_date_from, sale_date_to et sale_date_in_days.

integer · 0–1

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.

© 2025. AuctionsAPI operates independently and is not affiliated with Copart, IAAI or Encar.