Gaspedaal.nl API & Scraper
The Gaspedaal.nl API returns the Netherlands' car aggregator as clean JSON in five actions: search, listing, brands, models and source_sites.
🤖 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.
Gaspedaal does not hold stock of its own — it groups one car across every Dutch site that advertises it — so the thing that makes this API different is on every row: sources, the list of sites carrying that exact car, each with the site's name, its numeric id, what kind of site it is (dealer site, classifieds, lease portal, garage chain, importer) and a link that resolves to the real listing on that site. Measured on 2026-10-01 across 900 rows: 1 to 12 sources per car, mean 3.99, and 20 distinct Dutch sites inside a single 100-car page. search covers 348,966 cars with 35 filters that were each measured to move Gaspedaal's own total in the same run: brand and model by slug or by id, price, build year, mileage, engine power in kW, cylinder capacity, cylinders, seats, towing weight, kerb weight, road tax, electric range, battery capacity, doors, fuel, gearbox, body style, colour, seller type, warranty, verified Dutch NAP mileage, VAT-deductible or margin, a Dutch postcode with a radius, how many days the car has been on offer, and three filters nothing else offers — only cars listed on a given source site, only cars exclusive to one site, or every car with one site removed from its group. 100 cars a page, nine sort orders, and the whole result set is page-able: page 3,490 still returns rows. listing takes a Gaspedaal ad id and returns the same fields plus the resolved listing url on each source site. Every price is read twice from the same response and compared against the page's own structured-data copy before it is returned, so a row whose two copies disagree is flagged rather than published quietly — across 1,800 rows in two runs, zero disagreed. brands lists all 447 brands with the live car count Gaspedaal prints next to each, models lists a brand's models, and source_sites counts which Dutch sites are in the index right now from a live sample. No Gaspedaal account, no browser — one ReefAPI key and the standard { ok, data, meta, error } envelope.
One car, five sites: what an aggregator row actually contains
A Gaspedaal row is not a listing, it is a car. The same Volkswagen Golf is advertised by the dealer's own website, by two national classifieds, by the ANWB motoring-club site and by two lease portals. The API keeps that group whole and resolves each entry to the listing it actually points at, so you can compare the same car across sites instead of de-duplicating five feeds yourself.
| Car (ad_id) | Price | Source site | kind | Resolved listing |
|---|---|---|---|---|
| Volkswagen Golf 1.4 GTE DSG, 2020, 99,412 km, Lemelerveld (141815198) | EUR 21,900 | Dealersite | dealer | autovanewijk.nl/occasions/57064231 |
| same car | EUR 21,900 | AutoTrack | other | autotrack.nl/a/volkswagen-golf-benzine-2021-60145178 |
| same car | EUR 21,900 | AutoScout24 | other | autoscout24.nl/aanbod/volkswagen-golf-gte-1-4-dsg-… |
| same car | EUR 21,900 | DTC lease | financial | dtc-lease.nl/voorraad/2656307/calculate/business |
| same car | EUR 21,900 | NationaleAutolease | financial | nationaleautolease.nl/leasevoorraad/personenauto/volkswagen/golf/42378 |
| Volkswagen Golf 1.5 TSI Highline, 2018, 138,369 km, Ermelo (141613855) | EUR 16,990 | 6 sites incl. ANWB, Lease.auto, FinancialLease.nl | mixed | anwb.nl/auto/kopen/detail/merk=volkswagen/model=golf/… |
Captured live on 2026-10-01 from one call. Dutch classified ads turn over in weeks, so these ids are dated — take fresh ones from search. Resolving the source links is opt-in and bounded: this call asked for 12 and got 12, which is why the third car in the same response still had four links unresolved and counted in source_urls_unresolved.
Real request and response JSON
Captured from the indexed primary action, search, on .
{
"method": "POST",
"url": "https://api.reefapi.com/gaspedaal/v1/search",
"headers": {
"x-api-key": "$REEF_KEY",
"content-type": "application/json"
},
"body": {
"brand": "volkswagen",
"model": "golf",
"max_results": 20
}
}{
"ok": true,
"meta": {
"api": "gaspedaal",
"endpoint": "search",
"mode": "live",
"latency_ms": 1861.6,
"record_count": 100,
"bytes": 1084261,
"cache_hit": false,
"completeness_pct": 100,
"stop_reason": "page_served",
"total_results": 6778,
"duplicates_dropped": 0,
"source_sites_seen": 16,
"price_conflicts": 0,
"source_urls_unresolved": 0,
"upstream_requests": 1,
"charged_credits": 1,
"version": "0.1.0",
"request_id": "657007a237794ee6",
"queue_ms": 1.5
},
"data": {
"total_results": 6778,
"page": 1,
"page_size": 100,
"pages": 68,
"has_more": true,
"count": 100,
"duplicates_dropped": 0,
"sources_total": 592,
"source_sites_seen": 16,
"source_urls_resolved": 0,
"source_urls_unresolved": 0,
"price_conflicts": 0,
"sort_applied": "relevance",
"filters_applied": {
"brand": "volkswagen",
"model": "golf"
},
"search_url": "https://www.gaspedaal.nl/volkswagen/golf",
"cars": [
{
"ad_id": "141631187",
"gaspedaal_url": "https://www.gaspedaal.nl/volkswagen/golf#141631187",
"title": "Volkswagen Golf 1.5 TSI Life Business",
"brand": "Volkswagen",
"model": "Golf",
"trim": "1.5 TSI Life Business",
"price_eur": 17400,
"currency": "EUR",
"year": 2020,
"mileage_km": 101427,
"fuel": "petrol",
"fuel_source": "BENZINE",
"transmission": "manual",
"transmission_source": "HANDMATIG",
"body_type": "hatchback",
"body_type_source": "HATCHBACK",
"colour": "grey",
"colour_source": "GRIJS",
"doors": 5,
"engine_cc": 1498,
"power_kw": 96,
"power_hp": 131,
"condition": "used",
"listed_at": "2026-09-24T16:16:09.000Z",
"photo_url": "https://cdn.gaspedaal.nl/images/large/c4133e76369460bc0c0d88a41e7617b96fbbe795.jpg?source=https://media-gaspedaal.export.dv.nl/23737306964/foto.jpg",
"photo_url_small": "https://cdn.gaspedaal.nl/images/small/d3ab88bac4f0ada011b57925f9f57f2b87e1c688.jpg?source=https://media-gaspedaal.export.dv.nl/23737306964/foto.jpg",
"seller": {
"name": null,
"schema_name": "Onbekende dealer",
"schema_type": "AutoDealer",
"page_url": "https://www.gaspedaal.nl/autobedrijven/autobedrijf-frietema/aanbod",
"city": "Woudenberg",
"province": "Utrecht",
"province_code": "UT",
"country": "NL"
},
"source_count": 4,
"sources": [
{
"site": "[trimmed-depth]",
"site_id": "[trimmed-depth]",
"kind": "[trimmed-depth]",
"site_ad_id": "[trimmed-depth]",
"click_out_url": "[trimmed-depth]",
"source_url": "[trimmed-depth]",
"logo_url": "[trimmed-depth]"
},
{
"site": "[trimmed-depth]",
"site_id": "[trimmed-depth]",
"kind": "[trimmed-depth]",
"site_ad_id": "[trimmed-depth]",
"click_out_url": "[trimmed-depth]",
"source_url": "[trimmed-depth]",
"logo_url": "[trimmed-depth]"
},
{
"site": "[trimmed-depth]",
"site_id": "[trimmed-depth]",
"kind": "[trimmed-depth]",
"site_ad_id": "[trimmed-depth]",
"click_out_url": "[trimmed-depth]",
"source_url": "[trimmed-depth]",
"logo_url": "[trimmed-depth]"
}
],
"price_eur_schema": 17400,
"price_conflict": false,
"mileage_conflict": false
},
{
"ad_id": "141613855",
"gaspedaal_url": "https://www.gaspedaal.nl/volkswagen/golf#141613855",
"title": "Volkswagen Golf 1.5 TSI Highline LED + Dynamic knipperl. achter | Virtual Co",
"brand": "Volkswagen",
"model": "Golf",
"trim": "1.5 TSI Highline LED + Dynamic knipperl. achter | Virtual Co",
"price_eur": 16990,
"currency": "EUR",
"year": 2018,
"mileage_km": 138369,
"fuel": "petrol",
"fuel_source": "BENZINE",
"transmission": "automatic",
"transmission_source": "AUTOMATISCH",
"body_type": "hatchback",
"body_type_source": "HATCHBACK",
"colour": "black",
"colour_source": "ZWART",
"doors": 5,
"engine_cc": 1498,
"power_kw": 110,
"power_hp": 150,
"condition": "used",
"listed_at": "2026-09-24T03:59:28.000Z",
"photo_url": "https://cdn.gaspedaal.nl/images/large/4003c3ccefaf152d0d8be1780a1a59dd8faed38b.jpg?source=https://media-gaspedaal.export.dv.nl/23724974547/foto.jpg",
"photo_url_small": "https://cdn.gaspedaal.nl/images/small/69a078b6d141fdd86d2c70d7a07e80b1d0e97fa0.jpg?source=https://media-gaspedaal.export.dv.nl/23724974547/foto.jpg",
"seller": {
"name": "Bosch Car Service Auto Verbeek",
"schema_name": "Bosch Car Service Auto Verbeek",
"schema_type": "AutoDealer",
"page_url": "https://www.gaspedaal.nl/autobedrijven/autoverbeek/aanbod",
"city": "Ermelo",
"province": "Gelderland",
"province_code": "GE",
"country": "NL"
},
"source_count": 6,
"sources": [
{
"site": "[trimmed-depth]",
"site_id": "[trimmed-depth]",
"kind": "[trimmed-depth]",
"site_ad_id": "[trimmed-depth]",
"click_out_url": "[trimmed-depth]",
"source_url": "[trimmed-depth]",
"logo_url": "[trimmed-depth]"
},
{
"site": "[trimmed-depth]",
"site_id": "[trimmed-depth]",
"kind": "[trimmed-depth]",
"site_ad_id": "[trimmed-depth]",
"click_out_url": "[trimmed-depth]",
"source_url": "[trimmed-depth]",
"logo_url": "[trimmed-depth]"
},
{
"site": "[trimmed-depth]",
"site_id": "[trimmed-depth]",
"kind": "[trimmed-depth]",
"site_ad_id": "[trimmed-depth]",
"click_out_url": "[trimmed-depth]",
"source_url": "[trimmed-depth]",
"logo_url": "[trimmed-depth]"
}
],
"price_eur_schema": 16990,
"price_conflict": false,
"mileage_conflict": false
},
{
"ad_id": "141602496",
"gaspedaal_url": "https://www.gaspedaal.nl/volkswagen/golf#141602496",
"title": "Volkswagen Golf Vii 1.4 TSI 7-DSG 3XR-line RIJKLAAR/TREKAAK/DCC/LED/ACC/CARP",
"brand": "Volkswagen",
"model": "Golf",
"trim": "Vii 1.4 TSI 7-DSG 3XR-line RIJKLAAR/TREKAAK/DCC/LED/ACC/CARP",
"price_eur": 18995,
"currency": "EUR",
"year": 2018,
"mileage_km": 130438,
"fuel": "petrol",
"fuel_source": "BENZINE",
"transmission": "automatic",
"transmission_source": "AUTOMATISCH",
"body_type": "hatchback",
"body_type_source": "HATCHBACK",
"colour": "blue",
"colour_source": "BLAUW",
"doors": 5,
"engine_cc": 1395,
"power_kw": 92,
"power_hp": 125,
"condition": "used",
"listed_at": "2026-09-23T16:19:20.000Z",
"photo_url": "https://cdn.gaspedaal.nl/images/large/5bdb31da9dde2b40d38df52c08e498ed28a302ee.jpg?source=https://media-gaspedaal.export.dv.nl/23720044014/foto.jpg",
"photo_url_small": "https://cdn.gaspedaal.nl/images/small/b8ad0652b4dc1f0b9082e812693916e2462ba545.jpg?source=https://media-gaspedaal.export.dv.nl/23720044014/foto.jpg",
"seller": {
"name": null,
"schema_name": "Onbekende dealer",
"schema_type": "AutoDealer",
"page_url": "https://www.gaspedaal.nl/autobedrijven/autobedrijf-rozendaal-bv/aanbod",
"city": "Groot-Ammers",
"province": "Zuid-Holland",
"province_code": "ZH",
"country": "NL"
},
"source_count": 5,
"sources": [
{
"site": "[trimmed-depth]",
"site_id": "[trimmed-depth]",
"kind": "[trimmed-depth]",
"site_ad_id": "[trimmed-depth]",
"click_out_url": "[trimmed-depth]",
"source_url": "[trimmed-depth]",
"logo_url": "[trimmed-depth]"
},
{
"site": "[trimmed-depth]",
"site_id": "[trimmed-depth]",
"kind": "[trimmed-depth]",
"site_ad_id": "[trimmed-depth]",
"click_out_url": "[trimmed-depth]",
"source_url": "[trimmed-depth]",
"logo_url": "[trimmed-depth]"
},
{
"site": "[trimmed-depth]",
"site_id": "[trimmed-depth]",
"kind": "[trimmed-depth]",
"site_ad_id": "[trimmed-depth]",
"click_out_url": "[trimmed-depth]",
"source_url": "[trimmed-depth]",
"logo_url": "[trimmed-depth]"
}
],
"price_eur_schema": 18995,
"price_conflict": false,
"mileage_conflict": false
}
]
}
}What the Gaspedaal.nl API does
| Action | Description | Concrete use case | Key params |
|---|---|---|---|
| search | Search Gaspedaal's aggregated Dutch car stock. Every row is ONE car with sources[] = every site that lists it (measured 1-11 sources per car, mean 4.6 over 500 rows). Rows are de-duplicated by ad_id inside the call and duplicates_dropped says how many repeats the live result set served. 100 cars per full page, which is fixed by the site; total_results is Gaspedaal's own count and the whole set is page-able. Every filter here was measured to change that total in the same run. Call with no parameters to page the whole Dutch market. | Price-intelligence teams call search to search Gaspedaal's aggregated Dutch car stock. | query, brand, model, brand_id, model_id, ... |
| listing | One car by its Gaspedaal ad id, with the complete source group: every site that lists it, the click-out for each and — unless you switch it off — the resolved real listing url on each source site. Same fields as a search row, both price witnesses compared. A dead or removed ad id returns NOT_FOUND (the site answers HTTP 200 with zero rows, which this engine does NOT pass off as an empty success). | Classifieds aggregators call listing to get one car by its Gaspedaal ad id, with the complete source group. | ad_id, resolve_source_urls, max_resolved_urls |
| brands | Every car brand Gaspedaal has stock for, with the slug the search action takes, the numeric brand id, and the live number of cars the site itself prints next to the brand. | Resale and arbitrage tools call brands to get every car brand Gaspedaal has stock for, with the slug the search action takes, the numeric b…. | none |
| models | Every model Gaspedaal lists for one brand, with the slug and id the search action takes. Give brand as a slug or brand_id as the numeric id — one of the two is required; calling with neither returns MISSING_PARAM. | Lead-generation teams call models to get every model Gaspedaal lists for one brand, with the slug and id the search action takes. | brand, brand_id |
| source_sites | Which Dutch sites Gaspedaal is aggregating right now, counted from a live sample of its own result pages: site name, the numeric id the search filters take, the kind of site (dealer / other / financial / garageconcept) and how many cars of the sample it appeared on. This is a SAMPLE, not a registry — sample_cars says how big it was. | Price-intelligence teams call source_sites to get which Dutch sites Gaspedaal is aggregating right now, counted from a live sample of its own r…. | pages |
Call search from your stack
curl -X POST https://api.reefapi.com/gaspedaal/v1/search \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"brand":"volkswagen","model":"golf","max_results":20}'import requests
r = requests.post(
"https://api.reefapi.com/gaspedaal/v1/search",
headers={"x-api-key": REEF_KEY},
json={
"brand": "volkswagen",
"model": "golf",
"max_results": 20
},
)
print(r.json()["data"])const res = await fetch("https://api.reefapi.com/gaspedaal/v1/search", {
method: "POST",
headers: {
"x-api-key": process.env.REEF_KEY,
"content-type": "application/json",
},
body: JSON.stringify({
"brand": "volkswagen",
"model": "golf",
"max_results": 20
}),
});
const { ok, data, meta, error } = await res.json();Ask your MCP-connected assistant: call reefapi.gaspedaal.search with {"brand":"volkswagen","model":"golf","max_results":20}.Who uses this API and why
- Price-comparison and valuation tools read one car once instead of matching the same advert across five Dutch sites themselves.
- Dealers and dealer-software vendors audit their own stock distribution: which of their cars reached AutoTrack, AutoScout24 or ANWB, and which are stuck on their own website only.
- Lease and fleet buyers filter VAT-deductible versus margin cars and verified NAP mileage, and reach the lease portals carrying each car directly.
- Market analysts size the Dutch used-car market by brand, fuel, gearbox, province and seller type from Gaspedaal's own totals, and track how exclusive each source site's inventory is.
- Lead-generation teams map Dutch dealers with their town, province and Gaspedaal dealer page without touching any personal data, because none is published.
Questions developers ask before integrating
What makes an aggregator different from scraping one car site?
One row is one car, not one advert. Gaspedaal has already matched the same car across the Dutch sites that advertise it, and this API hands you that group: sources holds every site, its name, its id, its kind and a link that resolves to the listing on that site. Measured on 2026-10-01 over 900 rows, a car carried 1 to 12 sources, mean 3.99, and a single 100-car page touched 20 different Dutch sites. If you scraped the sites separately you would have to match the cars yourself; here the matching is the data.
Which Dutch sites are behind it?
The source_sites action answers that from a live sample instead of a brochure. On 2026-10-01 a 100-car sample contained 20 sites: the dealer's own website (on 100 % of cars), AutoTrack (100 %), AutoScout24 (71 %), ANWB (65 %), FinancialLease.nl (40 %), Lease.auto (30 %), DTC lease (28 %), Financial Lease For You (20 %), NationaleAutolease (19 %), Twelvelease (18 %), Regeljelease.nl (17 %), Mobilist (14 %), Vakgarage (9 %), Bedrijfsauto.nl, ActivLease, SEAT Approved Occasions, Carteam, AutoFirst, JAMES Autoservice and Mercedes-Benz Certified. A 300-car sample found 23. Worth knowing before you build on it: a good share of those are financial-lease portals rather than independent classifieds, which is why every source carries a kind field so you can keep them apart.
Does the same car ever appear twice?
Inside one call, no: rows are de-duplicated by ad_id and duplicates_dropped tells you how many repeats were removed — it was 0 across 900 rows in each of two runs. Across consecutive pages of one search it does happen, because the live result set re-ranks between page fetches: three consecutive pages of a Volkswagen search returned 300 rows containing 274 distinct cars, so 26 rows (8.67 %) were a car that had already been served on an earlier page. De-duplicate by ad_id when you page. What is not happening is double-listing: in those same 300 rows, 1,581 distinct source adverts appeared and not one of them belonged to two different Gaspedaal cars, and 274 cars produced 274 distinct brand-model-trim-year-mileage-price fingerprints.
Do the filters really narrow the results?
All 35 were measured against the unfiltered total in the same run, twice, and all 35 moved it. From 348,966 cars: electric 34,734, automatic 208,365, manual 139,378, convertibles 12,032, red 17,229, two-door 19,165, verified NAP mileage 142,554, VAT-deductible 155,471, margin cars 123,045, private sellers 2,146, BOVAG warranty 76,540, 300 kW and up 33,822, seven seats or more 10,438, eight cylinders or more 8,154, 500 km of electric range or more 8,950, within 10 km of Amsterdam centre 5,725, listed in the last day 11,941, Volkswagen 36,471, Volkswagen Golf 6,789. Filters the site accepts and then ignores are not offered at all, and an invalid enum value is rejected with an error instead of silently returning the whole catalogue.
Can I search by source site?
Yes, and this is specific to an aggregator. source_site returns only cars listed on that site — id 2, AutoTrack, covered 213,005 of 348,966 cars. only_source_site returns cars exclusive to one site — 7,700 cars are on AutoTrack and nowhere else, and each of those rows came back with exactly one source, which is how it was verified. exclude_source_site removes a site from every car's group and drops cars that then have no source left: excluding AutoTrack left 341,253 cars and not one of the returned rows still carried it.
How accurate are the prices?
Each car exists twice in the same response: once in Gaspedaal's result data and once in the structured data the page publishes for search engines. The engine reads both on every row, returns price_eur and price_eur_schema, and sets price_conflict when they differ. On a 100-car page checked field by field, price, mileage and door count agreed 100 out of 100, and across 1,800 rows in two acceptance runs price_conflict was never true. The same twin is used to fill in a value Gaspedaal leaves blank in one place but prints in the other — which is how gearbox coverage went from 66 % to 99.7 %.
How complete are the fields?
Counted over 900 rows per run across nine different searches, not assumed. 100 %: ad_id, title, brand, model, price, build year, mileage, listing date, photo and source count. 99.8 % trim, 99.8 % fuel, 99.7 % gearbox, 99.0 % doors, 97.7 % colour, 95.7 % power in kW and hp. Lower, and worth planning around: body style 87.6 % — Gaspedaal leaves it blank on about one ad in eight; cylinder capacity 85.8 %, mostly because electric cars have none. For the seller, town is 99.8 % and province 84.3 %, but the dealer's trading name is published on only about 31 % of ads, so where it is missing the API still returns that dealer's own Gaspedaal page instead (59 % of rows).
How many cars and pages can I get through?
348,966 cars on 2026-10-01, 100 per page, and no artificial ceiling: page 3,490 returned 71 rows and page 3,491 returned none, which matches the stated total. Page size is fixed by the site at 100 and cannot be changed. Nine sort orders: relevance, distance (needs a postcode), price up or down, mileage up or down, year up or down, and newest first.
What does Gaspedaal not publish?
Four things that would be fair to expect and are genuinely absent from this surface: the advert text, the equipment list, the number of previous owners and the APK (Dutch MOT) date. Gaspedaal also has no detail page of its own — the full advert lives on the source sites, which is why the resolved source link matters. There is no phone number, no e-mail address and no private seller's name anywhere in the data, so none is returned. A Dutch licence-plate lookup appears to exist on the site but could not be verified against a known car, so it is not offered rather than offered untested.
How fast is it, and what does resolving the source links cost?
Median 899 ms in one acceptance run and 1,136 ms in the other, over 12 live calls each; the slowest non-resolving call measured 2,967 ms. Resolving the source links is a separate request per link, so it is off by default in search, on by default for a single car, and capped by max_resolved_urls (10 by default, 40 maximum). A search that resolved 12 links took 6.0 s in one run and 9.4 s in the other — anything the call budget cannot finish stays null and is counted in source_urls_unresolved rather than dropped.
What is the Gaspedaal.nl API?
Gaspedaal.nl API is a ReefAPI endpoint group for the dutch car aggregator as json: one car per row, every nl site that lists it attached. It returns live JSON through POST requests under /gaspedaal/v1.
Is the Gaspedaal.nl API free to try?
Yes. ReefAPI starts with 1,000 free credits, no card required. Gaspedaal.nl calls use the same shared credit balance as every other ReefAPI engine.
Do I need a Gaspedaal.nl login or account?
No login to Gaspedaal.nl 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 Gaspedaal.nl data?
The page example is captured from a live search call, and production requests fetch live data through ReefAPI rather than a static sample.