# Ovoko Ad

## Overview

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

## Description

Extract full details from an Ovoko auto parts listing including price, part info, seller data, compatibility list, 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/ad' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY'
```

## Example Response

### Lookup Mann Filter W719/30 oil filter listing

```json
{
  "id": "128549",
  "url": "https://www.ovoko.fr/fr/annonce/filtre-a-huile-mann-filter-w71930-128549",
  "part": {
    "ean": "4011558744504",
    "brand": "MANN FILTER",
    "category": "Filtration",
    "condition": "new",
    "reference": "W719/30",
    "weight_kg": 0.14,
    "compatibility": [
      "Renault Clio II",
      "Renault Megane I",
      "Peugeot 106",
      "Peugeot 206",
      "Citroën Saxo"
    ],
    "dimensions_mm": {
      "width": 75,
      "height": 67,
      "length": 75
    }
  },
  "price": {
    "amount": 7.99,
    "currency": "EUR",
    "formatted": "7,99 €"
  },
  "stock": {
    "quantity": 50,
    "available": true,
    "delivery_days": 2
  },
  "title": "Filtre à huile MANN FILTER W719/30",
  "images": [
    "https://cdn.ovoko.fr/images/w71930_main.jpg",
    "https://cdn.ovoko.fr/images/w71930_side.jpg"
  ],
  "seller": {
    "id": "seller_fr_4521",
    "name": "AutoPieces Express",
    "type": "professional",
    "rating": 4.7,
    "location": {
      "city": "Metz",
      "country": "FR"
    },
    "reviews_count": 312
  },
  "description": "Filtre à huile d'origine MANN FILTER W719/30. Compatible avec de nombreux modèles Renault, Peugeot et Citroën. Garantie constructeur."
}
```

## Documentation

## Overview
Extract complete product data from any Ovoko auto parts listing. Returns price, part info, seller data, compatibility, stock availability, and images.

## Quickstart
```
GET https://api.piloterr.com/v2/ovoko/ad?query=https://www.ovoko.fr/fr/annonce/filtre-a-huile-mann-filter-w71930-128549
```

## Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| `query` | string | yes | Ovoko product listing URL |

## Main use cases
- Build auto parts price comparison tools
- Enrich maintenance platforms with parts pricing and availability
- Track competitor prices on specific part references
- Source data for marketplace aggregation systems