> ## Documentation Index
> Fetch the complete documentation index at: https://docs.scrapebadger.com/llms.txt
> Use this file to discover all available pages before exploring further.

# AutoScout24 Search and Listing API

> Search vehicles and retrieve full specifications, equipment, photos and public seller details across eight European markets.

Search current vehicle listings with prices, mileage, registration, seller and location data. Use your ScrapeBadger API key; you do not need an AutoScout24 account or upstream API subscription.

## Supported markets

| Market | Country | Domain | Language |
| - | - | - | - |
| de | Germany | autoscout24.de | German |
| at | Austria | autoscout24.at | German |
| be | Belgium | autoscout24.be | French |
| es | Spain | autoscout24.es | Spanish |
| fr | France | autoscout24.fr | French |
| it | Italy | autoscout24.it | Italian |
| lu | Luxembourg | autoscout24.lu | French |
| nl | Netherlands | autoscout24.nl | Dutch |

All prices are in EUR and mileage is in kilometres. Switzerland uses a separate platform and is not included.

## Endpoints and credits

| Endpoint | Credits |
| - | - |
| [Search vehicles](https://docs.scrapebadger.com/api-reference/endpoint/autoscout24/search.md) | 5 |
| [Full listing details](https://docs.scrapebadger.com/api-reference/endpoint/autoscout24/listing.md) | 10 |
| [Current filter options](https://docs.scrapebadger.com/api-reference/endpoint/autoscout24/filters.md) | 2 |
| [Supported markets](https://docs.scrapebadger.com/api-reference/endpoint/autoscout24/markets.md) | 0 |
| [Service health](https://docs.scrapebadger.com/api-reference/endpoint/autoscout24/health.md) | 0 |

Genuine empty searches and failed requests cost zero credits. Successful searches cost 5 credits. Use `X-Credits-Used` to check the actual charge. Your plan determines the currency price of credits; check [credits and pricing](https://docs.scrapebadger.com/credits-and-pricing.md).

## Quickstart

```bash theme={null}
curl 'https://scrapebadger.com/v1/autoscout24/search?market=de&make=volkswagen&model=golf&price_max=20000' \
  -H 'X-API-Key: YOUR_API_KEY'
```

```bash CLI theme={null}
scrapebadger autoscout24 search --market de --make volkswagen --model golf --price-max 20000
```

Hosted MCP tools: `autoscout24_search_vehicles`, `autoscout24_get_listing`, `autoscout24_list_filters`, `autoscout24_list_markets`.

## Pagination and data scope

Start with page 1 and follow `next_page`. Native pages normally contain 20 cards, but may contain fewer. Use `has_next_page` rather than the number of returned cards to decide whether to continue.

AutoScout24 caps browsing at 200 pages per query, even when `total_results` is larger than 4,000. Narrow your price, year, mileage, make/model or location filters to reach more inventory. Inventory changes between requests, so a page walk is not a snapshot.

Search returns cards and listing links. Pass a result URL or UUID to [full listing details](https://docs.scrapebadger.com/api-reference/endpoint/autoscout24/listing.md) for full native specifications, equipment, photo collection, pricing and public seller/contact/location information. Successful detail costs 10 credits; removed or missing listings return an unbilled 404. Registration has month precision (`YYYY-MM`); no day or UTC timestamp is invented. A field can be null when the source card does not disclose it.

## Run this asynchronously

Calls on this API can run in the background, so you don't hold a connection open while they work. Add one of these to the call:

| Add | What you get |
| - | - |
| `async=true` | The normal response if the call finishes within 25 s. Otherwise `202` with a `request_id`, which you poll at `GET /v1/requests/{request_id}` for free. |
| `callback_url=https://…` | `202` at once. When the call completes, the result is POSTed to your URL, signed with your webhook secret. |
| `Idempotency-Key: <your id>` header | A resent submit returns the first call instead of running it again. |

```bash theme={null}
curl -s "https://scrapebadger.com/v1/...?your=params&async=true" \
  -H "X-API-Key: $SCRAPEBADGER_API_KEY"
# 202 {"request_id": "…", "status": "running", …}, then:
curl -s "https://scrapebadger.com/v1/requests/REQUEST_ID" \
  -H "X-API-Key: $SCRAPEBADGER_API_KEY"
```

An async call is billed once, when it completes. See [Async requests and webhooks](https://docs.scrapebadger.com/long-running-requests.md) for webhooks, signatures and the SDK helpers.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.