Piloterr

Ovoko Search

Search for auto parts on Ovoko by URL, returning paginated listings with part details, pricing, seller rating, and stock availability.

Credit cost: 1 credit per call

GET
/v2/ovoko/search

Authorization

ApiKeyAuth
x-api-key<token>

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

In: header

Query Parameters

query*string

Full Ovoko search or category URL for auto parts.

Supported domains: ovoko.fr, ovoko.de, ovoko.es, ovoko.it, ovoko.pl, ovoko.pt, ovoko.ro, ovoko.lt, ovoko.lv, ovoko.ee

Example (keyword search):

https://www.ovoko.fr/fr/recherche?q=filtre+huile

Example (category browse):

https://www.ovoko.fr/fr/categorie/filtration/filtres-a-huile

Note: Pagination can be added by appending ?page=2 to the URL.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://api.piloterr.com/v2/ovoko/search?query=string"
{
  "total": 1842,
  "page": 1,
  "results": [
    {
      "id": "128549",
      "title": "Filtre à huile MANN FILTER W719/30",
      "url": "https://www.ovoko.fr/fr/annonce/filtre-a-huile-mann-filter-w71930-128549",
      "price": {
        "amount": 7.99,
        "currency": "EUR",
        "formatted": "7,99 €"
      },
      "part": {
        "brand": "MANN FILTER",
        "reference": "W719/30",
        "condition": "new"
      },
      "seller": {
        "name": "AutoPieces Express",
        "type": "professional",
        "rating": 4.7
      },
      "stock": {
        "available": true,
        "delivery_days": 2
      },
      "image": "https://cdn.ovoko.fr/images/w71930_thumb.jpg"
    },
    {
      "id": "209341",
      "title": "Filtre à huile BOSCH 0 451 103 370",
      "url": "https://www.ovoko.fr/fr/annonce/filtre-a-huile-bosch-0451103370-209341",
      "price": {
        "amount": 9.49,
        "currency": "EUR",
        "formatted": "9,49 €"
      },
      "part": {
        "brand": "BOSCH",
        "reference": "0 451 103 370",
        "condition": "new"
      },
      "seller": {
        "name": "PiecesAutoFrance",
        "type": "professional",
        "rating": 4.5
      },
      "stock": {
        "available": true,
        "delivery_days": 1
      },
      "image": "https://cdn.ovoko.fr/images/bosch_0451_thumb.jpg"
    }
  ]
}
{
  "error": "Bad Request"
}
{
  "error": "Invalid API Key"
}
{
  "error": "Payment required"
}
{
  "error": "Rate limit exceeded for the API key: quota monthly"
}
{
  "error": "Internal Error"
}