Black Falcon Data

Posted on Aug 21 Edited on Aug 24

Autoscout24 API schema: fields, filters, and what is missing

#webscraping #api

An Autoscout24 record contains 74 fields. This page shows which are populated, which are optional, and what a real row looks like—the data the Autoscout24 API has to work with.

It also covers what our own Autoscout24 Actor returns, what it costs, and where its limits are.

Every field

Each record includes 74 fields, organized into several groups:

seller — sellerType, sellerName, sellerContact, sellerPhone, sellerRatingStars, sellerRatingCount
price — price, priceFormatted, priceEur, priceNegotiable, priceEvaluation
model — model, modelGroup, modelVersion, modelCode
description — description, descriptionHtml, descriptionMarkdown
body — bodyType, bodyColor
fuel — fuelType, fuelConsumption
power — powerKw, powerHp
number — numberOfSeats, numberOfDoors
country — country, countryVersion
emission — emissionClass, emissionSticker
upholstery — upholstery, upholsteryColor
repost — repostOfId, repostDetectedAt

Here is a record as returned, shortened for readability:

{
 "listingId": "7e13eedf-d415-4e9d-b20f-2590b1263ae3",
 "title": "Volkswagen Passat Lim. Comfortline",
 "url": "https://www.autoscout24.com/offers/volkswagen-passat-lim-comfortline-diesel-black-cat_m...",
 "portalUrl": "https://www.autoscout24.com/offers/volkswagen-passat-lim-comfortline-diesel-black-cat_m...",
 "make": "Volkswagen",
 "model": "Passat",
 "modelGroup": "Passat",
 "variant": "Sedan",
 "modelVersion": "Lim. Comfortline",
 "bodyType": "Sedan",
 "vehicleType": "Car",
 "condition": "Used",
 "mileageKm": 245975,
 "firstRegistration": "2006-08-01"
}

Filters that narrow a run

The input accepts 43 options, including make, model, countries, priceFrom, priceTo, yearFrom, yearTo, mileageTo, fuelType, transmission, bodyType, condition, searchUrls, location, maxResults, includeDetails, descriptionMaxLength, compact, incrementalMode, stateKey, and more.

Filters run server-side. You pay for the records requested, with no need to retrieve a larger set and filter it afterwards.

What it costs

Pricing is per event, with no subscription:

$0.005 per actor start
$0.0008 per result

These figures come from a measured run, not an estimate:

300 records in 165.0 seconds
cost: $0.00338 — about $0.01 per 1,000 records

What people use it for

Benchmarking. Pricing and salary fields allow comparisons across the whole set instead of relying on a page of results.
Reputation monitoring. Tracking ratings and review text over time reveals movement that a single page view cannot.
Lead lists. Company-level fields help isolate the relevant segment before anyone opens a CRM.
Change detection. Timestamps support run-to-run diffs, so teams can act on new data instead of re-reading everything.
Geographic analysis. Location fields enable market-by-market comparisons without a separate data source.

What it will not do

An empty field means the source showed nothing. Values are never inferred or filled in from another source.
The schema follows Autoscout24's markup. A redesign can add, rename or drop fields.
Anything Autoscout24 places behind a login is absent from every field below, by design.

Questions people ask

Not every field is populated, and missing values are not guessed. When the source leaves a field blank, it comes back blank. An empty value therefore means Autoscout24 did not show one, rather than that extraction failed.

Market coverage is controlled with location. It narrows the run before records are produced, so you pay only for the requested market instead of filtering afterwards.

The source-level filters include fuelType, bodyType, maxResults, descriptionMaxLength. This affects cost as well as convenience: filtered-out records are never produced and therefore never billed.

Every run reads Autoscout24 when it executes, with no cached copy in between. Two runs a week apart produce two snapshots, making change detection possible.

For changed records only, use incrementalMode. Without it, another run returns the full set, leaving deduplication to your side.

There is no public bulk export or API. The field list above comes from parsing pages, not from a documented schema.

Try it

If these are the fields you need, the Autoscout24 API behind these fields produces them. New accounts receive $5 of free platform credit each month, enough to cover a real run of this size several times over.

Disclosure: we build and maintain this Actor, and the link above is an affiliate link.

DEV Community