Extrae anuncios de piezas usadas de una página de búsqueda Ovoko. Devuelve { results, pagination } con las mismas claves en todos los mercados: SKU, título, precio, moneda, códigos OEM, vendedor y texto del vehículo.
Solo se aceptan páginas de búsqueda. Categorías, catálogos y ofertas devuelven 400.
Tarjetas HTML, __NEXT_DATA__ y JSON XHR se normalizan a este esquema. El título es siempre title (no hay campo name).
GET https://api.piloterr.com/v2/ovoko/search?query=https://ovoko.es/buscar?q=filtro
GET https://api.piloterr.com/v2/ovoko/search?query=https://ovoko.pl/szukaj?q=Porsche+Macan+uszczelka+klapy+bagaznika&exact=1
GET https://api.piloterr.com/v2/ovoko/search?query=https://rrr.lt/en/search?q=filter
| Parámetro |
Tipo |
Requerido |
Descripción |
query |
string |
sí |
URL de búsqueda Ovoko completa |
| Mercado |
Host |
Ruta de búsqueda |
Ruta de producto |
| Francia |
ovoko.fr |
/chercher |
/les-pieces/ |
| Polonia |
ovoko.pl |
/szukaj |
/czesci-samochodowe/ |
| Alemania |
ovoko.de |
/suche |
/gebrauchte-ersatzteile/ |
| España |
ovoko.es |
/buscar |
/parte/ |
| Italia |
ovoko.it |
/ricerca |
/parte/ |
| Finlandia |
ovoko.fi |
/haku |
/osat/ |
| Rumanía |
ovoko.ro |
/cautare |
/piesa-uzata/ |
| Lituania |
rrr.lt |
/paieska |
/autodalis/ |
| Reino Unido |
rrr.lt |
/en/search |
/en/used-part/ |
| Letonia |
rrr.lt |
/lv/meklesana |
/lv/auto-dalas/ |
| Rusia |
rrr.lt |
/ru/poisk |
/ru/zapchasti/ |
También aceptados: www.ovoko.fr, ovoko.lt, ovoko.lv. Rechazados: about.ovoko.com, ovoko.pt, ovoko.ee, catálogos y ofertas.
| Campo |
Tipo |
Descripción |
results[].id |
string |
SKU en minúsculas, idéntico a Ad id / sku |
results[].url |
string |
URL absoluta (pasar a Ovoko Ad) |
results[].title |
string |
Título |
results[].price |
number |
Float. Moneda en currency |
results[].part_number |
string | null |
Primer código OEM con un dígito |
results[].vehicle |
string |
Texto del vehículo sin prefijo local |
pagination.next |
string | null |
URL de la página siguiente |
- Paginar con
&page=2 o ?page=2. Seguir pagination.next.
- Use cada
url con Ovoko Ad para el detalle.
| Código |
Cuándo |
400 |
Query vacía, host inválido, o URL de anuncio enviada a search |
404 |
Página no encontrada o sin tarjetas |
500 |
Fetch y parse fallidos |
- Comparar precios de piezas usadas en mercados Ovoko
- Recoger códigos OEM y URLs de anuncios
- Alimentar pipelines de compras paginados
