Extrayez les annonces de pièces d'occasion depuis une page de recherche Ovoko. Retourne { results, pagination } avec les mêmes clés sur tous les marchés: SKU, titre, prix, devise, codes OEM, vendeur et texte véhicule.
Seules les pages search sont acceptées. Catégories, catalogues et pages offre retournent 400.
Cartes HTML, __NEXT_DATA__ et JSON XHR sont normalisés vers ce schéma. Le titre est toujours title (pas de champ 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://ovoko.es/buscar?q=filtro
| Paramètre |
Type |
Requis |
Description |
query |
string |
oui |
URL de recherche Ovoko complète |
| Marché |
Host |
Chemin search |
Chemin produit |
| France |
ovoko.fr |
/chercher |
/les-pieces/ |
| Pologne |
ovoko.pl |
/szukaj |
/czesci-samochodowe/ |
| Allemagne |
ovoko.de |
/suche |
/gebrauchte-ersatzteile/ |
| Espagne |
ovoko.es |
/buscar |
/parte/ |
| Italie |
ovoko.it |
/ricerca |
/parte/ |
| Finlande |
ovoko.fi |
/haku |
/osat/ |
| Roumanie |
ovoko.ro |
/cautare |
/piesa-uzata/ |
| Lituanie |
rrr.lt |
/paieska |
/autodalis/ |
| Royaume-Uni |
rrr.lt |
/en/search |
/en/used-part/ |
| Lettonie |
rrr.lt |
/lv/meklesana |
/lv/auto-dalas/ |
| Russie |
rrr.lt |
/ru/poisk |
/ru/zapchasti/ |
Aussi acceptés: www.ovoko.fr, ovoko.lt, ovoko.lv. Rejetés: about.ovoko.com, ovoko.pt, ovoko.ee, catalogues et offres.
| Champ |
Type |
Description |
results[].id |
string |
SKU listing en minuscules (qbb17557), identique à Ad id / sku |
results[].url |
string |
URL listing absolue (à passer à Ovoko Ad) |
results[].title |
string |
Titre |
results[].price |
number |
Float. Devise dans currency |
results[].part_number |
string | null |
Premier code OEM avec un chiffre |
results[].vehicle |
string |
Texte véhicule sans préfixe local |
pagination.next |
string | null |
URL page suivante |
- Paginer avec
&page=2 ou ?page=2. Suivre pagination.next.
- Utilisez chaque
url avec Ovoko Ad pour le détail.
| Code |
Quand |
400 |
Query vide, host invalide, ou URL listing envoyée à search |
404 |
Page introuvable ou sans cartes |
500 |
Fetch et parse en échec |
- Comparer les prix pièces d'occasion sur les marchés Ovoko
- Collecter codes OEM et URLs d'annonces
- Alimenter des pipelines d'achat paginés
