# Ovoko Search

## Overview

| Property | Value |
|----------|-------|
| **Status** | active |
| **Method** | `GET` |
| **Endpoint** | `/v2/ovoko/search` |
| **Base URL** | `https://api.piloterr.com` |
| **Credit Cost** | 1 credit per call |
| **Documentation** | https://www.piloterr.com/library/ovoko-search |

## Description

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

## Authentication

- **Key Name:** `x-api-key`
- **Location:** HTTP Header
- **Get an API key:** https://app.piloterr.com/register

## Example Request

```bash
curl --location --request GET 'https://api.piloterr.com/v2/ovoko/search' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY'
```

## Example Response

### Search for oil filters on Ovoko France

```json
{
  "page": 1,
  "total": 1842,
  "results": [
    {
      "id": "128549",
      "url": "https://www.ovoko.fr/fr/annonce/filtre-a-huile-mann-filter-w71930-128549",
      "part": {
        "brand": "MANN FILTER",
        "condition": "new",
        "reference": "W719/30"
      },
      "image": "https://cdn.ovoko.fr/images/w71930_thumb.jpg",
      "price": {
        "amount": 7.99,
        "currency": "EUR",
        "formatted": "7,99 €"
      },
      "stock": {
        "available": true,
        "delivery_days": 2
      },
      "title": "Filtre à huile MANN FILTER W719/30",
      "seller": {
        "name": "AutoPieces Express",
        "type": "professional",
        "rating": 4.7
      }
    },
    {
      "id": "209341",
      "url": "https://www.ovoko.fr/fr/annonce/filtre-a-huile-bosch-0451103370-209341",
      "part": {
        "brand": "BOSCH",
        "condition": "new",
        "reference": "0 451 103 370"
      },
      "image": "https://cdn.ovoko.fr/images/bosch_0451_thumb.jpg",
      "price": {
        "amount": 9.49,
        "currency": "EUR",
        "formatted": "9,49 €"
      },
      "stock": {
        "available": true,
        "delivery_days": 1
      },
      "title": "Filtre à huile BOSCH 0 451 103 370",
      "seller": {
        "name": "PiecesAutoFrance",
        "type": "professional",
        "rating": 4.5
      }
    }
  ]
}
```

## Documentation

## Overview
Extract auto parts search results from any Ovoko search or category URL. Returns paginated listings with part details, pricing, seller rating, and stock availability.

## Quickstart
```
GET https://api.piloterr.com/v2/ovoko/search?query=https://www.ovoko.fr/fr/recherche?q=filtre+huile
```

## Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| `query` | string | yes | Ovoko search or category URL |

## Main use cases
- Compare parts prices across Ovoko sellers
- Monitor stock availability for OEM/aftermarket parts
- Aggregate listings for price comparison engines
- Track new parts listings for procurement automation