# Autodoc Product

## Overview

| Property | Value |
|----------|-------|
| **Status** | active |
| **Method** | `GET` |
| **Endpoint** | `/v2/autodoc/product` |
| **Base URL** | `https://api.piloterr.com` |
| **Credit Cost** | 2 credits per call |
| **Documentation** | https://www.piloterr.com/library/autodoc-product |

## Description

Scrape Autodoc product pages: price, specs, EAN, images, compatibility, and TecDoc-related vehicle data via the Related endpoint.

## 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/autodoc/product' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY'
```

## Example Response

### Brake disc RIDEX 82B0696 (auto-doc.fr)

```json
{
  "ean": "4059191318797",
  "name": "RIDEX 82B0696 Disque de freinEssieu avant, 238x8mm, 4/6x100, Plein, Fonte",
  "price": 13.99,
  "images": [
    "https://media.autodoc.de/360_photos/7999541/preview.jpg",
    "https://cdn.autodoc.de/thumb?id=7999541&m=1&n=0&lng=fr&rev=94078030"
  ],
  "rating": 8,
  "seller": "AUTODOC",
  "brand_no": 100015,
  "currency": "EUR",
  "features": [
    "Disques de frein standard conditionnés dans un emballage huilé",
    "Matériel : fonte GG20",
    "Qualité élevée constante",
    "Installation facile",
    "Compatibilité parfaite avec les composants du système de freinage RIDEX"
  ],
  "subtitle": "Essieu avant, 238x8mm, 4/6x100, Plein, Fonte",
  "reference": "82B0696",
  "seller_id": 485,
  "generic_id": 82,
  "product_id": 7999541,
  "breadcrumbs": [
    {
      "url": "https://www.auto-doc.fr/#parts",
      "name": "Pièces auto magasin en ligne"
    },
    {
      "url": "https://www.auto-doc.fr/pieces-detachees",
      "name": "Catalogue de pièces"
    },
    {
      "url": "https://www.auto-doc.fr/pieces-detachees/freinage",
      "name": "Frein"
    },
    {
      "url": "https://www.auto-doc.fr/pieces-detachees/disque-de-frein-10132",
      "name": "Disque de frein"
    },
    {
      "url": null,
      "name": "RIDEX Disque de frein"
    }
  ],
  "oem_numbers": [
    {
      "url": "https://www.auto-doc.fr/pieces-detachees/oem/7701204285",
      "label": "OE 77 01 204 285. RENAULT"
    },
    {
      "url": "https://www.auto-doc.fr/pieces-detachees/oem/7700716947",
      "label": "OE 77 00 716 947. RENAULT"
    },
    {
      "url": "https://www.auto-doc.fr/pieces-detachees/oem/7701716947",
      "label": "OE 77 01 716 947. RENAULT"
    }
  ],
  "product_url": "https://www.auto-doc.fr/ridex/7999541",
  "seo_summary": {
    "moteurs": "1.2; 1.2 16V; 1.1; 1.9 D; 1.4; 1.0; 1.6 D",
    "modeles_de_voitures": "Renault Twingo 1; Clio 1; Renault Supercinq; R5 3/5 portes; Renault Rapid Van; Renault Twingo 1 Van; Renault Clio Van s57; Super 5 Van (s40)",
    "annees_de_fabrication": "1980-2007",
    "numero(s)_de_piece_oe": "77 01 204 285, 77 00 716 947, 77 01 716 947",
    "puissance_(kilowatts)": "27-52 kW",
    "numero_d_article_du_fabricant": "82B0696",
    "puissance_du_moteur_(chevaux)": "37-71 CV"
  },
  "availability": "En stock",
  "generic_name": "Disque de frein",
  "goods_ending": 392,
  "compatibility": {
    "cars": [
      {
        "fetch": {
          "path": "/v2/autodoc/product/related",
          "params": {
            "query": "https://www.auto-doc.fr/ridex/7999541",
            "maker_id": 93,
            "maker_name": "RENAULT",
            "product_id": 7999541,
            "vehicle_type": "pkw"
          }
        },
        "maker": "RENAULT",
        "maker_id": 93,
        "vehicle_type": "pkw"
      }
    ],
    "trucks": []
  },
  "has_360_photo": true,
  "reviews_count": 28,
  "specifications": {
    "etat": "Neuf",
    "hauteur": "41",
    "perfore": "non",
    "surface": "nu / non protégé / non plastifié",
    "diametre": "238",
    "materiel": "Fonte",
    "fabricant": "RIDEX",
    "traitement": "non-traité",
    "numero_de_ean": "4059191318797",
    "nombre_de_trous": "4 / 6",
    "numero_d_article": "82B0696",
    "annee_a_partir_de": "Cette caractéristique varie en fonction du modèle de voiture.",
    "cote_d_assemblage": "Essieu avant",
    "cercle_de_percage_ø": "100",
    "diametre_du_centrage": "61,1",
    "type_de_disque_de_frein": "Plein",
    "epaisseur_du_disque_de_frein": "8",
    "diametre_d_alesage_du_boulon_de_roue": "13",
    "article_complementaire_info_complementaire_2": "sans vis / boulons"
  },
  "rating_percentage": 80,
  "discount_percentage": 55
}
```

## Documentation

## Overview
Extract comprehensive product data from Autodoc, one of Europe's largest online automotive parts marketplaces. Given a product URL, the API returns pricing, technical specifications, stock availability, ratings, images, seller information, compatibility makers, and more.

## Allowed product hosts (`query`)
The `query` parameter must be a full `https://` URL to a **product** page. The hostname must belong to a supported Autodoc regional shop:

```
autodoc.de
```

```
auto-doc.ch
```

```
autodoc24.ch
```

```
auto-doc.at
```

```
autodoc.lu
```

```
autodoc.bg
```

```
autodoc.be
```

```
auto-doc.be
```

```
autodoc.cz
```

```
autodoc.dk
```

```
autodoc.ee
```

```
autodoc.es
```

```
autodoc.fi
```

```
auto-doc.fr
```

```
autodoc24.fr
```

```
autodoc.co.uk
```

```
autodoc.gr
```

```
autodoc.hu
```

```
auto-doc.ie
```

```
auto-doc.it
```

```
autodoc24.it
```

```
autodoc.lt
```

```
autodoc.lv
```

```
autodoc.nl
```

```
autodoc24.nl
```

```
autodoc.co.no
```

```
autodoc.pl
```

```
auto-doc.pt
```

```
autodoc24.ro
```

```
autodoc.se
```

```
autodoc.si
```

```
autodoc.sk
```

```
autodoc.parts
```

Use the exact hostname your users see (e.g. `www.auto-doc.fr`). France uses **`auto-doc.fr`**, not `autodoc.fr`.

## Quickstart
```
GET https://api.piloterr.com/v2/autodoc/product?query=https%3A%2F%2Fwww.auto-doc.fr%2Fridex%2F7999541
```

## Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| `query` | string | yes | Full HTTPS URL of the Autodoc product page |

## Response fields
| Field | Type | Description |
|---|---|---|
| `product_url` | string | Canonical product page URL |
| `product_id` | integer | Internal Autodoc product identifier |
| `ean` | string | European Article Number (barcode) |
| `name` | string | Full product name including part reference |
| `subtitle` | string | Product subtitle with technical summary |
| `price` | number | Product price |
| `currency` | string | Shop currency code |
| `discount_percentage` | number | Applied discount percentage |
| `images` | array | Product image URLs (including 360° when available) |
| `rating` | number | Rating score out of 10 |
| `rating_percentage` | number | Rating expressed as a percentage |
| `seller` | string | Seller name |
| `seller_id` | integer | Internal seller identifier |
| `brand_no` | integer | Brand identifier |
| `reference` | string | Manufacturer part reference number |
| `availability` | string | Stock availability status |
| `has_360_photo` | boolean | Whether a 360° photo is available |
| `reviews_count` | integer | Number of customer reviews |
| `generic_name` | string | Generic part category name |
| `generic_id` | integer | Generic category id |
| `goods_ending` | integer | Internal catalog hint |
| `features` | array | Product features and descriptions |
| `specifications` | object | Technical specifications (locale-dependent keys) |
| `breadcrumbs` | array | Navigation trail `{ name, url }` |
| `oem_numbers` | array | OE cross-references `{ label, url }` |
| `seo_summary` | object | SEO table key-value (locale-dependent keys) |
| `compatibility` | object | `cars` / `trucks` maker rows with `fetch.params` for Related |

## Notes
- **`compatibility`**: lists makers per vehicle type. Each row includes a `fetch` object whose `params` are the **required** inputs for **`/v2/autodoc/product/related`**.
- The `specifications` object keys vary by product type and language.

## Main use cases
- Monitor and compare pricing of automotive parts across Autodoc's catalog
- Enrich product databases with specifications, EAN codes, and manufacturer references
- Track stock availability and discounts
- Feed compatibility workflows (Product → Related) for TecDoc-style vehicle lines