Looking for the overview — what this API returns, what it costs, and a call you can run without a key? See the Blocket API page →
Classifieds & Second-hand

Blocket API & Scraper

The Blocket API returns the Nordic second-hand marketplaces as clean JSON from one engine: Blocket in Sweden (SEK), FINN torget in Norway (NOK), Tori in Finland (EUR) and DBA in Denmark (DKK), switched with one country parameter.

3 actionsLive JSON1,000 free credits$0.67–$1.50 / 1,000 creditsMCP-ready
Get a free keyOpen in playground

🤖 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.

search returns 53 listings per call with the listing id, title, price, a give-away flag, the municipality, when the ad was published, private or business seller, whether it can be shipped or bought directly, brand, photos and attributes, plus the true total and category and region counts - filtered by keyword, category, region, price, condition, seller type, ad type, shipping and ads published today, sorted by relevance, newest or price. listing returns the full ad: description, condition on the sites' shared five-step scale, the category path, every attribute, every photo, postal code and city, when it was last edited, whether it is still for sale or sold, shipping options, map position, and for business sellers the shop name, organisation id, company registry link, address, phone and their other listings. categories returns the three-level category tree with live counts and the code search filters on. Verification on 2026-09-15 covered 17 listings across bicycles, sofas, phones and children's clothes in all four countries: price matched the listing's own structured data on 16 of 16 and the search row on 17 of 17, and title matched the page heading on 17 of 17. No account, no browser - one ReefAPI key and the standard { ok, data, meta, error } envelope.

Reference

A price of 0 is not a price - how a Nordic listing really reads

On all four sites a give-away ad is stored with a price of zero, and a for-sale ad can have no price at all. Averaging those rows drags every price series down, and a sold ad still shows its old price. This engine returns price as null when there is no real asking price, flags give-aways with is_free, and marks sold ads with status.

Listing (measured 2026-09-15)What the site storespriceis_free / status
Blocket, 'Cykel bortskänkes' (given away)price 0 in search, no price on the adnullis_free true
DBA, bicycle ad 'Til salg' with no priceprice 0 in searchnullis_free false
Blocket, 'Tärnö bord och stolar' (sold)price 200 kr still shown200status sold
Blocket, 'Custom Beach Cruiser cykel'price 1 400 kr1400is_free false, status active

On one Blocket page for 'cykel' sorted by lowest price, all 28 zero-price rows were give-aways, and they come first. A search filtered to give-aways returned 48 ads, every one with price null and is_free true.

Live example

Real request and response JSON

Captured from the indexed primary action, search, on .

Captured request
{
  "method": "POST",
  "url": "https://api.reefapi.com/blocket/v1/search",
  "headers": {
    "x-api-key": "$REEF_KEY",
    "content-type": "application/json"
  },
  "body": {
    "query": "cykel",
    "country": "se"
  }
}
Captured response
{
  "ok": true,
  "meta": {
    "api": "blocket",
    "endpoint": "search",
    "mode": "live",
    "latency_ms": 650.1,
    "record_count": 53,
    "bytes": 339254,
    "cache_hit": false,
    "pagination": {
      "page": 1,
      "has_more": true,
      "page_size": 53,
      "total": 17732
    },
    "country": "se"
  },
  "data": {
    "results": [
      {
        "listing_id": "26636833",
        "title": "Retro cykel",
        "url": "https://www.blocket.se/recommerce/forsale/item/26636833",
        "price": 1500,
        "currency": "SEK",
        "is_free": false,
        "listing_type": "sell",
        "listing_type_label": "Säljes",
        "location": "Söråker",
        "coordinates": {
          "lat": 62.50412,
          "lon": 17.48707
        },
        "listed_at": "2026-09-16T12:30:19Z",
        "seller_type": "private",
        "seller_name": null,
        "brand": null,
        "shipping_available": false,
        "buy_now": false,
        "free_shipping": false,
        "image": "https://images.blocketcdn.se/dynamic/default/item/26636833/5a10b2c9-368f-41f3-a7ab-0eb9417d9bd8",
        "images": [
          "https://images.blocketcdn.se/dynamic/default/item/26636833/5a10b2c9-368f-41f3-a7ab-0eb9417d9bd8",
          "https://images.blocketcdn.se/dynamic/default/item/26636833/fe88b171-4bb7-40ef-9c09-01ec70e33fdd",
          "https://images.blocketcdn.se/dynamic/default/item/26636833/cd6453f4-034a-4f19-bc4f-f36123a01774"
        ],
        "image_count": 4,
        "attributes": null,
        "labels": [
          "Privat"
        ]
      },
      {
        "listing_id": "26633506",
        "title": "Cykel Kronan 3 växlad unisexcykel",
        "url": "https://www.blocket.se/recommerce/forsale/item/26633506",
        "price": 3000,
        "currency": "SEK",
        "is_free": false,
        "listing_type": "sell",
        "listing_type_label": "Säljes",
        "location": "Halmstad",
        "coordinates": {
          "lat": 56.67437,
          "lon": 12.85567
        },
        "listed_at": "2026-09-16T10:38:48Z",
        "seller_type": "private",
        "seller_name": null,
        "brand": "Monark",
        "shipping_available": false,
        "buy_now": false,
        "free_shipping": false,
        "image": "https://images.blocketcdn.se/dynamic/default/item/26633506/70fb52af-6b13-4e1e-9e01-cfd306cb6d9e",
        "images": [
          "https://images.blocketcdn.se/dynamic/default/item/26633506/70fb52af-6b13-4e1e-9e01-cfd306cb6d9e"
        ],
        "image_count": 1,
        "attributes": null,
        "labels": [
          "Privat"
        ]
      },
      {
        "listing_id": "26632897",
        "title": "Monark trehjuling cykel 20\" blå unisex",
        "url": "https://www.blocket.se/recommerce/forsale/item/26632897",
        "price": 3150,
        "currency": "SEK",
        "is_free": false,
        "listing_type": "sell",
        "listing_type_label": "Säljes",
        "location": "Svalöv",
        "coordinates": {
          "lat": 55.92477,
          "lon": 13.16728
        },
        "listed_at": "2026-09-16T10:13:35Z",
        "seller_type": "private",
        "seller_name": null,
        "brand": "Monark",
        "shipping_available": false,
        "buy_now": false,
        "free_shipping": false,
        "image": "https://images.blocketcdn.se/dynamic/default/item/26632897/6d2444b0-2ada-4891-948d-070bdc915b09",
        "images": [
          "https://images.blocketcdn.se/dynamic/default/item/26632897/6d2444b0-2ada-4891-948d-070bdc915b09",
          "https://images.blocketcdn.se/dynamic/default/item/26632897/6bb993da-b397-4ff5-9404-cc77b3c49d14",
          "https://images.blocketcdn.se/dynamic/default/item/26632897/62f6171b-8404-4eb9-9514-8f55603d3909"
        ],
        "image_count": 3,
        "attributes": null,
        "labels": [
          "Privat"
        ]
      }
    ],
    "count": 53,
    "total_results": 17732,
    "page": 1,
    "last_page": 50,
    "has_more": true,
    "sort_applied": "relevance",
    "filters_applied": null,
    "category_facets": [
      {
        "category": "0.91",
        "name": "Affärsverksamhet",
        "count": 27
      },
      {
        "category": "0.67",
        "name": "Bygg och trädgård",
        "count": 96
      },
      {
        "category": "0.77",
        "name": "Djur och tillbehör",
        "count": 41
      }
    ],
    "region_facets": [
      {
        "location": "0.300010",
        "name": "Blekinge",
        "count": 280
      },
      {
        "location": "0.300020",
        "name": "Dalarna",
        "count": 461
      },
      {
        "location": "0.300009",
        "name": "Gotland",
        "count": 83
      }
    ],
    "country": "se",
    "site": "Blocket",
    "currency": "SEK",
    "query": "cykel"
  }
}
Actions

What the Blocket API does

ActionDescriptionConcrete use caseKey params
searchSearch 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.Price-intelligence teams call search to search second-hand listings on Blocket (se), FINN (no), Tori (fi) or DBA (dk) by keyword, cat….query, country, category, location, page, ...
listingThe 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).Classifieds aggregators call listing to get the full listing by id or URL.listing_id, country, max_rotations
categoriesThe 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.Resale and arbitrage tools call categories to get the marketplace category tree of one site with live listing counts.country, query, max_rotations
Code samples

Call search from your stack

curl -X POST https://api.reefapi.com/blocket/v1/search \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{"query":"cykel","country":"se"}'
MCP one-liner
Ask your MCP-connected assistant: call reefapi.blocket.search with {"query":"cykel","country":"se"}.
Use cases

Who uses this API and why

  • Resale and price-intelligence teams track second-hand prices per category in Sweden, Norway, Finland and Denmark with search sorted by newest.
  • Recommerce and refurbishment businesses watch give-away and low-price ads in their region with listing_type, location and price filters.
  • Market analysts size supply per category and region from total_results, category_facets and region_facets without paging through ads.
  • Dealers monitor business competitors' stock and prices through listing's seller block and the shop's other listings.
FAQ

Questions developers ask before integrating

Which sites and countries does the Blocket API cover?

Four marketplaces that share one platform: country=se is Blocket (Sweden, SEK), no is FINN torget (Norway, NOK), fi is Tori (Finland, EUR) and dk is DBA (Denmark, DKK). site=blocket, finn, tori or dba works too, and a pasted listing URL picks the country by itself. The response fields are identical on all four; titles, labels and category names come back in the site's language.

Why is price null on some listings?

Because the site has no asking price for them. Give-away ads are stored with a price of zero; they come back as price null with is_free true and listing_type give_away. A few for-sale ads also have no price, and they come back as price null with is_free false. A zero is never returned as a price, so an average over price never includes free items.

Does the API show sold listings?

A sold ad can stay online with its old price. listing returns status sold (with the site's own label, such as Såld) instead of active, so a stale price is never read as a live offer. search returns ads that are currently listed.

Can I get the seller's name and phone number?

For business sellers, listing returns the shop name, organisation id, a link to the national company registry, address, phone number, website and the shop's other listings. For private sellers the sites do not show a name to visitors, so seller.name is null; the seller type and the site's seller id are returned. Descriptions come back as the seller wrote them.

How do category codes work?

Codes look like 0.69 (Sport and outdoor), 1.69.3963 (Cycling) and 2.69.3963.257 (Bicycles), and the same code means the same category on all four sites. The categories action returns the whole three-level tree with live counts, every search returns category_facets, and listing returns category_search_code for the ad's own category.

How deep can I page?

53 listings per page and up to 50 pages per query - the sites stop there even when total_results is larger (17,660 bicycles for 'cykel' on Blocket on 2026-09-15). Narrow the query with category, location, price or published_today to reach the rest.

What do the sites NOT publish?

The original creation date on the ad page (listing returns edited_at; search returns listed_at, the time the ad was published or renewed), a private seller's name, a view count, and a shipping price before checkout. Condition is optional for sellers: 14 of 17 verified listings had one, and some business shops leave it out.

What is the Blocket API?

Blocket API is a ReefAPI endpoint group for nordic second-hand listings from blocket, finn, tori and dba. It returns live JSON through POST requests under /blocket/v1.

Is the Blocket API free to try?

Yes. ReefAPI starts with 1,000 free credits, no card required. Blocket calls use the same shared credit balance as every other ReefAPI engine.

Do I need a Blocket login or account?

No login to Blocket 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 Blocket data?

The page example is captured from a live search call, and production requests fetch live data through ReefAPI rather than a static sample.

How many credits does the Blocket API use?

Blocket actions currently cost 1 credit per successful call. Failed or blocked calls are free. All APIs draw from one credit pool.

Can I call Blocket from an AI assistant or MCP client?

Yes. Connect ReefAPI once through MCP and your assistant can call blocket actions with the same key, credit pool and JSON envelope used by normal REST requests.

Is the Blocket API a Blocket scraper?

It is the managed alternative to a DIY Blocket scraper. Instead of building and maintaining your own scraper — proxies, headless browsers, captcha and constant breakage — you call one ReefAPI endpoint and get the same nordic second-hand listings from blocket, finn, tori and dba back as clean JSON.

Questions developers ask about Blocket data

From Stack Overflow, Reddit and search, answered with live calls on 2 Nov 2026.

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 · search
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 · 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_ids 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.

python · new private ads since the last run
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 · system cameras in Stockholm up to 5,000 SEK
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 · listing
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 · listing from a blocket.se link
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

docs / blocket

Blocket

Nordic second-hand listings from Blocket, FINN, Tori and DBA.

base /blocket/v13 endpoints
post/blocket/v1/listing1 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).

ParameterAllowed / rangeDescription
listing_idrequired—Listing id (the number at the end of …/recommerce/forsale/item/26612110) or the full listing URL — a URL also sets the country.
country = seoptionalse · no · fi · dkWhich 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.
max_rotations = 3optional1–5Advanced: how many times to retry a difficult request (1-5).
Try in playground →
post/blocket/v1/categories1 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.

ParameterAllowed / rangeDescription
country = seoptionalse · no · fi · dkWhich 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.
queryoptional—Optional keyword: counts are then for that keyword.
max_rotations = 3optional1–5Advanced: how many times to retry a difficult request (1-5).
Try in playground →
Built for volume
5M+ requests a day

Measured at 60 requests a second across the fleet, with no central bottleneck. Volume pricing is on request, and per-key limits are raised for high-volume accounts.

Missing a source?
We build it

Tell us a site we do not cover yet and it becomes an engine. A customer asked for bestprice.gr on a Sunday and it was in the catalog the next day.

Support
2 minute median reply

Median time from a question in the live chat to the first answer, measured across every answered conversation. Setup help included, no support tier to buy.

One key, one balance
Every API included

No per-site plans and no separate subscriptions. One key and one credit pool across the whole catalog, so adding a source costs nothing up front.

Planning something large? Tell us the volume and the sources and we will come back with what it costs and what we would have to build.