Ovoko Search
Search Ovoko and RRR.lt used auto parts by OEM number or keywords from a search URL: listing SKU, URL, price, currency, OEM codes, seller, vehicle and pagination.
Credit cost: 1 credit per call
ApiKeyAuthx-api-key<token>Your API key. Include it in the x-api-key header for every request.
query*stringFull Ovoko or RRR.lt search URL. Put the OEM number or keywords in q. A bare OEM number returns 400.
URL-encode this value (or send it in a POST JSON body). Unencoded, everything after the first & is dropped, so &exact=1 and &page=2 are ignored.
Search paths: ovoko.fr/chercher, ovoko.pl/szukaj, ovoko.de/suche, ovoko.es/buscar, ovoko.it/ricerca, ovoko.fi/haku, ovoko.ro/cautare, rrr.lt/paieska, rrr.lt/en/search, rrr.lt/lv/meklesana, rrr.lt/ru/poisk. ovoko.lt and ovoko.lv are read as rrr.lt.
Rejected: listing URLs, category pages (/en/parts-list/, /katalog-czesci/, /liste-des-pieces/), about.ovoko.com, ovoko.pt, ovoko.ee, ovoko.ua.
Examples:
https://rrr.lt/en/search?q=17427526824https://rrr.lt/en/search?q=17427526824&exact=1https://ovoko.pl/szukaj?q=Porsche+Macan+uszczelka+klapy+bagaznika&exact=1https://ovoko.fr/chercher?q=filtreFollow pagination.next (URL-encoded) until it is null. Pass each results[].url to Ovoko Ad.
fields?stringComma-separated list of response fields to return, with dot notation for nested fields (e.g. name,location.city).
is_async?booleanRun the request as a background job: the API answers 202 with a job_id to poll on GET /v1/jobs/{id}.
falsesoft_fail?booleanReturn HTTP 200 even when the request fails; the error is in the error field of the body.
falseSuccessful response
application/json- response
results?array<>pagination?curl -X GET 'https://api.piloterr.com/v2/ovoko/search?query=string'{ "results": [ { "id": "gak17092", "url": "https://rrr.lt/en/used-part/gak17092-17427526824-bmw-5-e60-e61-electric-radiator-cooling-fan", "image": "https://images.ovoko.com/br/fill/1024x768/gak/0/0/0/0/1/7/0/9/2/3f11f9f5c5469526f68144619d979079-bmw_5_e60_e61_electric_radiator_cooling_fan.jpg", "price": 271.81, "title": "Electric radiator cooling fan", "seller": { "name": "Example Motors" }, "vehicle": "BMW 5 E60 E61 2004 2171cm3 125kW Gasoline Automatic 113 680km", "currency": "EUR", "part_number": "17427526824", "part_numbers": [ "17427526824" ] }, { "id": "tpe867994", "url": "https://rrr.lt/en/used-part/tpe867994-17427526824-bmw-5-e60-e61-electric-radiator-cooling-fan", "image": "https://images.ovoko.com/bl/fill/1024x768/tpe/0/0/0/8/6/7/9/9/4/839dae02a870c819a770241a0b2ef1b2-bmw_5_e60_e61_electric_radiator_cooling_fan.jpg", "price": 156.2, "title": "Electric radiator cooling fan", "seller": { "name": "Example Motors" }, "vehicle": "BMW 5 E60 E61 2005 2979cm3 170kW Gasoline Manual", "currency": "EUR", "part_number": "17427526824", "part_numbers": [ "17427526824", "B1765BEHR" ] } ], "pagination": { "next": "https://rrr.lt/en/search?q=17427526824&page=2", "page": 1, "per_page": 15, "total_pages": 3, "total_results": 42 }}