{ "name": "Blocket Vehicle Listings API", "description": "Car listings from Blocket.se search results, with title, price, year, mileage, location, image and listing link.", "api_id": "generated_c339677c254f69a380ef3a54", "slug": "blocket-vehicle-listings-api", "source": { "name": "Blocket", "domain": "blocket.se", "url": "https://www.blocket.se/" }, "category": "commerce", "countries": [ "SE" ], "languages": [ "sv" ], "record_types": [], "tags": [], "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." ], "updated": "2026-10-30", "note": "Sample records are saved samples, not a live run. CleanedWeb is not affiliated with the source.", "endpoints": [ { "endpoint_id": "generated_c339677c254f69a380ef3a54_search", "name": "Extract records", "description": "Return records within the accepted scope.", "definition_version": "fcf052e1170dbe603b3a5e913979828b3c2843f6010d80516aa9f3d172e83762", "method": "POST", "path": "/v1/catalog/public/apis/generated_c339677c254f69a380ef3a54/endpoints/generated_c339677c254f69a380ef3a54_search/run", "url": "https://broker.cleanedweb.com/v1/catalog/public/apis/generated_c339677c254f69a380ef3a54/endpoints/generated_c339677c254f69a380ef3a54_search/run", "authentication": { "type": "bearer", "scheme": "Authorization: Bearer ", "scope": "run", "note": "Reading this file and the live catalog needs no credential. A run needs a CleanedWeb account and uses the credits of its workspace.", "docs": "https://cleanedweb.com/docs/run-catalog-api/" }, "required_headers": [ { "name": "Authorization", "value": "Bearer YOUR_API_KEY", "description": "An API key with the run scope." }, { "name": "Idempotency-Key", "value": "UNIQUE_REQUEST_ID", "description": "Required. Save it before you send; reuse it only to retry the same request and to read the result. 1-200 characters: letters, numbers, . _ : -" }, { "name": "Content-Type", "value": "application/json", "description": "The body is JSON." } ], "request_body": { "input": "An object that follows input_schema.", "max_items": "Optional. Stop after this many records.", "timeout_seconds": "Optional, 60-86400, default 10800.", "wait_seconds": "Optional, 0-86400, default 90. How long the request waits before answering 202." }, "input_schema": { "type": "object", "properties": { "enrich_records": { "type": "boolean", "default": true, "description": "true: read each returned record's product/detail page and merge its fields into the record. false: return list/search-level fields only, with no detail page reads. Every returned record's detail page is read within the run's time budget; records the time budget leaves unread are returned without detail fields, and summary.record_enrichment reports how many records were enriched and why any were not (run_time_budget). Detail fields are optional." } }, "required": [], "additionalProperties": false }, "output_schema": { "type": "object", "additionalProperties": true, "required": [ "title", "url" ], "properties": { "date": { "type": "string", "format": "date", "x-precision": "day", "description": "ISO 8601 value computed from the source's relative date text (such as '3 months ago') at delivery time; precise to about one day." }, "price": { "type": "integer", "description": "Numeric reading of source text such as '100 000 kr' (suffix 'kr' removed)" }, "title": { "type": "string" }, "url": { "type": "string", "format": "uri" }, "currency": { "type": "string" }, "brand": { "type": "string" }, "condition": { "type": "string" }, "image_url": { "type": "string" }, "availability": { "type": "string" }, "ad_type": { "type": "integer" }, "association_memberships": { "type": "array", "items": { "type": "string" } }, "dealer_group_id": { "type": "string" }, "dealer_segment": { "type": "string" }, "flags": { "type": "array", "items": { "type": "string" } }, "fuel": { "type": "string" }, "image_aspect_ratio": { "type": "number" }, "image_height": { "type": "integer" }, "image_path": { "type": "string" }, "image_urls": { "type": "array", "items": { "type": "string" } }, "image_width": { "type": "integer" }, "location": { "type": "string" }, "main_search_key": { "type": "string" }, "mileage": { "type": "integer" }, "mileage_unit": { "type": "string" }, "model": { "type": "string" }, "model_specification": { "type": "string" }, "org_id": { "type": "string" }, "organisation_name": { "type": "string" }, "price_unit": { "type": "string" }, "registration_class_id": { "type": "string" }, "registration_class_value": { "type": "string" }, "series": { "type": "string" }, "service_documents": { "type": "array", "items": { "type": "string" } }, "timestamp": { "type": "integer" }, "transmission": { "type": "string" }, "type": { "type": "string" }, "year": { "type": "string" }, "id": { "type": "string" }, "description_intro": { "type": "string" }, "category": { "type": "string" }, "category_path": { "type": "array", "items": { "type": "string" } } } }, "output_schema_note": "Some fields the source returns are not published here (identifiers, personal details and page-building noise). A record can carry fields this schema does not list, so additionalProperties is true. Do not reject a record for an extra field. The live contract, linked as live_contract, lists every field the saved definition declares.", "examples": [ { "kind": "saved_validation_records", "saved_at": "2026-10-26T05:46:46.900Z", "live_verified": false, "request": { "input": {} }, "records_shown": 2, "records_saved": 2, "records": [ { "date": "2026-11-03", "title": "Abarth 595", "price": 174800, "currency": "SEK", "brand": "Abarth", "model": "595", "year": "2019", "mileage": 5783, "fuel": "Bensin", "transmission": "Automatisk", "location": "Bromma", "url": "https://www.blocket.se/mobility/item/26615412" }, { "date": "2026-11-03", "title": "Abarth 595", "price": 149800, "currency": "SEK", "brand": "Abarth", "model": "595", "year": "2019", "mileage": 8712, "fuel": "Bensin", "transmission": "Manuell", "location": "Bromma", "url": "https://www.blocket.se/mobility/item/26992553" } ] } ], "request_example": { "body": { "input": {}, "max_items": 25 }, "curl": "curl -X POST https://broker.cleanedweb.com/v1/catalog/public/apis/generated_c339677c254f69a380ef3a54/endpoints/generated_c339677c254f69a380ef3a54_search/run \\\n -H \"Authorization: Bearer YOUR_API_KEY\" \\\n -H \"Idempotency-Key: UNIQUE_REQUEST_ID\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\n \"input\": {},\n \"max_items\": 25\n}'" }, "result": { "method": "GET", "url": "https://broker.cleanedweb.com/v1/catalog/public/apis/generated_c339677c254f69a380ef3a54/endpoints/generated_c339677c254f69a380ef3a54_search/result", "note": "A run that does not end within wait_seconds answers 202. Read the result with the same API key and the same Idempotency-Key." }, "links": { "page": "https://cleanedweb.com/catalog/blocket-vehicle-listings-api/", "markdown": "https://cleanedweb.com/catalog/blocket-vehicle-listings-api/index.md", "live_contract": "https://app.cleanedweb.com/api/catalog/apis/generated_c339677c254f69a380ef3a54/endpoints/generated_c339677c254f69a380ef3a54_search/contract", "run_docs": "https://cleanedweb.com/docs/run-catalog-api/" } } ], "links": { "page": "https://cleanedweb.com/catalog/blocket-vehicle-listings-api/", "markdown": "https://cleanedweb.com/catalog/blocket-vehicle-listings-api/index.md", "contract": "https://cleanedweb.com/catalog/blocket-vehicle-listings-api/contract.json", "catalog": "https://cleanedweb.com/catalog/", "index": "https://cleanedweb.com/catalog/index.json", "openapi": "https://cleanedweb.com/catalog/openapi.json" } }