Piloterr

Ovoko Search

GET
/v2/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

Authorization

ApiKeyAuth
headerx-api-key<token>

Your API key. Include it in the x-api-key header for every request.

Query Parameters

query*string

Full 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=filtre

Follow pagination.next (URL-encoded) until it is null. Pass each results[].url to Ovoko Ad.

fields?string

Comma-separated list of response fields to return, with dot notation for nested fields (e.g. name,location.city).

is_async?boolean

Run the request as a background job: the API answers 202 with a job_id to poll on GET /v1/jobs/{id}.

Defaultfalse
soft_fail?boolean

Return HTTP 200 even when the request fails; the error is in the error field of the body.

Defaultfalse

Response Body

Successful response

application/json
  1. response
results?array<>
pagination?
Example Request
curl -X GET 'https://api.piloterr.com/v2/ovoko/search?query=string'
Example Response
{  "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  }}