# AutoScout24 Search

## Overview

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

## Description

Search for car listings on AutoScout24 by URL, returning paginated results with vehicle details, pricing, and seller info.

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

## Example Response

### Search VW Golf listings (France)

```json
{
  "results": [
    {
      "images": [
        "https://prod.pictures.autoscout24.net/listing-images/1ec155ad-ab25-46ba-aaa4-ae4831e3bfd7_be770320-3477-4b32-b7df-7b4f1533e9c4.png/250x188.webp"
      ],
      "seller": {
        "id": "60012384",
        "type": "Dealer",
        "phones": [
          {
            "call_to": "+33787186962",
            "phone_type": "Office"
          }
        ],
        "company_name": "PROVENCE CAR LA GARDE",
        "contact_name": "Mathias"
      },
      "ad_tier": "T30",
      "vehicle": {
        "fuel": "Essence",
        "make": "Volkswagen",
        "type": "Car",
        "model": "Golf",
        "variant": "R",
        "transmission": "Boîte automatique",
        "mileage_in_km": "199 000 km",
        "model_version_input": "2.0 TSI 310CH BLUEMOTION TECHNOLOGY R 4MOTION DSG7 5P",
        "engine_displacement_in_c_c_m": "1 984 cm³"
      },
      "location": {
        "zip": "83130",
        "city": "La Garde",
        "country_code": "FR"
      },
      "tracking": {
        "price": "17990",
        "mileage": "199000",
        "fuel_type": "b",
        "price_label": "good-price",
        "first_registration": "04-2017"
      },
      "available_now": true,
      "vehicle_details": {
        "gearbox": "Boîte automatique",
        "calendar": "04/2017",
        "speedometer": "231 kW (314 Ch)",
        "mileage_odometer": "199 000 km"
      }
    }
  ],
  "pagination": {
    "next": 2,
    "current": 1,
    "total_pages": 70,
    "has_next_page": true,
    "total_results": 1382
  }
}
```

## Documentation

## Overview
Extract car listings from any AutoScout24 search page across all European domains. Returns paginated results with vehicle specs, pricing, seller info, and images.

## Quickstart
```
GET https://api.piloterr.com/v2/autoscout24/search?query=https://www.autoscout24.fr/lst/volkswagen/golf?atype=C
```

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

## Main use cases
- Aggregate listings for market price benchmarking
- Monitor dealer inventory for competitive intelligence
- Build lead generation pipelines from listing searches
- Power automotive price indexes by collecting listings