Extraia anúncios de peças usadas de uma página de pesquisa Ovoko. Devolve { results, pagination } com as mesmas chaves em todos os mercados: SKU, título, preço, moeda, códigos OEM, vendedor e texto do veículo.
Apenas páginas de pesquisa são aceites. Categorias, catálogos e ofertas devolvem 400.
Cartões HTML, __NEXT_DATA__ e JSON XHR são normalizados para este esquema. O título é sempre title (não há campo name).
GET https://api.piloterr.com/v2/ovoko/search?query=https://ovoko.fr/chercher?q=filtre
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 |
Obrigatório |
Descrição |
query |
string |
sim |
URL de pesquisa Ovoko completa |
| Mercado |
Host |
Caminho de pesquisa |
Caminho de produto |
| França |
ovoko.fr |
/chercher |
/les-pieces/ |
| Polónia |
ovoko.pl |
/szukaj |
/czesci-samochodowe/ |
| Alemanha |
ovoko.de |
/suche |
/gebrauchte-ersatzteile/ |
| Espanha |
ovoko.es |
/buscar |
/parte/ |
| Itália |
ovoko.it |
/ricerca |
/parte/ |
| Finlândia |
ovoko.fi |
/haku |
/osat/ |
| Roménia |
ovoko.ro |
/cautare |
/piesa-uzata/ |
| Lituânia |
rrr.lt |
/paieska |
/autodalis/ |
| Reino Unido |
rrr.lt |
/en/search |
/en/used-part/ |
| Letónia |
rrr.lt |
/lv/meklesana |
/lv/auto-dalas/ |
| Rússia |
rrr.lt |
/ru/poisk |
/ru/zapchasti/ |
Também aceites: www.ovoko.fr, ovoko.lt, ovoko.lv. Rejeitados: about.ovoko.com, ovoko.pt, ovoko.ee, catálogos e ofertas.
| Campo |
Tipo |
Descrição |
results[].id |
string |
SKU em minúsculas, idêntico a Ad id / sku |
results[].url |
string |
URL absoluta (passar a Ovoko Ad) |
results[].title |
string |
Título |
results[].price |
number |
Float. Moeda em currency |
results[].part_number |
string | null |
Primeiro código OEM com um dígito |
results[].vehicle |
string |
Texto do veículo sem prefixo local |
pagination.next |
string | null |
URL da página seguinte |
- Paginar com
&page=2 ou ?page=2. Seguir pagination.next.
- Use cada
url com Ovoko Ad para o detalhe.
| Código |
Quando |
400 |
Query vazia, host inválido, ou URL de anúncio enviada a search |
404 |
Página não encontrada ou sem cartões |
500 |
Fetch e parse falharam |
- Comparar preços de peças usadas nos mercados Ovoko
- Recolher códigos OEM e URLs de anúncios
- Alimentar pipelines de compras paginados