Looking for the overview — what this API returns, what it costs, and a call you can run without a key? See the AutoScout24 API page →
Classifieds & Second-hand

AutoScout24 API & Scraper

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 credits$0.67–$1.50 / 1,000 creditsMCP-ready
Get a free keyOpen in playground

🤖 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.

Reference

AutoScout24 country editions and what each one returned

Each country value is a separate AutoScout24 marketplace with its own host, its own language for the vehicle labels and its own inventory. The table records what a live make=bmw search returned for each of the twelve accepted values on 2026-08-27, including the two that did not answer, so you know which ones you can build on.

countryHostLive search on 2026-08-27BMW listings reported
deautoscout24.deanswered62,735
atautoscout24.atanswered13,420
itautoscout24.itanswered29,614
esautoscout24.esanswered16,805
nlautoscout24.nlanswered22,223
frautoscout24.franswered11,079
luautoscout24.luanswered1,059
plautoscout24.planswered169,381
roautoscout24.roanswered169,381
hrautoscout24.hranswered169,381
chautoscout24.chHTTP 403, marked retryablenot measured
beautoscout24.beHTTP 404, error code NOT_FOUNDnot measured

pl, ro and hr returned the identical total and the identical lead listing, so those three editions serve one shared cross-border pool behind localized hosts and labels rather than three national inventories; de, at, it, es, nl, fr and lu each returned distinct stock. Whatever the country, total_pages came back capped at 200 pages of 20, so at most 4,000 listings are reachable per query no matter how large total is. Narrow with make, model, price and year filters instead of paging deeper.

Live example

Real request and response JSON

Captured from the indexed primary action, search, on .

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 does

ActionDescriptionConcrete use caseKey params
searchPaginated car search by make (+ model/filters) across EU TLDs; deal signals priceEvaluation+superDealPrice-intelligence 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, ...
listingFull listing detail by url/path or id (description, prices, vehicle, images, seller, leasing, warranty)Classifieds aggregators call listing to get full listing detail by url/path or id (description, prices, vehicle, images, seller, leasing,….url, path, id, country
makesVehicle makes taxonomy from search hub pageResale and arbitrage tools call makes to get vehicle makes taxonomy from search hub page.country
modelsModels taxonomy for a make (query-param filters — path-segment /lst/make/model returns 404)Lead-generation teams call models to get models taxonomy for a make (query-param filters.make, country
filter_optionsAvailable filter dimensions (fuel, body, transmission, etc.) from taxonomy blobPrice-intelligence teams call filter_options to get available filter dimensions (fuel, body, transmission, etc.) from taxonomy blob.make, country
seller_listingsListings for a dealer/private seller by customer id (cid)Classifieds aggregators call seller_listings to get listings for a dealer/private seller by customer id (cid).cid, country, page, seller_id
browse_linksSEO browse graph: cities, body types, model lines, top models (interlinking from search page)Resale and arbitrage tools 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"}'
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

Is the AutoScout24 price a number I can compare?

Not on a search card. search returns price_formatted as a localized string, measured as '€ 7.990' on de, '€ 2 885' on pl and '€ 10 490' on fr, with the thousands separator following the local convention. The listing action gives you the number: prices.public.priceRaw came back as 7990 for that same car, alongside netPriceRaw 6714, vatRate 19 and taxDeductible false. Call listing when you need arithmetic, or strip the separators yourself.

What does price_evaluation mean on an AutoScout24 listing?

It is AutoScout24's deal rating as an integer category, 0 being the cheapest band and 6 the most expensive relative to the market. A single BMW search page on 2026-08-27 returned categories 0, 1, 2 and 4 plus three cards with null, so null means the rating is simply not published for that car. The listing action shows the arithmetic behind it: for one 7,990 euro car it returned median 8500 and an evaluationRanges array giving the price window per category, for example category 1 as 5901-7600 and category 2 as 7601-8500. super_deal is a separate flag for cars priced well below market.

Is mileage in kilometers, and is power in kW or hp?

Mileage is kilometers and power is reported both ways. A search card returns mileage_km as a localized string, '100.000 km' on de and '161 299 km' on pl, while the listing action returns vehicle.mileageInKmRaw as the integer 100000. Power comes back as power_kw '75 kW' and power_ps '102 PS' on the same listing, and the search card's vehicle_details array carries the combined string '75 kW (102 PS)'. The power_min and power_max search filters take kW.

What format is the first-registration date?

Three forms, depending on where you read it. A search card returns first_registration as MM-YYYY, measured as '11-2014'. Inside vehicle_details the same value appears as '11/2014'. The listing action carries both vehicle.firstRegistrationDate '11/2014' and vehicle.firstRegistrationDateRaw '2014-11-01', which is the only ISO-shaped date in the response and the one to parse. The year_min and year_max filters take a plain four-digit year.

Why do fuel and transmission come back as German or Polish words?

Because what you filter on and what you get back are two different vocabularies. You filter with AutoScout24's codes: fuel B for petrol, D for diesel, E for electric, 2 for LPG, 3 for CNG, and transmission A for automatic, M for manual. What comes back is the storefront's own display label, measured as 'Benzin', 'Diesel', 'Elektro' and 'Schaltgetriebe' or 'Automatik' on de, 'Benzyna' on pl, 'Benzină' on ro and 'Benzine' on nl. Map on the codes you sent, not on the strings you got back.

What does an AutoScout24 listing id look like?

A UUID, for example e1a37c14-3c6f-47c6-903b-bdacbb870023. Every search card carries it as id along with url and path, and the listing action accepts any of the three. The path is the site-relative form, /angebote/... on de, /oferta/... on pl and /aanbod/... on nl, so a path from one country's search only resolves against that same country value.

What does a full AutoScout24 listing include beyond the search card?

A measured listing call returned the complete vehicle block with makeId, modelId, motorTypeName, hsnTsn, bodyType, numberOfSeats, numberOfDoors, bodyColor plus bodyColorRaw and bodyColorOriginal, the equipment list, every image, the free-text description, warranty ('12 Monate'), leasing_details, status 'Active' and created_at as an ISO timestamp. The seller block carries the dealer id, company name, contact name, phone numbers and a ratings object, measured at ratingsCount 33, ratingsAverage '4,5' and per-category stars. Feed the seller id into seller_listings to pull that dealer's whole stock.

How do I find valid make, model and body_type values?

Ask the taxonomy actions rather than guessing. makes returns every brand with id, name and slug for a country, models returns that make's models, model_groups and model_lines, and filter_options returns the available filter dimensions with their option codes, which is where the body_type and offer_type codes come from. make and model are slugs such as bmw and 320, and both reject an unknown value rather than silently ignoring it.

What is the AutoScout24 API?

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

Is the AutoScout24 API free to try?

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

Do I need an AutoScout24 login or account?

No login to AutoScout24 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 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 use?

AutoScout24 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 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.

docs / autoscout24

AutoScout24

AutoScout24

base /autoscout24/v17 endpoints
post/autoscout24/v1/listing1 credit

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

ParameterAllowed / rangeDescription
urloptionalFull AS24 listing URL or site-relative path (from a search result's url/path).
pathoptionalSite-relative listing path (alternative to url).
idoptionalAS24 listing id (alternative to url/path).
country = deoptionalde · it · fr · nl · es · at · be · ch · pl · ro · hr · luAutoScout24 country edition (TLD) — each is a separate marketplace.
Try in playground →
post/autoscout24/v1/makes1 credit

Vehicle makes taxonomy from search hub page

ParameterAllowed / rangeDescription
country = deoptionalde · it · fr · nl · es · at · be · ch · pl · ro · hr · luAutoScout24 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)

ParameterAllowed / rangeDescription
makerequiredVehicle make/brand slug to list models for (e.g. bmw).
country = deoptionalde · it · fr · nl · es · at · be · ch · pl · ro · hr · luAutoScout24 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

ParameterAllowed / rangeDescription
makeoptionalOptional make to scope the filter options to.
country = deoptionalde · it · fr · nl · es · at · be · ch · pl · ro · hr · luAutoScout24 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)

ParameterAllowed / rangeDescription
cidrequiredAS24 dealer/seller customer id (cid) — from a listing's seller block.
country = deoptionalde · it · fr · nl · es · at · be · ch · pl · ro · hr · luAutoScout24 country edition (TLD) — each is a separate marketplace.
page = 1optional1–Result page (1-based). Page forward with meta.next_page.
seller_idoptionalAlias for cid (accepted interchangeably).
Try in playground →