Saltar al contenido

Referencia de la API / Vehículos

Buscar vehículos activos en subasta

GET/carsTamaño de página 50 / 1000

Busca vehículos con anuncios activos en Copart o IAAI. Úsalo para abastecimiento, inventario de importadores, monitoreo y análisis de mercado.

  • Filtra por fuente, fabricante, modelo, generación, año, kilometraje, precio, ubicación, daño y datos de la subasta. Todos los parámetros de consulta son opcionales.
  • El tamaño de página por defecto es 50 en todos los planes; el máximo es 1000 en Unlimited. Los vehículos se ordenan por ID interno, de forma ascendente por defecto. Usa minutes para los cambios de los últimos 4320 minutos (72 horas) y /archived-lots para seguir las bajas.
  • Devuelve los vehículos en data, con la paginación en links y meta. Cada vehículo incluye especificaciones y un array lots con identificadores de la fuente, fotos, kilometraje, precios, fechas de subasta y estado cuando están disponibles. Añade prices_history=1 para incluir el array prices de cada lote.
  • Un anuncio activo no garantiza que las pujas estén abiertas. Consulta exclude_expired_auctions para ver una limitación actual de la implementación.
  1. Cambia los valores de abajo
  2. La solicitud de la derecha se actualizaLa solicitud de arriba se actualiza
  3. Ejecútala en vivo con tu clave

Parámetros de consulta 46

integer

ID de la plataforma de origen: 1 = IAAI, 3 = Copart. Omítelo para buscar en todas las fuentes disponibles para tu cuenta. Filtra los vehículos coincidentes; sus lotes anidados pueden incluir otras fuentes.

integer · 1–4320

Vehículos o anuncios actualizados en los últimos N minutos. Usa 1–4320 (hasta 72 horas), por ejemplo 60. Omítelo para el feed normal.

integer · 1–1000

Registros por página. Si lo omites, 50. Máximo 1000 en Unlimited; Demo y Small están limitados a 50.

integer · 1+

Número de página, empezando por 1. Omítelo para pedir la página 1.

integer · 0–1

Define 1 para omitir los totales o 0 para incluirlos. Omítelo para usar el valor por defecto de tu cuenta. La paginación simple conviene en sincronizaciones grandes.

string

Ordena los vehículos por ID interno: asc (por defecto) o desc. No ordena por hora de subasta ni por precio.

integer · 0–1

Define 1 para incluir el array del historial de precios de cada lote. Omítelo o usa 0 para la respuesta estándar.

string

Un ID de fabricante o varios separados por comas de /manufacturers/{type}, por ejemplo 16 (BMW) o 16,20. Envía una sola cadena, no un array.

integer · 1+

ID interno del modelo de /models/{manufacturer_id}/{type}.

integer · 1+

ID interno de la generación de /generations/{model_id}/{type}.

integer

Año de modelo exacto, por ejemplo 2020. En /cars se aplica junto con cualquier rango de años.

integer

Año de modelo mínimo, inclusive. Se puede combinar con to_year.

integer

Año de modelo máximo, inclusive. Se puede combinar con from_year.

string

Un VIN (coincidencia con el valor guardado, sin distinguir mayúsculas) o un número de lote de la fuente. Para filtrar solo por VIN usa vin; para consultar activos y archivados usa /search-vin o /search-lot.

string

Filtro por VIN sin distinguir mayúsculas. Usa _ como comodín de varios caracteres: YV1MC_ coincide con los VIN que empiezan por YV1MC. Sin comodín coincide con el valor guardado completo.

string

Subcadena del título del vehículo, sin distinguir mayúsculas, por ejemplo Corvette.

integer

ID de la categoría de vehículo. Consulta los valores aceptados abajo.

integer

ID del tipo de carrocería. Consulta los valores aceptados abajo.

integer

ID del color exterior. Consulta los valores aceptados abajo.

integer

ID del tipo de combustible. Consulta los valores aceptados abajo.

integer

ID de la transmisión: 1 = automática, 2 = manual.

integer

ID de la tracción: 1 = trasera, 2 = delantera, 3 = integral.

integer

ID del estado del anuncio. Consulta los valores aceptados abajo.

integer

Número exacto de cilindros del motor, por ejemplo 4, 6 u 8.

string

Subcadena del nombre del motor, sin distinguir mayúsculas, por ejemplo 2.0.

string

Código de país de dos letras de la ubicación del vehículo, por ejemplo US o CA. Omítelo para incluir todos los países disponibles.

string

Código de estado o provincia de /usa/states, por ejemplo CA o FL. No distingue mayúsculas; combínalo con country para distinguir ubicaciones con el mismo código.

string

Subcadena, sin distinguir mayúsculas, de un nombre de daño principal o secundario de /usa/damages, por ejemplo hail o front. Envía una cadena simple. Si ningún daño del diccionario coincide, el filtro no se aplica.

string

Subcadena, sin distinguir mayúsculas, de un nombre de título del documento de /usa/titles, por ejemplo salvage. Revisa el título del anuncio, el detallado y el corto. Si ningún título del diccionario coincide, el filtro no se aplica.

integer

ID del estado de subasta. Consulta los valores aceptados abajo. Para varios estados usa status[]; no envíes ambos.

array of integers

Varios ID de estado de subasta (1–10) como claves repetidas con corchetes, por ejemplo status[]=4&status[]=5. Úsalo en lugar de status. No envíes status=[] ni una cadena JSON.

integer · 0–1

Define 1 para exigir un precio Buy Now positivo. Con 0 o sin el parámetro, Buy Now no se filtra.

number · 1+

Precio Buy Now mínimo, inclusive (1 o más, se aceptan decimales). Los importes usan las unidades de precio guardadas de la fuente, sin conversión ni comisiones.

number · 1+

Precio Buy Now máximo, inclusive (1 o más, se aceptan decimales). Los importes usan las unidades de precio guardadas de la fuente, sin conversión ni comisiones.

number · 1+

Puja guardada mínima, inclusive (1 o más, se aceptan decimales). No es el importe de la venta final.

number · 1+

Puja guardada máxima, inclusive (1 o más, se aceptan decimales). No es el importe de la venta final.

integer · 1+

Lectura mínima del odómetro en kilómetros, inclusive. Si defines filtros en kilómetros y en millas, deben cumplirse ambos.

integer · 1+

Lectura máxima del odómetro en kilómetros, inclusive. Si defines filtros en kilómetros y en millas, deben cumplirse ambos.

integer · 1+

Lectura mínima del odómetro en millas, inclusive. Si defines filtros en kilómetros y en millas, deben cumplirse ambos.

integer · 1+

Lectura máxima del odómetro en millas, inclusive. Si defines filtros en kilómetros y en millas, deben cumplirse ambos.

string (date)

Fecha de subasta estrictamente posterior a esta fecha de calendario (YYYY-MM-DD). Se ignora la hora. Tiene prioridad sobre sale_date_in_days; se ignora con without_sale_date=1.

string (date)

Fecha de subasta estrictamente anterior a esta fecha de calendario (YYYY-MM-DD). Se ignora la hora. Se ignora con without_sale_date=1.

integer · 1+

Lotes cuya fecha de subasta es posterior a hace N días, incluidas fechas futuras. sale_date_from tiene prioridad; se ignora con without_sale_date=1.

integer · 1+

Subastas entre ahora y dentro de N horas, inclusive, por ejemplo 24. Se combina con los demás filtros de fecha activos.

integer · 0–1

Define 1 para seleccionar lotes sin fecha de venta. Anula sale_date_from, sale_date_to y sale_date_in_days.

integer · 0–1

Limitación actual de la implementación: pese a su nombre, 1 selecciona lotes sin fecha de venta o con una fecha anterior a ahora, así que no excluye las subastas pasadas. Omítelo o usa 0; usa next_hours_auction para una ventana próxima.

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