CarroYa Colombia Scraper API: carros, precios y anuncios

CarroYa Colombia

API pública de búsqueda find-filters del dominio oficial de servicios CarroYa. Valida la palabra consultada, página y totales; recorre los grupos destacados y novedades de la misma página y deduplica anuncios globalmente.

Ejemplo

{"term": "renault", "maxItems": 3}

Datos y límites

Una fila por vehículo publicado: ID, marca, modelo, versión, año, kilómetros, transmisión, combustible, color, ciudad/departamento, condición anunciada, imagen y precio en COP. No sustituye el precio por una cuota de crédito. El estado vendido se conserva tal como lo informa la fuente; no se promete stock ni vigencia independiente. No entrega nombres de particulares, teléfonos, correos, placas ni comentarios libres. Algunos anuncios antiguos tienen enlaces de detalle mal formados: detail_url queda vacío, source_detail_link_valid es false y source_url apunta a la página real de búsqueda que contiene el anuncio; nunca se inventa un enlace de detalle. Anuncios sin precio verificable no se cobran. Los totales de la fuente pueden incluir destacados repetidos o anuncios sin precio.

Búsqueda

Usa una palabra, marca o modelo en term, por ejemplo renault o porsche. searchTerms sustituye la búsqueda individual y deduplica globalmente; mayúsculas/minúsculas mantienen el mismo criterio de búsqueda. Se validan los parámetros que devuelve la fuente para evitar resultados de una consulta diferente.

Ejecución y precio

Sin maxItems ni maxPages no hay un tope oculto de resultados. El tiempo predeterminado es 240 segundos, configurable hasta 7200, además del presupuesto de gasto de Apify. Entrega resultados únicos por página o lotes de hasta 100. Si falla una página posterior, conserva las anteriores con estado partial. startPage permite retomar la paginación. Proxies y recuperación automáticos, sin configuración técnica del cliente. USD 0.0025 por resultado real único entregado, más consumo de plataforma a cargo del usuario. No cobra resúmenes, errores, duplicados ni búsquedas vacías.

RUN_SUMMARY informa success, no_results, partial, blocked o failed, junto con paginación y rendimiento. Los campos no publicados quedan vacíos. Exporta JSON, CSV o Excel y ejecuta por la API de Apify. Herramienta independiente, sin afiliación oficial con la marca.