# Blocket API — Nordic second-hand classifieds (Blocket Sweden, FINN Norway, Tori Finland, DBA Denmark): search listings, read the full listing and browse categories, in local currency. No account, no browser.

> Search second-hand listings on Blocket (se), FINN (no), Tori (fi) or DBA (dk) by keyword, category or region: listing id, title, price in local currency (null for give-aways), free/give-away flag, municipality, publication time, private or business seller, shipping and buy-now availability, brand, images and attributes, with the true total and category/region counts. Filter by price, condition, seller type, ad type, shipping and ads published today; sort by relevance, newest or price.
> ReefAPI engine `blocket` · 3 endpoints · clean JSON, no scraping or browsers to manage.

## How to call
- **Endpoint:** `POST https://api.reefapi.com/blocket/v1/<action>` with a JSON body.
- **Auth:** header `x-api-key: <YOUR_REEFAPI_KEY>` — create one free (1,000 credits, no card): https://reefapi.com/signup
- **Response (every call):** `{ ok: boolean, data: ..., meta: { record_count, credits, ... }, error: { code, message } }` — branch on `ok`. Failed calls are free.
- **One key + one shared credit pool** across every ReefAPI API. Per-call credits are listed on each endpoint below.
- **Use it from an AI agent (MCP):** connect `https://api.reefapi.com/mcp` (remote streamable-http). Clients that add connectors by URL, such as ChatGPT and the Claude app, connect with OAuth 2.1 (the user pastes their key once on a ReefAPI page; discovery at `/.well-known/oauth-protected-resource/mcp`). Config files send the key as `Authorization: Bearer <key>`. `?key=<key>` in the URL also works as a last-resort fallback.

## Endpoints

### POST https://api.reefapi.com/blocket/v1/search — 1 credit
Search second-hand listings on Blocket (se), FINN (no), Tori (fi) or DBA (dk) by keyword, category or region: listing id, title, price in local currency (null for give-aways), free/give-away flag, municipality, publication time, private or business seller, shipping and buy-now availability, brand, images and attributes, with the true total and category/region counts. Filter by price, condition, seller type, ad type, shipping and ads published today; sort by relevance, newest or price.

**Parameters:**
- `query` (string, optional) — Keyword, in the site's language (cykel, sykkel, polkupyörä, cykel). Optional when `category` or `location` is given.
- `country` (enum, optional, default "se") — Which Nordic marketplace: se = Blocket, no = FINN torget, fi = Tori, dk = DBA. Prices come back in that country's currency; listing ids belong to one site. [one of: se, no, fi, dk]
- `category` (string, optional) — Category code from `categories` or a search's `category_facets` — 0.<id> (top level, e.g. 0.69 sport), 1.<id>.<id> (sub-category) or 2.<id>.<id>.<id> (leaf, e.g. 2.69.3963.257 bicycles). The codes are shared by all four sites; the names are localised.
- `location` (string, optional) — Region code from a search's `region_facets` (e.g. 0.300001 Stockholm on Blocket, 0.20003 Akershus on FINN). Region codes are per country.
- `page` (integer, optional, default 1) — Result page, 1-50 (53 listings per page). The sites stop at page 50 whatever the total.
- `sort` (enum, optional, default "relevance") — Order of results. Anything else is rejected (the sites silently fall back to relevance). [one of: relevance, newest, price_asc, price_desc]
- `price_min` (integer, optional) — Lowest price, whole units of the country's currency.
- `price_max` (integer, optional) — Highest price, whole units of the country's currency.
- `condition` (enum, optional) — Item condition, on the sites' shared five-step scale. [one of: new, like_new, good, fair, needs_repair]
- `seller_type` (enum, optional) — Only private sellers or only businesses. [one of: private, business]
- `listing_type` (enum, optional) — Kind of ad. Give-away ads have no price. [one of: sell, give_away, wanted]
- `shipping` (enum, optional) — Only ads that can be shipped through the site's own delivery service, or only free shipping. [one of: shipping, free_shipping]
- `published_today` (boolean, optional) — Only ads published today.
- `max_rotations` (integer, optional, default 3) — Advanced: how many times to retry a difficult request (1-5).

**Returns:** results[]{listing_id, title, url, price (number, null when none is published or the ad is a give-away), currency, is_free, listing_type (sell|give_away|wanted), listing_type_label, location (municipality), coordinates{lat, lon} (the ad's map position as the site publishes it, private and business sellers alike; null when the site has none), listed_at (ISO, UTC), seller_type (private|business), seller_name (businesses only — the site publishes no name for private sellers), brand, shipping_available, buy_now, free_shipping, image, images[], image_count, attributes[]{id, label (the site's own label; null only when the site names it nowhere), value}, labels[]}, count, total_results, page, last_page, has_more, sort_applied, filters_applied[]{filter, label, values}, category_facets[]{category, name, count}, region_facets[]{location, name, count}, country, site, currency, query

**Example request body:**
```json
{
  "query": "cykel",
  "country": "se"
}
```

### POST https://api.reefapi.com/blocket/v1/listing — 1 credit
The full listing by id or URL: title, full description, price and currency, give-away flag, status (active or sold), condition on the five-step scale, category path with its search code, all attributes (size, brand, model…), every image with dimensions, postal code, city and map position, last-edited time, shipping and buy-now availability, and the seller — for businesses the shop name, organisation id, company registry link, address, phone, website and their other listings; for private sellers the seller type and the site's seller id (the sites show no private seller name to logged-out visitors).

**Parameters:**
- `listing_id` (string, required) — Listing id (the number at the end of …/recommerce/forsale/item/26612110) or the full listing URL — a URL also sets the country.
- `country` (enum, optional, default "se") — Which Nordic marketplace: se = Blocket, no = FINN torget, fi = Tori, dk = DBA. Prices come back in that country's currency; listing ids belong to one site. [one of: se, no, fi, dk]
- `max_rotations` (integer, optional, default 3) — Advanced: how many times to retry a difficult request (1-5).

**Returns:** listing{listing_id, title, url, status (active|sold|inactive), status_label (the site's own text for a sold ad, e.g. "Såld"; null for active and inactive ads — the site prints no status text for them), price (null for give-aways or when none is published), currency, is_free, listing_type, listing_type_label, condition{code (new|like_new|good|fair|needs_repair), label, value_id}, description (as written by the seller), category, category_path[]{id, name}, category_search_code, attributes[]{id, label, value, value_id}, images[]{url, width, height}, image_count, location{postal_code, city, country_code, street_address, lat, lon} (as the site publishes them; null when absent), edited_at, seller{type, id, name (businesses), organisation_id, shop_url, website_url, company_registry_url, logo_url, address{street, city, postal_code}, verified_identity, has_phone, phone (the business shop's phone), selling_points[]}, shipping{shipping_available, buy_now, free_shipping}, is_webstore, seller_other_listings[]{listing_id, title, price, location, url, image}, country, site}

**Example request body:**
```json
{
  "listing_id": "26612110"
}
```

### POST https://api.reefapi.com/blocket/v1/categories — 1 credit
The marketplace category tree of one site with live listing counts — three levels, each node with the code to pass as `category` to search. Optionally counted for a keyword.

**Parameters:**
- `country` (enum, optional, default "se") — Which Nordic marketplace: se = Blocket, no = FINN torget, fi = Tori, dk = DBA. Prices come back in that country's currency; listing ids belong to one site. [one of: se, no, fi, dk]
- `query` (string, optional) — Optional keyword: counts are then for that keyword.
- `max_rotations` (integer, optional, default 3) — Advanced: how many times to retry a difficult request (1-5).

**Returns:** categories[]{category, name, count, level, search_param, children[]}, count, total_results, region_facets[]{location, name, count}, country, site, query

**Example request body:**
```json
{
  "country": "se"
}
```

## At scale
- **Volume:** 5M+ requests a day, measured at 60 requests a second across the fleet with no
  central bottleneck. Per-key limits are raised for high-volume accounts; volume pricing on request.
- **Missing a source:** tell us a site we do not cover and it becomes an engine. A customer asked
  for bestprice.gr on 21 Sep 2026 and it was in the catalog on 22 Sep.
- **Support:** 2 minute median time from a question in the live chat to the first answer. Setup
  help included, no support tier to buy.
- **One key, one credit pool** across every API. No per-site plans, no separate subscriptions.

## More
- Try it live, no code: https://reefapi.com/playground?engine=blocket
- Human docs page: https://reefapi.com/docs/blocket
- Overview page: https://reefapi.com/blocket-api
- Every ReefAPI API in one file (for your AI): https://reefapi.com/llms-full.txt

## Questions developers ask about Blocket data

### Is there an official Blocket API, and do I still need the token from the Bevakningar page?

Blocket offers no open API for reading listings, so developers have relied on the unofficial Python client blocket_api, which used to ask for a token copied from the Bevakningar (saved searches) page. Its maintainer now says in the project's GitHub issues that the token is gone: since Blocket rebuilt its site, only public calls that need no login still work.

ReefAPI's Blocket API needs neither a Blocket account nor a token. Send a keyword to `search` with your ReefAPI key and you get Blocket's listings as JSON: id, title, price in SEK, municipality, publication time, private or business seller, and whether the ad can be shipped or bought directly. The same API reads FINN (Norway), Tori (Finland) and DBA (Denmark) through `country`.

```
curl -X POST https://api.reefapi.com/blocket/v1/search \
  -H "x-api-key: $REEF_KEY" -H "content-type: application/json" \
  -d '{"query":"tamagotchi"}'
```

Real response, 2 Nov 2026: total_results 6 · "Tamagotchi Connection V4.5 Orange Stars" 699 SEK, Saltsjö-Boo, private, shipping_available true, buy_now true · "Original Tamagotchi Gen 2 Bandai - Flower Perfume" 200 SEK, Uppsala

### My Blocket scraper broke after the site redesign and the search endpoint returns 404. How do I get listings now?

Users of blocket_api reported in its GitHub issues that the client stopped working after Blocket's new site launched; the maintainer found that almost every endpoint and filter constant had changed, and a later fix was needed when the search call began answering `404 Not Found`.

With ReefAPI's Blocket API your code calls one endpoint and reads the same fields (`results`, `total_results`, `has_more`) every time, so a change on Blocket's side does not reach your parser. It covers Blocket's general marketplace (Torget); car, boat and motorcycle ads sit in Blocket's separate vehicle section, which this API does not search.

```
curl -X POST https://api.reefapi.com/blocket/v1/search \
  -H "x-api-key: $REEF_KEY" -H "content-type: application/json" \
  -d '{"query":"saab"}'
```

Real response, 2 Nov 2026: total_results 678 · 13 pages of 53 · "Sufflett cab för SAAB 9-3 2004-2011" 17500 SEK, business "Top´n Trim Shop" · "Beg.bildelar Saab 96 v4" 200 SEK, private · category_facets "Fordonstillbehör" 500

### How do I get notified about new Blocket ads faster than Blocket's own saved-search alerts?

Developers have built Blocket watchers since at least 2007: Swedish SweClockers forum threads ask how to poll a search every few minutes and e-mail the new ads, and one Python project on GitHub was written because, its author says, Blocket's own alert arrived about 30 minutes after an ad was posted.

With ReefAPI's Blocket API, poll a search with `sort: newest` and `published_today: true`, keep the `listing_id`s you have already seen, and alert on the rest. `listed_at` is the time Blocket (re)published the ad, so compare ids, not timestamps; add `seller_type: private` to leave out shops.

```
import requests

seen = set()  # load from your database between runs
r = requests.post(
    "https://api.reefapi.com/blocket/v1/search",
    headers={"x-api-key": REEF_KEY},
    json={"query": "gitarr", "sort": "newest", "published_today": True, "seller_type": "private"},
)
for ad in r.json()["data"]["results"]:
    if ad["listing_id"] not in seen:
        seen.add(ad["listing_id"])
        print(ad["listed_at"], ad["price"], ad["title"], ad["url"])
```

Real response, 2 Nov 2026: total_results 133 from private sellers today · newest "Nintendo Wii med 15 spel, gitarrer och trumset" 1500 SEK, Öjersjö, listed_at 2026-11-02T22:30:36Z · "Boss FS-6 Dual Foot Switch" 550 SEK · "Gitarr" 2900 SEK, Vimmerby

### How do I filter a Blocket search by category, region and price now that the filters are codes like 0.300001?

When Blocket moved to its new site, the blocket_api maintainer noted that the filter constants had changed from names such as `audi` to numeric codes of the form `0.XXX`, which is why old category and region lists stopped matching.

ReefAPI's Blocket API returns those codes for you: `categories` gives Blocket's three-level category tree with live counts and the code for each node, and every search returns `region_facets` with the code of each Swedish county (Stockholm is `0.300001`). Pass them as `category` and `location`, with `price_min` and `price_max` in whole kronor.

```
curl -X POST https://api.reefapi.com/blocket/v1/search \
  -H "x-api-key: $REEF_KEY" -H "content-type: application/json" \
  -d '{"category":"2.93.3904.66","location":"0.300001","price_max":5000,"sort":"price_desc"}'
```

Real response, 2 Nov 2026: categories: 11 top-level, Systemkameror = 2.93.3904.66 · search: total_results 362 · "Canon EOS 850D digital systemkamera" 5000 SEK, Skärholmen · "Sony ZV-E10 vloggingkamera - Nyskick" 4999 SEK · filters_applied Systemkameror, Stockholm, "Upp till 5 000 kr"

### How do I get the full Blocket ad (description, condition, all images) from a listing ID?

Getting one ad by its id was among the first features users asked of blocket_api, and after the redesign its users asked in the issues where the API behind the new ad page was, after old endpoints answered 404 for new ad ids.

ReefAPI's Blocket API `listing` takes the id or the full blocket.se link and returns the whole ad: description, condition on Blocket's five-step scale, category path, attributes, every image with its size on images.blocketcdn.se, postal code and town, last-edited time, and whether it ships or can be bought directly. For a private seller there are no contact details: the seller type, the site's seller id and the ad's map coordinates are returned, the name is not, because Blocket does not show it.

```
curl -X POST https://api.reefapi.com/blocket/v1/listing \
  -H "x-api-key: $REEF_KEY" -H "content-type: application/json" \
  -d '{"listing_id":"27812082"}'
```

Real response, 2 Nov 2026: "Canon EOS 850D digital systemkamera" · 5000 SEK · status active · condition like_new "Mycket bra skick - som ny" · Elektronik och vitvaror › Foto och video › Systemkameror · 5 images 3060×3060 · 12735 Skärholmen · shipping_available true, buy_now true

### How do I find Blocket ads from businesses (företag) and the shop behind them?

blocket_api users asked for a dealer and store search; its maintainer replied that on the new Blocket a shop can only be looked up by its id, not searched by name.

In ReefAPI's Blocket API, `seller_type: business` returns only shop ads, each row with the shop name in `seller_name`. Open any of them with `listing` and the `seller` object gives the shop's organisation id, its Blocket shop page, website and address, plus up to 10 of its other ads in `seller_other_listings`.

```
curl -X POST https://api.reefapi.com/blocket/v1/listing \
  -H "x-api-key: $REEF_KEY" -H "content-type: application/json" \
  -d '{"listing_id":"https://www.blocket.se/recommerce/forsale/item/27929479"}'
```

Real response, 2 Nov 2026: search gitarr + seller_type business: total_results 1287 · listing 27929479 "Martin 000-18 Standard Reimagined 2019" 28500 SEK · seller "Guitar Heroes", organisation_id 9032427, shop_url blocket.se/shop/guitar-heroes, verified_identity true · 10 other listings, e.g. "Martin D-45 Standard (Pre-owned) 2008" 85000 SEK