# Autodoc Search

## Overview

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

## Description

Search Autodoc by URL: keyword pages use `/search?keyword=…` (e.g. `frein` on auto-doc.fr). Extract product cards, prices, and pagination.

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

## Example Response

### Search frein on auto-doc.fr

```json
{
  "results": [
    {
      "name": "RIDEX Étrier de frein Essieu avant gauche, Essieu avant, Fonte, 162 mm, sans fixation",
      "price": 42.99,
      "seller": "AUTODOC",
      "brand_no": "100015",
      "discount": 42,
      "360_photo": "https://media.autodoc.de/360_photos/8381120",
      "reference": "78B0410",
      "seller_id": 485,
      "product_id": "8381120",
      "product_url": "https://www.auto-doc.fr/ridex/8381120",
      "availability": "En stock",
      "generic_name": "Étrier de frein",
      "product_image": "https://media.autodoc.de/360_photos/8381120/preview.jpg",
      "reviews_count": 10,
      "original_price": 74.2
    },
    {
      "name": "RIDEX Étrier de frein Essieu avant gauche, Essieu avant, Fonte grise, 134 mm, sans fixation",
      "price": 36.99,
      "seller": "AUTODOC",
      "brand_no": "100015",
      "discount": 47,
      "360_photo": "https://media.autodoc.de/360_photos/8099284",
      "reference": "78B0328",
      "seller_id": 485,
      "product_id": "8099284",
      "product_url": "https://www.auto-doc.fr/ridex/8099284",
      "availability": "En stock",
      "generic_name": "Étrier de frein",
      "product_image": "https://media.autodoc.de/360_photos/8099284/preview.jpg",
      "reviews_count": 18,
      "original_price": 70.3
    },
    {
      "name": "RIDEX PLUS Étrier de frein Essieu arrière gauche, Essieu arrière, Aluminium, 118 mm, sans fixation",
      "price": 59.99,
      "seller": "AUTODOC",
      "brand_no": "100762",
      "discount": null,
      "360_photo": "https://media.autodoc.de/360_photos/22255932",
      "reference": "78B0093P",
      "seller_id": 485,
      "product_id": "22255932",
      "product_url": "https://www.auto-doc.fr/ridex-plus/22255932",
      "availability": "En stock",
      "generic_name": "Étrier de frein",
      "product_image": "https://media.autodoc.de/360_photos/22255932/preview.jpg",
      "reviews_count": 0,
      "original_price": null
    },
    {
      "name": "RIDEX Étrier de frein Essieu arrière gauche, Essieu arrière, Aluminium, 50 mm, 127 mm, sans fixation",
      "price": 51.49,
      "seller": "AUTODOC",
      "brand_no": "100015",
      "discount": 57,
      "360_photo": "https://media.autodoc.de/360_photos/8099740",
      "reference": "78B0194",
      "seller_id": 485,
      "product_id": "8099740",
      "product_url": "https://www.auto-doc.fr/ridex/8099740",
      "availability": "En stock",
      "generic_name": "Étrier de frein",
      "product_image": "https://media.autodoc.de/360_photos/8099740/preview.jpg",
      "reviews_count": 20,
      "original_price": 121.7
    }
  ],
  "pagination": {
    "next": 2,
    "current": 1,
    "other_pages": [
      2,
      3,
      4,
      5
    ],
    "has_next_page": true
  }
}
```

## Documentation

## Overview
Search and extract product listings from Autodoc, one of Europe's largest online automotive parts marketplaces. Keyword search pages use **`/search?keyword=…`**. Pass a full URL, or a path plus `domain`. The French shop is **`auto-doc.fr`**, not `autodoc.fr`.

## Allowed shop hosts (`domain`)
When `query` is **not** an absolute URL, pass `domain` as one of these hostnames (exact string, no scheme, no `www.`):

```
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
```

Do **not** pass only a country TLD like `fr` or `de`, use the full hostname (e.g. `auto-doc.fr`).

## Quickstart
**Full URL (recommended):**
```
GET https://api.piloterr.com/v2/autodoc/search?query=https%3A%2F%2Fwww.auto-doc.fr%2Fsearch%3Fkeyword%3Dfrein
GET https://api.piloterr.com/v2/autodoc/search?query=https%3A%2F%2Fwww.autodoc.de%2Fsearch%3Fkeyword%3Dbremsen
```

**Path + `domain`:**
```
GET https://api.piloterr.com/v2/autodoc/search?query=search%3Fkeyword%3Dfrein&domain=auto-doc.fr
```

## Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| `query` | string | yes | Full search/listing URL **or** path only (e.g. `search?keyword=frein`) when `domain` is set |
| `domain` | string | no | Allowed shop hostname from the list above; default `autodoc.de` when omitted. Ignored if `query` is already an absolute URL |

## Response fields
| Field | Type | Description |
|---|---|---|
| `results` | array | List of matching products |
| `results[].name` | string | Full product name including technical details |
| `results[].price` | number | Current discounted price |
| `results[].original_price` | number \| null | Original price before discount |
| `results[].discount` | integer \| null | Discount percentage applied |
| `results[].seller` | string | Seller name |
| `results[].seller_id` | integer | Internal seller identifier |
| `results[].brand_no` | string | Brand identifier |
| `results[].reference` | string | Manufacturer part reference number |
| `results[].product_id` | string | Internal Autodoc product identifier |
| `results[].product_url` | string | URL of the product detail page |
| `results[].product_image` | string | URL of the product image |
| `results[].360_photo` | string \| null | URL of the 360° photo viewer |
| `results[].availability` | string | Stock availability status |
| `results[].generic_name` | string | Generic category name of the part |
| `results[].reviews_count` | integer | Number of customer reviews |
| `pagination.current` | integer | Current page number |
| `pagination.next` | integer \| null | Next page number |
| `pagination.other_pages` | array | List of available page numbers |
| `pagination.has_next_page` | boolean | Whether additional pages of results exist |

## Notes
- Use meaningful keywords (e.g. `frein` on `auto-doc.fr`), not overly short tokens.
- Results are paginated: use `pagination.next` and rebuild the URL for the next page.
- The `360_photo` field is `null` when no 360° imagery is available.

## Main use cases
- Search and compare automotive parts across Autodoc's catalog by keyword or category
- Monitor price and discount trends for part categories
- Build price comparison or feed tools using live listing data