Bilbasen APIbilbasen.dk ↗
Search Denmark's largest car marketplace and retrieve full technical specs. Get listings by make/model, pricing, emissions, battery size, weight, and equipment.
What is the Bilbasen API?
The Bilbasen.dk API provides access to Denmark's largest used car marketplace through 2 endpoints. Use search_listings to query vehicles by make and model, returning up to 30 listings per page with price, mileage, fuel type, and horsepower. Use get_listing_details to pull full technical specifications for any listing, including CO2 emissions, battery capacity, curb weight, MSRP (nypris), dimensions, and a complete equipment list.
curl -X GET 'https://api.parse.bot/scraper/06569b3f-40e4-4862-bce5-18168ec29cac/search_listings?make=tesla&page=1' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace bilbasen-dk-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
"""Walkthrough: Bilbasen SDK — search Danish car listings and inspect specs."""
from parse_apis.bilbasen_dk_car_listings_api import Bilbasen, ListingNotFound
client = Bilbasen()
# Search Tesla listings, capped at 5 results
for listing in client.listings.search(make="tesla", limit=5):
print(listing.make, listing.model, listing.display_price, listing.fueltype)
# Drill into one listing's full technical details
first = client.listings.search(make="bmw", limit=1).first()
if first:
detail = first.details.get()
print(detail.title, detail.listing_price)
print("Battery:", detail.key_specs.battery_capacity)
print("Weight:", detail.key_specs.total_weight)
print("Equipment count:", len(detail.equipment))
# Handle a listing that no longer exists
try:
gone = client.listings.search(make="volvo", limit=1).first()
if gone:
_ = gone.details.get()
except ListingNotFound as exc:
print(f"Listing removed: {exc.listing_url}")
print("exercised: listings.search / details.get / ListingNotFound")
Search car listings on Bilbasen by make and optionally model. Returns up to 30 listings per page with basic info including price, properties (battery, fuel economy, horsepower, mileage, range), and listing URLs for detail lookups. Paginates via integer page counter. Each listing contains enough data for filtering client-side by fuel type, price range, location, etc.
| Param | Type | Description |
|---|---|---|
| make | string | Car make/brand in URL-slug form (e.g., 'bmw', 'tesla', 'volvo', 'mercedes'). Leave empty for all brands. |
| page | integer | Page number (1-based). |
| model | string | Car model in URL-slug form (e.g., 'model-3', '3-serie', 'v60'). Requires make to be set. |
{
"type": "object",
"fields": {
"page": "integer - current page number",
"has_next": "boolean - whether more pages exist",
"listings": "array of listing objects with id, url, make, model, variant, price, display_price, location, mileage, fueltype, hk, and more",
"page_size": "integer - number of listings returned on this page",
"total_hits": "integer - total number of matching listings"
},
"sample": {
"data": {
"page": 1,
"has_next": true,
"listings": [
{
"hk": "498 hk",
"id": 6912527,
"kml": "",
"kmt": "Accel. 4,4 sek",
"url": "https://www.bilbasen.dk/brugt/bil/tesla/model-3/long-range-awd-4d/6912527",
"make": "Tesla",
"moth": "Ejerafgift 920 kr/år",
"doors": 4,
"model": "Model 3",
"price": 194900,
"mileage": "120.000 km",
"trailer": "1.000 kg trækvægt",
"variant": "Long Range AWD 4d",
"fueltype": "El",
"geartype": "Automatisk gear",
"location": {
"lat": 55.461857,
"lon": 8.484388,
"city": "Esbjerg",
"region": "Syd- og Sønderjylland",
"zipCode": 6700
},
"image_url": "https://billeder.bilbasen.dk/bilinfo/30efe052-f7be-4370-a534-de15f86f2cac.jpeg?class=S640X640",
"sale_type": "Detailsalg",
"price_type": "Retail",
"description": "Tesla Model 3 Long Range AWD",
"seller_type": "Forhandler",
"display_price": "194.900 kr",
"original_price": null,
"batterycapacity": "82 kWh batteri",
"electricmotorrange": "Rækkevidde 602 km",
"firstregistrationdate": "2/2022"
}
],
"page_size": 30,
"total_hits": 506
},
"status": "success"
}
}About the Bilbasen API
Search Listings
The search_listings endpoint accepts a make parameter (e.g. bmw, tesla, volvo) and an optional model parameter (e.g. model-3, 3-serie). Results are paginated using a 1-based page parameter. Each response includes total_hits, has_next, and a page_size count alongside the listings array. Each listing object carries an id, url, make, model, variant, price, display_price, location, mileage, fueltype, hk, and any available property fields such as battery range or fuel economy. The url field is what you pass into the detail endpoint.
Listing Details
The get_listing_details endpoint takes a listing_url from the search results and returns the full data for that car. The specifications object contains all key-value technical pairs — model year, mileage, fuel type, range, weight, and dimensions. The key_specs object surfaces the most commonly compared fields directly: emissions_g_per_km, total_weight, empty_weight, and battery_capacity. The equipment array lists all included features as strings, and listing_price gives the current asking price.
Coverage and Data Freshness
Bilbasen is Denmark's primary used-car marketplace, so listings are predominantly Danish inventory priced in Danish kroner. The search_listings endpoint returns live results reflecting the current state of the marketplace. Calling get_listing_details with a listing URL that has since been sold or removed will return an empty or partial response — checking has_next and iterating pages helps build a stable working set before doing bulk detail lookups.
The Bilbasen API is a managed, monitored endpoint for bilbasen.dk — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when bilbasen.dk changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official bilbasen.dk API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Build a price comparison tool for Danish used cars filtered by make and model.
- Track CO2 emissions (
emissions_g_per_km) across EV and ICE listings to support green vehicle research. - Aggregate battery capacity and range data from
key_specsto compare electric vehicles on the Danish market. - Monitor MSRP (
nypris) vs. currentlisting_priceto identify depreciation patterns by brand. - Compile full equipment lists from
get_listing_detailsto match buyer feature requirements against live inventory. - Enumerate
total_hitsper make/model combination to analyze inventory depth on the Danish market. - Feed curb weight and dimension data from
specificationsinto logistics or transport planning tools.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Bilbasen have an official developer API?+
What does `search_listings` return when no `make` is specified?+
make empty returns listings across all brands on the marketplace, paginated at up to 30 results per page. You can narrow results by supplying both make and model, but model requires make to be set first. The total_hits field tells you how many total results match the query.Are new-car (dealer stock) listings covered, or only used cars?+
specifications object includes nypris (MSRP) as a reference field, but the marketplace itself focuses on used-car listings. You can fork this API on Parse and revise it to target a different listing segment or a new-car source if needed.Can I filter listings by price range, fuel type, or mileage in the search endpoint?+
search_listings endpoint currently supports filtering by make and model only. Filtering by price, mileage, or fuel type is not a built-in parameter. You can fork this API on Parse and revise it to add those filter parameters.What happens if a listing URL is no longer active when I call `get_listing_details`?+
get_listing_details will return an empty or partial response for that URL. It is worth validating listings freshly from search_listings before making bulk detail calls, since marketplace inventory changes continuously.