Ендпойнти

Европейски обяви

A retail price surface of 9.8M listings in the 2026-08-18 coverage snapshot gathered from 681 origin portals — national classifieds sites, dealer groups and manufacturer stock pages — across 39 European countries: mobile.de, kleinanzeigen.de, autoscout24, leboncoin.fr, lacentrale.fr, autosupermarket.it, njuskalo.hr and hundreds more. Every listing keeps its origin portal in source_site, so the same feed answers a national question and a portal-level one. These are retail listings, not auction inventory: no bidding, no auction end date, no detail payload and no gallery, just a single remote thumbnail per listing. They live in their own tables with their own vocabulary (seller type, origin portal), which is why they get their own query surface instead of a site slug on /api/search. Ended and paid-placement ("promoted") rows are excluded from every response, and all three endpoints return 503 while the dataset has not been built yet. Scope: classifieds. Legacy /api/theparking/* paths and theparking grants remain compatible aliases.

Справочникът на ендпойнтите е на английски, както и самият API.

Calling it end to end

1Call GET /api/classifieds/facets once and cache it. Everything sits under a facets key: countries, brands, fuels, gearboxes, sellers, sources, value_counts and totals. It takes no filters — it always describes the whole feed. Never hard-code these values: brand, model, fuel, gearbox and seller are compared case-sensitively, so copy the spellings from here.
2When the user picks a brand, call GET /api/classifieds/models?brand=BMW,Audi to fill the model select. Models come back most common first, capped at 400.
3Query GET /api/classifieds/listings with the chosen filters. Multi-value filters are comma-separated: they OR within a parameter and AND across parameters. Page with limit/offset or page/page_size — limit caps at 100 (500 on a key granted bulk pages). If you do not need a match count, pass include_total=false: it is the fastest way to page this feed.
4Render each row directly. There is no detail endpoint and no gallery: the listing object you receive is the entire record, with one remote thumbnail in image_url. Link out with source_url (the ad on the origin portal) and fall back to source_url_redirect when it is null; /api/classifieds/resolve resolves one listing on demand.
5To use it as a market reference, query the same brand, model, and year window you are about to bid on, read the price_eur spread by seller_type, and diff it against the auction lot’s public_price_eur.

Покритие по държави

9,808,689 активни обяви към 2026-08-18, в 39 държави и 681 портала източници. Цифрите се променят с всяко обновяване — четете ги като пропорции и вземайте актуалните бройки от /api/classifieds/facets.

Държава	`country=`	Обяви	Портали	Най-големи портали източници
Germany	de	2,218,902	101	mobile.de, kleinanzeigen.de, autoscout24.de, volkswagen.de, pkw.de, instamotion.com
France	fr	1,328,466	148	leboncoin.fr, lacentrale.fr, zoomcar.fr, autocadre.com, spoticar.fr, paruvendu.fr
Italy	it	1,076,206	61	subito.it, autoscout24.it, quattroruote.it, autosupermarket.it, automobile.it, automoto.it
Spain	es	710,370	68	coches.net, milanuncios.com, autoscout24.es, autocasion.com, motorflash.com, coches.com
Netherlands	nl	640,482	63	autowereld.nl, marktplaats.nl, autotrack.nl, autoscout24.nl, viabovag.nl, autokopen.nl
Poland	pl	548,623	51	otomoto.pl, olx.pl, sprzedajemy.pl, autoplac.pl, allegro.pl, motogratka.pl
Bulgaria	bg	381,265	24	car24.bg, mobile.bg, cars.bg, auto.bg, bazar.bg, olx.bg
Austria	at	280,203	35	willhaben.at, gebrauchtwagen.at, autoscout24.at, zweispurig.at, dasweltauto.at, kleinanzeigen.at
Belgium	be	264,931	91	autoscout24.be, 2ememain.be, gocar.be, vroom.be, carselect.touring.be, okasie.be
Albania	al	252,511	5	merrjep.al, albania.landrover.com, carandclassic.com, motorsportmarkt.de, oldcar24.com
Switzerland	ch	222,766	33	autoscout24.ch, autolina.ch, tutti.ch, ricardo.ch, emilfrey.ch, auto.amag.ch
Sweden	se	187,869	29	blocket.se, bytbil.com, bilweb.se, volkswagen.se, riddermarkbil.se, hedinautomotive.se

Стойността за държава е смесица от портали, а не един пазар — половината от германския инвентар е от един сайт. Когато това е важно, стеснете с source или разширете с source_exclude. Тук са показани само най-големите портали; /api/classifieds/facets?limit=0 връща всички 681.

GET

/api/classifieds/listings

Query retail classifieds aggregated from portals across Europe.

Изисква обхвата classifieds scope.

Параметри

resolve_urlsboolean · query string

Default true: listings on the page whose source_url has never been looked up are resolved during the request, in parallel, and remembered. false answers faster with whatever has been resolved so far; source_url_redirect works either way.

Пример false·Откъде идва стойността Your latency choice.

page / page_sizeinteger · query string

1-based page and rows per page, as alternatives to offset and limit. Do not combine page with offset or page_size with limit.

Пример 1 / 50·Откъде идва стойността Pagination state in your application.

countrystring · query string

Comma-separated country codes, case-insensitive.

Пример de,at·Откъде идва стойността /api/classifieds/facets -> countries[].value

brandstring · query string

Comma-separated brands, exact as published. Compared as stored — case-sensitive. bmw matches nothing where BMW matches. Take the spelling from the facets endpoint.

Пример BMW,Audi·Откъде идва стойността /api/classifieds/facets -> facets.brands[].value

modelstring · query string

Comma-separated models. Compared as stored — case-sensitive.

Пример 3 Series·Откъде идва стойността /api/classifieds/models?brand=BMW -> models[].value

fuelstring · query string

Comma-separated normalized fuels. Exact, case-sensitive.

Пример diesel·Откъде идва стойността /api/classifieds/facets -> facets.fuels[].value

gearboxstring · query string

Comma-separated normalized gearboxes. Exact, case-sensitive.

Пример automatic·Откъде идва стойността /api/classifieds/facets -> facets.gearboxes[].value

sellerstring · query string

Comma-separated seller types, such as dealer or private. Exact, case-sensitive.

Пример dealer·Откъде идва стойността /api/classifieds/facets -> facets.sellers[].value

sourcestring · query string

Comma-separated origin portals, case-insensitive. Unlike site on the auction side, an unrecognised portal is not an error — this vocabulary is drawn from the data itself rather than fixed, so an unknown value simply matches nothing.

Пример mobile.de·Откъде идва стойността /api/classifieds/facets -> sources[].value

source_excludestring · query string

Comma-separated origin portals to leave out, case-insensitive. With ~681 portals in the vocabulary this is the only practical way to say “everything but”. A listing with no recorded portal survives an exclusion.

Пример mobile.de·Откъде идва стойността /api/classifieds/facets -> sources[].value

price_from / price_tointeger · query string

EUR bounds.

Пример 5000 / 15000·Откъде идва стойността EUR budget chosen by your user.

year_from / year_tointeger · query string

Year bounds.

Пример 2016 / 2022·Откъде идва стойността Year bounds chosen by your user.

kilometers_from / kilometers_tointeger · query string

Mileage bounds.

Пример 0 / 200000·Откъде идва стойността Mileage bounds chosen by your user.

qstring · query string

Case-insensitive substring match on the listing title or its description. The description itself is not returned, so a match can look unexplained — it is text you cannot see. Rare q values are also the usual cause of total_unavailable.

Пример touring·Откъде идва стойността Free text entered by your user.

with_photoboolean · query string

Only listings that carry a thumbnail.

Пример true·Откъде идва стойността Your filter choice.

sortenum · query string

Default newest.

Пример price_low·Откъде идва стойността Choose newest, price_low, price_high, year_new, year_old, or mileage_low.

limit / offsetinteger · query string

Or page_size / page. Default 50, max 100 (up to 500 on a key granted bulk pages), offset capped at 5000. This envelope carries total, limit, offset and total_pages only — no page, page_size or max_page. Page by offset.

Пример 50 / 0·Откъде идва стойността Pagination state in your application.

include_totalboolean · query string

Default true. Pass false to skip the match count entirely — total comes back null and the request is markedly faster.

Пример false·Откъде идва стойността Your pagination strategy.

Example requests

Request

GET https://api.thecarapi.com/api/classifieds/listings?country=de,at&brand=BMW&price_to=15000

GET https://api.thecarapi.com/api/classifieds/listings?seller=dealer&source=mobile.de&sort=price_low&with_photo=true

GET https://api.thecarapi.com/api/classifieds/listings?country=de&source_exclude=mobile.de,kleinanzeigen.de&include_total=false

Примерен отговор

json

{
  "success": true,
  "listings": [
    {
      "reference_id": "tp-91744022",
      "title": "BMW 320d Touring",
      "brand": "BMW",
      "model": "3 Series",
      "engine": "320d",
      "year": 2016,
      "price_eur": 12500.5,
      "mileage_km": 180000,
      "fuel_norm": "diesel",
      "gearbox_norm": "automatic",
      "colour": "black",
      "doors": "5",
      "country": "Germany",
      "country_code": "de",
      "region": "Bayern",
      "seller_type": "dealer",
      "source_site": "mobile.de",
      "photo_count": 12,
      "offer_url": "https://www.theparking.eu/...",
      "source_url": "https://www.mobile.de/...",
      "source_url_redirect": "https://www.theparking.eu/tools/ETHCMOLB/0/F.html",
      "image_url": "https://img.leparking.fr/...",
      "published": "2026-07-30",
      "first_seen_at": "2026-07-30T04:11:02",
      "last_seen_at": "2026-08-05T04:09:55"
    }
  ],
  "total": 4412,
  "total_capped": false,
  "total_unavailable": false,
  "limit": 50,
  "offset": 0,
  "total_pages": 89
}

Какво получавате

reference_idstring

Stable identity for the listing, prefixed tp-. Use it to de-duplicate across polls.

titlestring

Listing headline as published by the origin portal.

brand / model / enginestring

Brand and model as published, plus the engine or trim string when the portal supplies one.

yearinteger

Registration year.

price_eurnumber

Retail asking price in EUR. This is an asking price, not a transaction price.

mileage_kminteger

Odometer reading in kilometres.

fuel_normstring

Normalized fuel, e.g. diesel, petrol, electric, hybrid. Matches the fuel filter vocabulary.

gearbox_normstring

Normalized gearbox, e.g. automatic, manual. Matches the gearbox filter vocabulary.

colourstring

Exterior colour as published.

doorsstring

Door count as published by the portal.

country / country_codestring

Country the car is listed in — display name and lower-case code. country_code is what the country filter accepts.

regionstring

Sub-national region or state when the portal publishes one.

seller_typestring

dealer or private. The single most useful axis for separating trade from retail asking prices.

source_sitestring

Origin portal the listing came from, e.g. mobile.de. Matches the source / source_exclude filter vocabulary, ~681 values wide. This is the attribution that makes a country figure readable — half of all German inventory is one portal.

photo_countinteger

How many photos the origin listing carries. Only one thumbnail is exposed here.

offer_urlstring

The aggregator’s own detail page for the listing — a theparking.eu URL, not the ad itself. Read source_site, not this URL, to know which portal the listing belongs to.

source_urlstring | null

The ad on the origin portal named by source_site. Null until it has been resolved, and on a listing the portal has already dropped — fall back to source_url_redirect.

source_url_redirectstring | null

The aggregator’s outbound tracker, which redirects to the origin ad. Present whenever offer_url is, so it is the link to use while source_url is null.

image_urlstring

Single remote thumbnail on the aggregator’s own CDN. Not copied into our image vault — treat it as a hotlink that disappears with the listing.

publisheddate

Date the origin portal published the listing.

first_seen_at / last_seen_attimestamp

When our sweep first and most recently observed the listing. Use last_seen_at to judge staleness.

total / limit / offset / total_pagesinteger

Standard pagination envelope for the matching set. total is exact for ordinary filters, and null when total_unavailable is true.

total_cappedboolean

True when counting stopped at 100,000. Read total as “100,000+” and page by offset rather than trusting total_pages. An unfiltered total is precomputed and never capped.

total_unavailableboolean

True when total is null because the count did not finish inside its budget — typically a q= search or a rare source. The listings themselves are complete and correct; only the count is missing, and the verdict is cached for 5 minutes.

Бележки

Every multi-value filter is OR within the parameter and AND across parameters — country=de,at&brand=BMW,Audi means (DE or AT) and (BMW or Audi). A non-numeric value on a numeric parameter is a 400, not a dropped filter. Match values exactly: country, source and source_exclude are case-insensitive; brand, model, fuel, gearbox and seller are compared as stored, so take the spellings from /api/classifieds/facets rather than typing them. An unknown value is never an error here, it simply matches nothing. Counting is bounded rather than exhaustive on a feed this size: read total together with total_capped and total_unavailable, or skip it with include_total=false. Responses are served with Cache-Control: public, max-age=60 and no ETag, so conditional requests do not help here — include_total=false is the lever that does. There is no detail endpoint for these rows: those 25 keys are the whole record. To sync the whole feed rather than page through it, see the bulk export below — it is locked to approved accounts. Returns 503 while the dataset has not been built yet.

GET

/api/classifieds/facets

Counted filter vocabulary for the classifieds dataset.

Изисква обхвата classifieds scope.

Параметри

limitinteger · query string

Values returned per dimension, default 50. 0 returns all of them — the only way to get the full 681-portal sources list.

Пример 0·Откъде идва стойността How many values your picker can hold.

Example requests

Request

GET https://api.thecarapi.com/api/classifieds/facets

GET https://api.thecarapi.com/api/classifieds/facets?limit=0

curl -H "X-API-Key: $API_KEY" "https://api.thecarapi.com/api/classifieds/facets"

Примерен отговор

json

{
  "success": true,
  "facets": {
    "countries": [
      {
        "value": "de",
        "count": 1840221
      }
    ],
    "brands": [
      {
        "value": "BMW",
        "count": 402118
      }
    ],
    "fuels": [
      {
        "value": "diesel",
        "count": 4110882
      }
    ],
    "gearboxes": [
      {
        "value": "manual",
        "count": 5233901
      }
    ],
    "sellers": [
      {
        "value": "dealer",
        "count": 8901233
      }
    ],
    "sources": [
      {
        "value": "mobile.de",
        "count": 913442
      }
    ],
    "value_counts": {
      "countries": 41,
      "brands": 128,
      "fuels": 7,
      "gearboxes": 3,
      "sellers": 2,
      "sources": 683
    },
    "totals": {
      "total": 9714882,
      "total_capped": false,
      "price_min": 50,
      "price_max": 4500000,
      "year_min": 1920,
      "year_max": 2027
    }
  }
}

Какво получавате

facets.countries / brands / fuels / gearboxes / sellers / sources{value, count}[]

Each dimension is a list of {value, count}, most common first, nested under the facets key rather than at the top level. The values are exactly what the listings feed’s filters match on, so copy them verbatim: brands, fuels, gearboxes and sellers are compared case-sensitively downstream.

facets.value_counts.<dimension>integer

How many distinct values that dimension really has, before limit trimmed it. Check value_counts.sources against the length of sources to know whether you are looking at all of them.

facets.totals.totalinteger

Listings in the feed.

facets.totals.total_cappedboolean

True when counting stopped at 100,000 — read total as "100,000+".

facets.totals.price_min / price_max / year_min / year_maxnumber | integer

EUR and year bounds across the feed, for sizing sliders.

GET

/api/classifieds/models

List models available for one or more brands.

Изисква обхвата classifieds scope.

Параметри

brandstring · query stringзадължителен

Comma-separated brand list. Required. Matched exactly and case-sensitively, like the same parameter on the listings feed — pass the spellings from the brands facet.

Пример BMW,Audi·Откъде идва стойността /api/classifieds/facets -> facets.brands[].value

Example requests

Request

GET https://api.thecarapi.com/api/classifieds/models?brand=BMW

GET https://api.thecarapi.com/api/classifieds/models?brand=BMW,Audi

Примерен отговор

json

{
  "success": true,
  "models": [
    {
      "value": "3 Series",
      "count": 8841
    },
    {
      "value": "5 Series",
      "count": 6002
    }
  ]
}

Какво получавате

models{value, count}[]

Model names available for the requested brands, most common first, capped at 400. value goes straight back into the model filter on /api/classifieds/listings.

GET

/api/classifieds/resolve

Resolve the origin portal URL of one classified listing.

Изисква обхвата classifieds scope.

Параметри

reference_idstring · query string

The listing’s stable identifier. One of reference_id, offer_url or slug is needed.

Пример 9190319266·Откъде идва стойността /api/classifieds/listings -> listings[].reference_id

offer_urlstring · query string

The aggregator detail URL, as an alternative to reference_id.

Пример https://www.theparking.eu/used-cars-detail/vehicle/ad/CODU642L.html·Откъде идва стойността /api/classifieds/listings -> listings[].offer_url

slugstring · query string

The aggregator listing slug, as an alternative to reference_id.

Пример CODU642L·Откъде идва стойността The last path segment of offer_url.

redirectboolean · query string

true answers with a 302 straight to the origin ad (or the tracker fallback) instead of JSON — usable as the href of an outbound link. Default false.

Пример true·Откъде идва стойността Your link-handling choice.

Example requests

Request

GET https://api.thecarapi.com/api/classifieds/resolve?reference_id=9190319266

GET https://api.thecarapi.com/api/classifieds/resolve?slug=CODU642L&redirect=true

Примерен отговор

json

{
  "success": true,
  "reference_id": "9190319266",
  "slug": "CODU642L",
  "offer_url": "https://www.theparking.eu/used-cars-detail/vehicle/ad/CODU642L.html",
  "source_site": "autoscout24.be",
  "source_url": "https://www.autoscout24.be/fr/offres/-ac3cffef-3c79-4a97-b1e3-a08f3e776a00",
  "source_url_redirect": "https://www.theparking.eu/tools/ETHCMOLB/0/F.html",
  "status": "resolved"
}

Какво получавате

source_urlstring | null

The ad on the origin portal named by source_site. Null when it could not be resolved.

source_url_redirectstring | null

The aggregator’s outbound tracker, which redirects to the origin ad. Use it whenever source_url is null.

statusenum

resolved (source_url is set), expired (the portal no longer has the ad) or unresolved (the lookup did not answer this time).

GET

/api/classifieds/export

Bulk export of the classifieds feed, up to 1,000 listings per request at any depth.

ЗаключенApproved accounts only. Bulk export is its own permission, granted only to accounts we have approved: the classifieds scope does not include it, and any other key gets 403. Contact us to apply for access.

Изисква обхвата classifieds-export scope.

Параметри

afterinteger · query string

Cursor. Omit (or send 0) for the first page, then pass each response’s next_after until it comes back null.

Пример 0·Откъде идва стойността The previous page’s next_after.

limitinteger · query string

Listings per page. Default and maximum 1000; larger values are lowered to 1000.

Пример 1000·Откъде идва стойността Page size chosen by your sync job.

fieldsstring · query string

Comma-separated columns to return, in this order. Defaults to all of them. An unknown name is a 400 that lists the valid ones.

Пример reference_id,brand,model,year,price_eur,source_url·Откъде идва стойността Any of: reference_id, title, brand, model, engine, year, price_eur, mileage_km, fuel_norm, gearbox_norm, colour, doors, country, country_code, region, seller_type, source_site, photo_count, offer_url, source_url, image_url, published, first_seen_at, last_seen_at, source_url_redirect.

countrystring · query string

Comma-separated country codes, case-insensitive.

Пример de,at·Откъде идва стойността /api/classifieds/facets -> facets.countries[].value

brand / modelstring · query string

Comma-separated, exact and case-sensitive as on /api/classifieds/listings.

Пример BMW / 3 Series·Откъде идва стойността /api/classifieds/facets, /api/classifieds/models

fuel / gearbox / sellerstring · query string

Comma-separated normalized values, exact and case-sensitive.

Пример diesel / automatic / dealer·Откъде идва стойността /api/classifieds/facets

source / source_excludestring · query string

Comma-separated origin portals to keep or leave out, case-insensitive.

Пример mobile.de·Откъде идва стойността /api/classifieds/facets -> facets.sources[].value

price_from / price_tointeger · query string

EUR bounds.

Пример 5000 / 15000·Откъде идва стойността EUR budget chosen by your user.

year_from / year_tointeger · query string

Year bounds.

Пример 2016 / 2022·Откъде идва стойността Year bounds chosen by your user.

kilometers_from / kilometers_tointeger · query string

Mileage bounds.

Пример 0 / 200000·Откъде идва стойността Mileage bounds chosen by your user.

qstring · query string

Substring match on title and description. Unindexed, so slow on a narrow match.

Пример touring·Откъде идва стойността Free text.

with_photoboolean · query string

Only listings that carry a thumbnail.

Пример true·Откъде идва стойността Your filter choice.

Example requests

Request

GET https://api.thecarapi.com/api/classifieds/export?country=de&fields=reference_id,brand,model,year,price_eur,source_url

GET https://api.thecarapi.com/api/classifieds/export?country=de&after=91744022

Примерен отговор

json

{
  "success": true,
  "columns": [
    "reference_id",
    "brand",
    "model",
    "year",
    "price_eur",
    "source_url"
  ],
  "rows": [
    [
      "tp-91744022",
      "BMW",
      "3 Series",
      2016,
      12500.5,
      "https://www.mobile.de/..."
    ],
    [
      "tp-91744023",
      "Audi",
      "A4",
      2018,
      17900,
      null
    ]
  ],
  "count": 2,
  "next_after": null,
  "contract_version": "2026-10-05"
}

Какво получавате

columnsstring[]

The name of each position in a row — your fields, in your order.

rowsarray[]

One array per listing, values in columns order. Each key is sent once per page rather than once per listing, which keeps a 1,000-row page small.

countinteger

Rows on this page.

next_afterinteger | null

Pass as after for the next page. null on the last page.