Guides

Syntaxe des filtres de recherche

Les filtres se placent dans la query string de /cars. Ils sont tous facultatifs et se combinent avec un ET.

Omettez les filtres inutilisés

N’envoyez jamais de valeur vide comme domain_id= ou page=. Retirez le paramètre.

Source et véhicule

domain_id=3 correspond à Copart et domain_id=1 à IAAI. Il sélectionne les véhicules ayant une annonce correspondante ; leurs lots imbriqués peuvent inclure d’autres sources, lisez donc lots[].domain.id.

Plusieurs constructeurs

manufacturer_id prend une seule chaîne d’ID séparés par des virgules, par exemple 16,20. N’envoyez pas de tableau.

Plusieurs statuts

Répétez la clé avec crochets : status[]=4&status[]=5. Ne combinez pas status et status[], et n’envoyez jamais status=[].

Recherche par VIN

vin correspond au VIN enregistré complet, sans tenir compte de la casse. Utilisez _ comme joker : YV1MC_ correspond à tous les VIN qui commencent par YV1MC. search_query accepte un VIN ou un numéro de lot.

Années

year est exact ; from_year et to_year sont des bornes incluses. Sur /cars, ils s’appliquent ensemble.

Dates de vente

sale_date_from et sale_date_to sont des dates calendaires exclues (YYYY-MM-DD). sale_date_from prime sur sale_date_in_days, et without_sale_date=1 prime sur les trois.

Modifiés récemment

minutes=60 renvoie les véhicules mis à jour dans la dernière heure. La plage acceptée va de 1 à 4320 minutes (72 heures).

Prix et kilométrage

buy_now_price_* et bid_price_* utilisent les unités de prix enregistrées de la source, sans conversion ni frais. Si des bornes en kilomètres et en miles sont toutes deux définies, les deux doivent correspondre.

Filtres texte

name, engine_name, damage et document_title sont des sous-chaînes insensibles à la casse. Quand damage ou document_title ne correspond à rien dans son dictionnaire, le filtre n’est pas appliqué.