About this API
Blocket is a large Swedish classifieds site. This API reads its car listings and returns a record for each ad: title, price, currency, brand, model, year, mileage, fuel, transmission, location and link.
The sample on this page leaves out registration numbers, chassis numbers and seller details, but runs return them. The API has no make or model filter, so filter the records you get back.
Typical uses
- Compare asking prices and mileage across the listings a run returns.
- Track how asking prices change over time.
What you get
| Field | Type | Sample value |
|---|---|---|
title |
string | Abarth 595 |
price |
integer | 174800 |
currency |
string | SEK |
brand |
string | Abarth |
model |
string | 595 |
year |
string | 2019 |
mileage |
integer | 5783 |
fuel |
string | Bensin |
All 41 fields
Key fields
titlepricecurrencybrandmodelyearmileagefueltransmissionlocationdateurl
Technical fields
conditionimage_urlavailabilityad_typeassociation_membershipsdealer_group_iddealer_segmentflagsimage_aspect_ratioimage_heightimage_pathimage_urlsimage_widthmain_search_keymileage_unitmodel_specificationorg_idorganisation_nameprice_unitregistration_class_idregistration_class_valueseriesservice_documentstimestamptypeiddescription_introcategorycategory_path
Every field with its type, and the schemas, are in contract.json.
Sample records
2 saved records. This is a saved sample, not a live run.
title |
price |
currency |
brand |
model |
year |
|---|---|---|---|---|---|
| Abarth 595 | 174800 | SEK | Abarth | 595 | 2019 |
| Abarth 595 | 149800 | SEK | Abarth | 595 | 2019 |
Scroll sideways to see more columns.
Inputs
This API has no filters. A run reads the whole collection.
enrich_records is on by default and adds the fields that only appear on each record's detail page. Send false to read list fields only. See Run an API.
Request
POST https://broker.cleanedweb.com/v1/catalog/public/apis/generated_c339677c254f69a380ef3a54/endpoints/generated_c339677c254f69a380ef3a54_search/run
curl -X POST https://broker.cleanedweb.com/v1/catalog/public/apis/generated_c339677c254f69a380ef3a54/endpoints/generated_c339677c254f69a380ef3a54_search/run \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Idempotency-Key: UNIQUE_REQUEST_ID" \
-H "Content-Type: application/json" \
-d '{
"input": {},
"max_items": 25
}'Save the Idempotency-Key before you send, and reuse it only to retry the same request. The key needs the run scope. See Run a catalog API.
Coverage
- Category
- Commerce
- Countries
- Sweden
- Languages
- Swedish
Limitations
- There is no make or model filter.
- The saved sample covers one make.
- Year is returned as text, such as "2019", not as a number.
Reach. A run reads until the source ends or your max_items, timeout_seconds or budget stops it.
CleanedWeb is not affiliated with Blocket.