# AutoScout24 Ad

## Overview

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

## Description

Extract full details from an AutoScout24 car listing, including price, vehicle specifications, seller info, and equipment.

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

## Example Response

### Lookup Peugeot 208 listing

```json
{
  "id": "51a0c24c-84e6-4ed8-af6b-1b8ef193ae84",
  "image": "https://prod.pictures.autoscout24.net/listing-images/51a0c24c-84e6-4ed8-af6b-1b8ef193ae84_8629ad36-57f4-4dc1-8df0-87ce4e18a34b.jpg/1280x960.webp",
  "price": {
    "price_formatted": "€ 6 490",
    "price_evaluation": 1
  },
  "images": [
    "https://prod.pictures.autoscout24.net/listing-images/51a0c24c-84e6-4ed8-af6b-1b8ef193ae84_8629ad36-57f4-4dc1-8df0-87ce4e18a34b.jpg/1280x960.webp",
    "https://prod.pictures.autoscout24.net/listing-images/51a0c24c-84e6-4ed8-af6b-1b8ef193ae84_2d74a74a-7f43-441e-8e1f-a3a4d3ff4ff8.jpg/1280x960.webp"
  ],
  "prices": {
    "dealer": {
      "price": "€ 6 490",
      "category": 1,
      "price_raw": 6490,
      "negotiable": false,
      "evaluation_ranges": [
        {
          "maximum": 5400,
          "minimum": null,
          "category": 0
        },
        {
          "maximum": 6700,
          "minimum": 5401,
          "category": 1
        },
        {
          "maximum": 7400,
          "minimum": 6701,
          "category": 2
        }
      ]
    }
  },
  "seller": {
    "name": "Seller Name",
    "type": "private",
    "phone": "+33600000000",
    "location": {
      "zip": "75001",
      "city": "Paris",
      "country": "FR"
    }
  },
  "vehicle": {
    "fuel": "Essence",
    "make": "Peugeot",
    "year": 2018,
    "color": "Blanc",
    "model": "208",
    "mileage": 85000,
    "power_kw": 60,
    "transmission": "Manuel",
    "engine_displacement": "1199 cm³"
  },
  "equipment": [
    "Air conditioning",
    "Bluetooth",
    "Parking sensors"
  ],
  "description": "Peugeot 208 PureTech 82ch S&S BVM5 Allure - 1ère main, distribution effectuée, carnet d'entretien complet."
}
```

## Documentation

## Overview
Extract comprehensive details from any AutoScout24 car listing. Returns price with market evaluation, vehicle specs, seller info, images, and equipment.

## Quickstart
```
GET https://api.piloterr.com/v2/autoscout24/ad?query=https://www.autoscout24.fr/offres/...
```

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

## Main use cases
- Enrich used car databases with live listing details
- Monitor competitor dealer listings for pricing analysis
- Build automotive price tracking tools
- Extract vehicle specs for comparison platforms