API

Blocket API: begagnatannonser i JSON

Blocket erbjuder inget öppet API för utvecklare. Det som kommer tillbaka här är det som sajten visar publikt — rubrik, beskrivning, pris och plats — som JSON. Samma motor täcker fyra nordiska marknadsplatser, vilket gör det praktiskt om du följer mer än ett land.

Hämta en gratis nyckel Fullständig dokumentation: varje endpoint, varje parameter →

Endpoints

endpoint	Vad som kommer tillbaka	Obligatoriska
search	Sök begagnade annonser på Blocket (se), FINN (no), Tori (fi) eller DBA (dk) med nyckelord och filter.	alla valfria
listing	Hela annonsen via id eller URL: rubrik, fullständig beskrivning, pris och valuta samt markering för bortskänkes.	listing_id
categories	Kategoriträdet för en sajt med levande annonsräknare, i tre nivåer.	alla valfria

Varje anrop debiteras i krediter. Misslyckade och blockerade anrop är gratis.

Fungerande exempel

Kategoriräknarna är värda ett eget anrop innan du bygger något: de visar direkt om en kategori har tillräckligt med annonser för att bevakningen ska vara meningsfull.

Förfrågan

curl -X POST https://api.reefapi.com/blocket/v1/search \
  -H "x-api-key: DIN_NYCKEL" \
  -H "content-type: application/json" \
  -d '{"site": "se", "query": "cykel", "price_max": 3000}'

Svar (förkortat)

{
  "ok": true,
  "data": {
    "results": [
      {
        "listing_id": "...",
        "title": "...",
        "price": 2200,
        "currency": "SEK",
        "location": "..."
      }
    ]
  },
  "meta": { "record_count": 40, "cache_hit": false, "mode": "live" }
}

I stället för en egen Blocket-scraper

Att skriva en egen Blocket-scraper fungerar första dagen. Det som kostar kommer sedan: ändras listningens struktur returnerar parsern en tom lista i stället för ett fel, och vid längre körningar slår botskyddet till mitt i.

Här ligger underhållet hos oss: ändras schemat lagar vi motorn, och vid blockering kommer en felkod tillbaka utan att anropet debiteras.

För en engångsuttagning är ditt eget skript billigare, och det säger vi rakt ut. För en bevakning som ska gå varje dag ligger kostnaden i de fel som ingen märker.

This page in English →Fullständig dokumentation: varje endpoint, varje parameter →

Mer dokumentation på svenska

Gränser och ärliga noteringar

Det här är inte Blockets officiella API och vi har inget samarbete med Blocket.
Fyra sajter delar motor (se, no, fi, dk) men de är separata marknader med egna valutor.
Saknar en annons pris — till exempel bortskänkes — kommer fältet som null och vi hittar inte på ett belopp.
Ingen cache: varje anrop visar läget vid frågetillfället.