Classifieds & Second-hand

AutoScout24 API API

The AutoScout24 API returns used- and new-car listings from one of Europe's largest car marketplaces as clean JSON.

7 actionsLive JSON1,000 free creditsMCP-ready

🤖 Using an AI assistant? Copy this link into ChatGPT / Claude / Cursor — it reads every endpoint and parameter instantly and tells you if this API fits your use case.

The primary search endpoint returns listings with a price evaluation and super-deal flag per card, plus pagination, and you can pull a listing, the makes and models tree, filter_options, a seller's listings and browse links. It is built for automotive pricing, dealer tools and market analytics that need AutoScout24 data without a scraper. One ReefAPI key, one shared credit pool, the standard envelope.

Live example

Real request and response JSON

Captured from the indexed primary action, search, on Jul 18, 2026, 5:19 PM UTC.

Captured request

{
  "method": "POST",
  "url": "https://api.reefapi.com/autoscout24/v1/search",
  "headers": {
    "x-api-key": "$REEF_KEY",
    "content-type": "application/json"
  },
  "body": {
    "make": "bmw",
    "country": "de"
  }
}

Captured response

{
  "ok": true,
  "meta": {
    "api": "autoscout24",
    "endpoint": "search",
    "mode": "live",
    "latency_ms": 3792.2,
    "record_count": 20,
    "bytes": 860037,
    "cache_hit": false,
    "method": "next_data_embedded_json",
    "country": "de",
    "url": "https://www.autoscout24.de/lst/bmw",
    "http_status": 200,
    "content_type": "text/html; charset=utf-8",
    "page": 1,
    "total": 61918,
    "total_pages": 200,
    "has_more": true,
    "next_page": 2
  },
  "data": {
    "listings": [
      {
        "id": "22360042-dada-4c15-be87-20103d6f203f",
        "url": "https://www.autoscout24.de/angebote/bmw-m2-m2-benzin-blau-cat_ma13mo[redacted-phone]-dada-4c15-be87-20103d6f203f",
        "path": "/angebote/bmw-m2-m2-benzin-blau-cat_ma13mo[redacted-phone]-dada-4c15-be87-20103d6f203f",
        "make": "BMW",
        "model": "M2",
        "model_group": "M2",
        "variant": null,
        "model_version": "M2",
        "offer_type": "U",
        "fuel": "Benzin",
        "transmission": "Automatik",
        "mileage_km": "31.894 km",
        "engine_ccm": "2.993 cm³",
        "price_formatted": "€ 34.000",
        "price_evaluation": 0,
        "price_evaluation_enabled": true,
        "super_deal": {
          "oldPriceFormatted": "",
          "isEligible": false
        },
        "is_super_deal_eligible": false,
        "old_price_formatted": "",
        "location": {
          "countryCode": "DE",
          "zip": "93055",
          "city": "Regensburg",
          "street": "Landauer Str. 3"
        },
        "seller": {
          "dealer": {
            "maxImages": "[trimmed-depth]",
            "isFreespeeCallTrackingEnabled": "[trimmed-depth]",
            "culture": "[trimmed-depth]"
          },
          "id": "47229209",
          "type": "Dealer",
          "logo": {
            "small": "[trimmed-depth]"
          },
          "companyName": "carpoint regensburg u G",
          "contactName": "[redacted-name]",
          "links": {
            "infoPage": "[trimmed-depth]",
            "imprint": "[trimmed-depth]"
          }
        },
        "images": [
          "https://prod.pictures.autoscout24.net/listing-images/22360042-dada-4c15-be87-20103d6f203f_03b0aac1-8b2e-[redacted-phone]be908c2.jpg/250x188.webp",
          "https://prod.pictures.autoscout24.net/listing-images/22360042-dada-4c15-be87-20103d6f203f_d3c6d156-d610-4fa6-981e-3baaff7cf1b9.jpg/250x188.webp",
          "https://prod.pictures.autoscout24.net/listing-images/22360042-dada-4c15-be87-20103d6f203f_3f9eea35-274f-40cd-a6ca-6167be9c5119.jpg/250x188.webp"
        ],
        "statistics": {
          "leadsRange": "Some"
        },
        "first_registration": "01-2023",
        "vehicle_details": [
          {
            "data": "[trimmed-depth]",
            "iconName": "[trimmed-depth]",
            "ariaLabel": "[trimmed-depth]"
          },
          {
            "data": "[trimmed-depth]",
            "iconName": "[trimmed-depth]",
            "ariaLabel": "[trimmed-depth]"
          },
          {
            "data": "[trimmed-depth]",
            "iconName": "[trimmed-depth]",
            "ariaLabel": "[trimmed-depth]"
          }
        ],
        "is_trending": false,
        "search_result_type": "Nfm"
      },
      {
        "id": "fe33df44-628f-421d-946d-3f804b18fa71",
        "url": "https://www.autoscout24.de/angebote/bmw-x1-xdrive20i-ahk-sport-line-driv-ass-benzin-weiss-cat_ma13mo19242-fe33df44-628f-421d-946d-3f804b18fa71",
        "path": "/angebote/bmw-x1-xdrive20i-ahk-sport-line-driv-ass-benzin-weiss-cat_ma13mo19242-fe33df44-628f-421d-946d-3f804b18fa71",
        "make": "BMW",
        "model": "X1",
        "model_group": "X1",
        "variant": null,
        "model_version": "xDrive20i | AHK | Sport-Line | Driv.Ass. |",
        "offer_type": "U",
        "fuel": "Benzin",
        "transmission": "Automatik",
        "mileage_km": "108.600 km",
        "engine_ccm": "1.998 cm³",
        "price_formatted": "€ 23.690",
        "price_evaluation": 2,
        "price_evaluation_enabled": true,
        "super_deal": {
          "oldPriceFormatted": "",
          "isEligible": false
        },
        "is_super_deal_eligible": false,
        "old_price_formatted": "",
        "location": {
          "countryCode": "DE",
          "zip": "97616",
          "city": "Bad Neustadt / Saale",
          "street": "Industriestraße 10"
        },
        "seller": {
          "dealer": {
            "maxImages": "[trimmed-depth]",
            "isFreespeeCallTrackingEnabled": "[trimmed-depth]",
            "culture": "[trimmed-depth]"
          },
          "id": "23566803",
          "type": "Dealer",
          "logo": {
            "small": "[trimmed-depth]"
          },
          "companyName": "Seifert Automobile GmbH",
          "contactName": "[redacted-name]",
          "links": {
            "infoPage": "[trimmed-depth]",
            "imprint": "[trimmed-depth]"
          }
        },
        "images": [
          "https://prod.pictures.autoscout24.net/listing-images/fe33df44-628f-421d-946d-3f804b18fa71_7098e949-78c7-4339-a2ab-b9bbf82af8a5.jpg/250x188.webp",
          "https://prod.pictures.autoscout24.net/listing-images/fe33df44-628f-421d-946d-3f804b18fa71_87bf[redacted-phone]e86-9a31-b8db3d59c65a.jpg/250x188.webp",
          "https://prod.pictures.autoscout24.net/listing-images/fe33df44-628f-421d-946d-3f804b18fa71_4f[redacted-phone]a64-b669-01abd8a8caef.jpg/250x188.webp"
        ],
        "statistics": {
          "leadsRange": "Some"
        },
        "first_registration": "08-2021",
        "vehicle_details": [
          {
            "data": "[trimmed-depth]",
            "iconName": "[trimmed-depth]",
            "ariaLabel": "[trimmed-depth]"
          },
          {
            "data": "[trimmed-depth]",
            "iconName": "[trimmed-depth]",
            "ariaLabel": "[trimmed-depth]"
          },
          {
            "data": "[trimmed-depth]",
            "iconName": "[trimmed-depth]",
            "ariaLabel": "[trimmed-depth]"
          }
        ],
        "is_trending": null,
        "search_result_type": "Organic"
      },
      {
        "id": "0d69d7a1-4aaf-48b4-88bd-8fc8df232b49",
        "url": "https://www.autoscout24.de/angebote/bmw-x1-sdrive18i-advantage-ahk-abnehmbar-navi-led-el-hec-benzin-orange-cat_ma13mo19242-0d69d7a1-4aaf-48b4-88bd-8fc8df232b49",
        "path": "/angebote/bmw-x1-sdrive18i-advantage-ahk-abnehmbar-navi-led-el-hec-benzin-orange-cat_ma13mo19242-0d69d7a1-4aaf-48b4-88bd-8fc8df232b49",
        "make": "BMW",
        "model": "X1",
        "model_group": "X1",
        "variant": null,
        "model_version": "sDrive18i Advantage AHK-abnehmbar Navi LED El. Hec",
        "offer_type": "U",
        "fuel": "Benzin",
        "transmission": "Automatik",
        "mileage_km": "42.018 km",
        "engine_ccm": "1.499 cm³",
        "price_formatted": "€ 21.425",
        "price_evaluation": 3,
        "price_evaluation_enabled": true,
        "super_deal": {
          "oldPriceFormatted": "",
          "isEligible": false
        },
        "is_super_deal_eligible": false,
        "old_price_formatted": "",
        "location": {
          "countryCode": "DE",
          "zip": "16515",
          "city": "Oranienburg",
          "street": "Am Heidering 27"
        },
        "seller": {
          "dealer": {
            "maxImages": "[trimmed-depth]",
            "hasDealerInformationOnResultList": "[trimmed-depth]",
            "isFreespeeCallTrackingEnabled": "[trimmed-depth]",
            "culture": "[trimmed-depth]"
          },
          "id": "22193235",
          "type": "Dealer",
          "logo": {
            "small": "[trimmed-depth]"
          },
          "companyName": "Zemke Autohaus Bernau GmbH",
          "contactName": "[redacted-name]",
          "links": {
            "infoPage": "[trimmed-depth]",
            "imprint": "[trimmed-depth]"
          }
        },
        "images": [
          "https://prod.pictures.autoscout24.net/listing-images/0d69d7a1-4aaf-48b4-88bd-8fc8df232b49_bbd60972-de9e-4051-8daa-3cb4f7d3adbd.jpg/250x188.webp",
          "https://prod.pictures.autoscout24.net/listing-images/0d69d7a1-4aaf-48b4-88bd-8fc8df232b49_b5dd90fc-bd0e-475b-92ce-b85199fbcb05.jpg/250x188.webp",
          "https://prod.pictures.autoscout24.net/listing-images/0d69d7a1-4aaf-48b4-88bd-8fc8df232b49_60c0fbba-cdcf-49e6-9a61-0e79b9f8911f.jpg/250x188.webp"
        ],
        "statistics": {
          "leadsRange": "Some"
        },
        "first_registration": "06-2019",
        "vehicle_details": [
          {
            "data": "[trimmed-depth]",
            "iconName": "[trimmed-depth]",
            "ariaLabel": "[trimmed-depth]"
          },
          {
            "data": "[trimmed-depth]",
            "iconName": "[trimmed-depth]",
            "ariaLabel": "[trimmed-depth]"
          },
          {
            "data": "[trimmed-depth]",
            "iconName": "[trimmed-depth]",
            "ariaLabel": "[trimmed-depth]"
          }
        ],
        "is_trending": null,
        "search_result_type": "Organic"
      }
    ],
    "page": 1,
    "total": 61918,
    "total_pages": 200,
    "has_more": true,
    "next_page": 2
  }
}

Actions

What the AutoScout24 API API does

Action	Description	Concrete use case	Key params
search	Paginated car search by make (+ model/filters) across EU TLDs; deal signals priceEvaluation+superDeal	Ops teams call search to get paginated car search by make (+ model/filters) across EU TLDs; deal signals priceEvaluation+s….	make, model, model_group, country, page, ...
listing	Full listing detail by url/path or id (description, prices, vehicle, images, seller, leasing, warranty)	Developer tools call listing to get full listing detail by url/path or id (description, prices, vehicle, images, seller, leasing,….	url, path, id, country
makes	Vehicle makes taxonomy from search hub page	Validation workflows call makes to get vehicle makes taxonomy from search hub page.	country
models	Models taxonomy for a make (query-param filters — path-segment /lst/make/model returns 404)	Data-quality teams call models to get models taxonomy for a make (query-param filters.	make, country
filter_options	Available filter dimensions (fuel, body, transmission, etc.) from taxonomy blob	Ops teams call filter_options to get available filter dimensions (fuel, body, transmission, etc.) from taxonomy blob.	make, country
seller_listings	Listings for a dealer/private seller by customer id (cid)	Developer tools call seller_listings to get listings for a dealer/private seller by customer id (cid).	cid, country, page, seller_id
browse_links	SEO browse graph: cities, body types, model lines, top models (interlinking from search page)	Validation workflows call browse_links to get sEO browse graph.	make, country

Code samples

Call search from your stack

curl -X POST https://api.reefapi.com/autoscout24/v1/search \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{"make":"bmw","country":"de"}'

import requests

r = requests.post(
    "https://api.reefapi.com/autoscout24/v1/search",
    headers={"x-api-key": REEF_KEY},
    json={
  "make": "bmw",
  "country": "de"
},
)
print(r.json()["data"])

const res = await fetch("https://api.reefapi.com/autoscout24/v1/search", {
  method: "POST",
  headers: {
    "x-api-key": process.env.REEF_KEY,
    "content-type": "application/json",
  },
  body: JSON.stringify({
  "make": "bmw",
  "country": "de"
}),
});
const { ok, data, meta, error } = await res.json();

MCP one-liner

Ask your MCP-connected assistant: call reefapi.autoscout24.search with {"make":"bmw","country":"de"}.

Use cases

Who uses this API and why

Automotive pricing tools call search to track used-car prices and spot super-deals by make and model.
Dealer-intelligence products use seller_listings to audit a competitor dealership's inventory.
Market analysts use makes, models and filter_options to size supply across the European car market.

FAQ

Questions developers ask before integrating

What is the AutoScout24 API API?

AutoScout24 API API is a ReefAPI endpoint group for autoscout24 api It returns live JSON through POST requests under /autoscout24/v1.

Is the AutoScout24 API API free to try?

Yes. ReefAPI starts with 1,000 free credits, no card required. AutoScout24 API calls use the same shared credit balance as every other ReefAPI engine.

Do I need a AutoScout24 API login or account?

No login to AutoScout24 API is needed for the API response. You call ReefAPI with your x-api-key header, and the playground can run live examples before you create a production key.

How fresh is the AutoScout24 API data?

The page example is captured from a live search call, and production requests fetch live data through ReefAPI rather than a static sample.

How many credits does the AutoScout24 API API use?

AutoScout24 API actions currently cost 1 credit per successful call. Failed or blocked calls are free, and all APIs draw from one credit pool.

Can I call AutoScout24 API from an AI assistant or MCP client?

Yes. Connect ReefAPI once through MCP and your assistant can call autoscout24 actions with the same key, credit pool and JSON envelope used by normal REST requests.

Is the AutoScout24 API API a AutoScout24 API scraper?

It is the managed alternative to a DIY AutoScout24 API scraper. Instead of building and maintaining your own scraper — proxies, headless browsers, captcha and constant breakage — you call one ReefAPI endpoint and get the same autoscout24 api back as clean JSON.

Why does my AutoScout24 API scraper keep getting blocked?

Most AutoScout24 API scrapers break on anti-bot defenses, rate limits and IP bans that need rotating residential proxies and browser fingerprinting to clear. ReefAPI handles all of that for you — no proxies, no captchas, no maintenance — and returns live JSON. Blocked or failed calls are free.

docs / autoscout24

AutoScout24 API

base /autoscout24/v17 endpoints

post/autoscout24/v1/search1 credit

Paginated car search by make (+ model/filters) across EU TLDs; deal signals priceEvaluation+superDeal

Parameter		Allowed / range	Description
make	optional	—	Vehicle make/brand slug (e.g. bmw, audi, volkswagen). Empty = all makes.
model	optional	—	Model slug within the make (discover via the models action).
model_group	optional	—	Model-group/line slug (broader than model).
country = de	optional	de · it · fr · nl · es · at · be · ch · pl · ro · hr · lu	AutoScout24 country edition (TLD) — each is a separate marketplace.
page = 1	optional	1–	Result page (1-based). Page forward with meta.next_page.
sort	optional	price · age · mileage · power	Sort field. Common AS24 keys shown; others accepted.
desc	optional	—	Sort descending (true) instead of ascending.
price_min	optional	—	Minimum price (local currency).
price_max	optional	—	Maximum price (local currency).
year_min	optional	—	Earliest first-registration year.
year_max	optional	—	Latest first-registration year.
mileage_min	optional	—	Minimum mileage (km).
mileage_max	optional	—	Maximum mileage (km).
fuel	optional	B · D · E · 2 · 3	Fuel type (AS24 code). B=petrol, D=diesel, E=electric, 2=LPG, 3=CNG.
transmission	optional	A · M	Gearbox. A=automatic, M=manual.
body_type	optional	—	Body type (AS24 code — discover via filter_options).
zip	optional	—	Postal code center for a radius search.
radius	optional	—	Search radius (km) around zip.
power_min	optional	—	Minimum engine power (kW).
power_max	optional	—	Maximum engine power (kW).
super_deal	optional	—	Only listings flagged superDeal (priced well below market).
seller_type	optional	D · P	Seller type. D=dealer, P=private.
offer_type	optional	—	Offer type (AS24 code, e.g. U=used, N=new, J=annual car).

Try in playground →

post/autoscout24/v1/listing1 credit

Full listing detail by url/path or id (description, prices, vehicle, images, seller, leasing, warranty)

Parameter		Allowed / range	Description
url	optional	—	Full AS24 listing URL or site-relative path (from a search result's url/path).
path	optional	—	Site-relative listing path (alternative to url).
id	optional	—	AS24 listing id (alternative to url/path).
country = de	optional	de · it · fr · nl · es · at · be · ch · pl · ro · hr · lu	AutoScout24 country edition (TLD) — each is a separate marketplace.

Try in playground →

post/autoscout24/v1/makes1 credit

Vehicle makes taxonomy from search hub page

Parameter		Allowed / range	Description
country = de	optional	de · it · fr · nl · es · at · be · ch · pl · ro · hr · lu	AutoScout24 country edition (TLD) — each is a separate marketplace.

Try in playground →

post/autoscout24/v1/models1 credit

Models taxonomy for a make (query-param filters — path-segment /lst/make/model returns 404)

Parameter		Allowed / range	Description
make	required	—	Vehicle make/brand slug to list models for (e.g. bmw).
country = de	optional	de · it · fr · nl · es · at · be · ch · pl · ro · hr · lu	AutoScout24 country edition (TLD) — each is a separate marketplace.

Try in playground →

post/autoscout24/v1/filter_options1 credit

Available filter dimensions (fuel, body, transmission, etc.) from taxonomy blob

Parameter		Allowed / range	Description
make	optional	—	Optional make to scope the filter options to.
country = de	optional	de · it · fr · nl · es · at · be · ch · pl · ro · hr · lu	AutoScout24 country edition (TLD) — each is a separate marketplace.

Try in playground →

post/autoscout24/v1/seller_listings1 credit

Listings for a dealer/private seller by customer id (cid)

Parameter		Allowed / range	Description
cid	required	—	AS24 dealer/seller customer id (cid) — from a listing's seller block.
country = de	optional	de · it · fr · nl · es · at · be · ch · pl · ro · hr · lu	AutoScout24 country edition (TLD) — each is a separate marketplace.
page = 1	optional	1–	Result page (1-based). Page forward with meta.next_page.
seller_id	optional	—	Alias for cid (accepted interchangeably).

Try in playground →

post/autoscout24/v1/browse_links1 credit

SEO browse graph: cities, body types, model lines, top models (interlinking from search page)

Parameter		Allowed / range	Description
make	optional	—	Optional make to scope the browse graph to.
country = de	optional	de · it · fr · nl · es · at · be · ch · pl · ro · hr · lu	AutoScout24 country edition (TLD) — each is a separate marketplace.

Try in playground →

Example request · search

curl -X POST https://api.reefapi.com/autoscout24/v1/search \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{"make":"bmw","country":"de"}'

Response shape

{
  "ok": true,
  "data": { /* the result */ },
  "meta": {
    "latency_ms": 240,
    "record_count": 12,
    "completeness_pct": 100
  },
  "error": null
}