Get listing
curl --request GET \
--url https://scrapebadger.com/v1/autoscout24/listing \
--header 'X-API-Key: <api-key>'import requests
url = "https://scrapebadger.com/v1/autoscout24/listing"
headers = {"X-API-Key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};
fetch('https://scrapebadger.com/v1/autoscout24/listing', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://scrapebadger.com/v1/autoscout24/listing",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"X-API-Key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://scrapebadger.com/v1/autoscout24/listing"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-API-Key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://scrapebadger.com/v1/autoscout24/listing")
.header("X-API-Key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://scrapebadger.com/v1/autoscout24/listing")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["X-API-Key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"market": "<string>",
"source_url": "<string>",
"listing": {
"id": "<string>",
"title": "<string>",
"url": "<string>",
"description": "<string>",
"description_html": "<string>",
"status": "<string>",
"currency": "EUR",
"price": 123,
"price_formatted": "<string>",
"net_price": 123,
"vat_rate": 123,
"is_vat_deductible": true,
"is_negotiable": true,
"is_price_on_request": true,
"is_final_price": true,
"median_price": 123,
"price_evaluation": 123,
"price_details": {},
"prices": {},
"super_deal": {},
"make": "<string>",
"model": "<string>",
"variant": "<string>",
"version": "<string>",
"mileage_km": 123,
"first_registration": "<string>",
"registration_year": 123,
"registration_month": 123,
"power_kw": 123,
"power_hp": 123,
"displacement_cc": 123,
"transmission": "<string>",
"body_type": "<string>",
"fuel": "<string>",
"fuel_type": "<string>",
"seats": 123,
"doors": 123,
"vehicle": {},
"equipment": {},
"images": [
"<string>"
],
"header_image": "<string>",
"image_alt_text": "<string>",
"is_cover_image_placeholder": true,
"cover_image_attractiveness": 123,
"youtube_link": "<string>",
"twinner_url": "<string>",
"has_360_view": true,
"three_sixty": "<unknown>",
"vehicle_report": "<unknown>",
"partner_integrations": [
{}
],
"seller": {},
"location": {},
"ratings": {},
"rating": 123,
"rating_count": 123,
"recommend_percentage": 123,
"whatsapp_number": "<string>",
"identifier": {},
"article_type": "<string>",
"vehicle_type": "<string>",
"is_new": true,
"is_deliverable": true,
"availability": {},
"available_at": "<string>",
"available_utc": 123,
"created_at": "<string>",
"created_utc": 123,
"leasing_details": "<unknown>",
"warranty": "<unknown>",
"has_warranty": true,
"financing_flags": "<unknown>",
"financing_and_insurance": "<unknown>",
"online_purchase": "<unknown>",
"seals": [
"<unknown>"
],
"special_conditions": [
"<unknown>"
],
"search_result_type": "<string>",
"ad_tier": "<string>",
"applied_ad_tier": "<string>",
"has_premium_listing_treatment": true,
"is_trending": true,
"is_listing_boost": true,
"statistics": {},
"interaction_statistics": {}
},
"latency_ms": 123
}{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>"
}
]
}Search and reference
Get listing details
Full AutoScout24 vehicle specifications, equipment, photos, pricing and public seller contacts.
GET
/
v1
/
autoscout24
/
listing
Get listing
curl --request GET \
--url https://scrapebadger.com/v1/autoscout24/listing \
--header 'X-API-Key: <api-key>'import requests
url = "https://scrapebadger.com/v1/autoscout24/listing"
headers = {"X-API-Key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};
fetch('https://scrapebadger.com/v1/autoscout24/listing', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://scrapebadger.com/v1/autoscout24/listing",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"X-API-Key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://scrapebadger.com/v1/autoscout24/listing"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-API-Key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://scrapebadger.com/v1/autoscout24/listing")
.header("X-API-Key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://scrapebadger.com/v1/autoscout24/listing")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["X-API-Key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"market": "<string>",
"source_url": "<string>",
"listing": {
"id": "<string>",
"title": "<string>",
"url": "<string>",
"description": "<string>",
"description_html": "<string>",
"status": "<string>",
"currency": "EUR",
"price": 123,
"price_formatted": "<string>",
"net_price": 123,
"vat_rate": 123,
"is_vat_deductible": true,
"is_negotiable": true,
"is_price_on_request": true,
"is_final_price": true,
"median_price": 123,
"price_evaluation": 123,
"price_details": {},
"prices": {},
"super_deal": {},
"make": "<string>",
"model": "<string>",
"variant": "<string>",
"version": "<string>",
"mileage_km": 123,
"first_registration": "<string>",
"registration_year": 123,
"registration_month": 123,
"power_kw": 123,
"power_hp": 123,
"displacement_cc": 123,
"transmission": "<string>",
"body_type": "<string>",
"fuel": "<string>",
"fuel_type": "<string>",
"seats": 123,
"doors": 123,
"vehicle": {},
"equipment": {},
"images": [
"<string>"
],
"header_image": "<string>",
"image_alt_text": "<string>",
"is_cover_image_placeholder": true,
"cover_image_attractiveness": 123,
"youtube_link": "<string>",
"twinner_url": "<string>",
"has_360_view": true,
"three_sixty": "<unknown>",
"vehicle_report": "<unknown>",
"partner_integrations": [
{}
],
"seller": {},
"location": {},
"ratings": {},
"rating": 123,
"rating_count": 123,
"recommend_percentage": 123,
"whatsapp_number": "<string>",
"identifier": {},
"article_type": "<string>",
"vehicle_type": "<string>",
"is_new": true,
"is_deliverable": true,
"availability": {},
"available_at": "<string>",
"available_utc": 123,
"created_at": "<string>",
"created_utc": 123,
"leasing_details": "<unknown>",
"warranty": "<unknown>",
"has_warranty": true,
"financing_flags": "<unknown>",
"financing_and_insurance": "<unknown>",
"online_purchase": "<unknown>",
"seals": [
"<unknown>"
],
"special_conditions": [
"<unknown>"
],
"search_result_type": "<string>",
"ad_tier": "<string>",
"applied_ad_tier": "<string>",
"has_premium_listing_treatment": true,
"is_trending": true,
"is_listing_boost": true,
"statistics": {},
"interaction_statistics": {}
},
"latency_ms": 123
}{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>"
}
]
}Credits: 10 per successful listing detail. Removed/missing listings and failed requests are unbilled. Cache hits can cost zero; use
The hosted MCP tool is
X-Credits-Used for the actual charge.
Supply exactly one url or listing_id from vehicle search. A full HTTPS listing URL determines its supported market. A UUID without market defaults to Germany (de); an explicit market must match the URL host. Use de, at, be, es, fr, it, lu or nl. Swiss listings use a separate platform and are unsupported.
curl --get 'https://scrapebadger.com/v1/autoscout24/listing' \
--data-urlencode 'url=LISTING_URL_FROM_SEARCH' \
-H 'X-API-Key: YOUR_API_KEY'
CLI
scrapebadger autoscout24 listing --url LISTING_URL_FROM_SEARCH
scrapebadger autoscout24 listing --listing-id UUID --market it
autoscout24_get_listing. Python: await client.autoscout24.get_listing(url=listing_url). Node: await client.autoscout24.getListing({url: listingUrl}).
Response
The envelope containsmarket, source_url, listing and latency_ms. The listing includes identity/title/canonical URL, readable description and source description HTML; numeric price/currency/mileage/power, month-precision registration, make/model/variant/version and basic specifications.
vehicle retains complete useful native specifications and rawData, including taxonomy, drivetrain, body/interior, dimensions, condition, damage, roadworthiness, previous owners, maintenance, service and inspection, plus optional energy/WLTP/battery and environmental fields. Values absent upstream remain null or empty; an absent accident flag does not mean accident-free. Preserve raw/formatted values, units and fallback measurement basis.
equipment preserves source groups and entries, including localized labels. Native equipment id can itself be a localized label; stable raw codes, when supplied, remain in vehicle.rawData.equipment. images includes the full native photo collection. header_image can be a different responsive size of the first photo. Optional media includes YouTube, 360 viewer, vehicle report and partner links.
prices preserves public/dealer/suggested prices, gross/net amounts, VAT/deductibility, negotiation/on-request/final-price flags and median/evaluation ranges. Source bands are preserved even when their boundaries overlap or appear inconsistent. These are source asking-price assessments, not a reconstructed price history.
seller, ratings and location preserve publicly supplied company/contact names, typed phone entries, dealer links/logo, rating/count/category/recommendation data, address and coordinates. whatsapp_number, leasing, warranty, financing/insurance, availability, delivery, seals and online purchase are optional. No buyer message, contact action or private account access is performed. Host locale and seller location are independent.
first_registration has month precision (YYYY-MM); source first-of-month placeholders do not establish an actual registration day. Date-only availability retains its date without a fabricated Unix instant. Actual created/availability timestamps have ISO UTC and Unix pairs (created_at/created_utc, available_at/available_utc).
Errors and handoff
The returned UUID must match the requested listing. Removed or missing source listings return an unbilled404; malformed locators, unsupported hosts, ambiguous URL plus UUID and market mismatches return 422. Blocked, incomplete or inconsistent source data returns an unbilled 503, never a successful empty object. Retain X-Request-ID for diagnostics.
Detail returns one entity and has no pagination or search filters. Search pagination remains pages 1–200 using next_page. Listing content and availability can change after a search result was fetched. See credits and pricing for current plan prices.Authorizations
Query Parameters
Full HTTPS listing URL from search results. Supply url or listing_id, not both.
Maximum string length:
2048Listing UUID from search results; requires no SEO slug.
Required string length:
36Inferred from URL, otherwise de. Explicit market must match the URL host.
Available options:
de, at, be, es, fr, it, lu, nl Response
Successful Response
Full public listing with normalized values and native specifications.
Native objects preserve optional equipment, energy, history and commercial fields. Missing seller-entered values remain unknown, rather than false.
Show child attributes
Show child attributes

