Vefþjónusta Blaðbera

Blaðberi býður upp á REST vefþjónustu fyrir aðgang að íslenskum fréttum frá öllum helstu fréttamiðlum landsins. Vefþjónustan veitir aðgang að nýjustu fréttum og leitarmöguleika með 800 stafa samantekt fyrir hverja frétt.

Fá aðgang

Til að fá API lykil, sendu tölvupóst á bladberi@bladberi.is

Auðkenning

API notar header-based auðkenningu. Þú þarft að senda API lykilinn þinn með hverri beiðni:

X-API-Key: bladberi_þinn_lykill_hér
Takmarkanir
  • 100 beiðnir á mínútu fyrir hvern lykil
  • Hámark 50 fréttir í hverri beiðni
  • 800 stafa samantekt fyrir hverja frétt
Endapunktar

1. Nýjustu fréttir

Sækir nýjustu fréttirnar með síðumöguleika.

GET /api/v1/news/latest

Query parametrar:

  • limit - Fjöldi frétta (sjálfgefið: 20, hámark: 50)
  • offset - Fjöldi frétta til að sleppa (sjálfgefið: 0)
  • date_from - Byrjunardagsetning (ISO format)
  • date_to - Lokadagsetning (ISO format)
  • source - Fréttamiðill (t.d. "mbl.is", "visir.is")
  • categories - Flokkar sem á að sýna, aðskildir með kommu (sjálfgefið: "all,domestic,foreign,business" - íþróttir ekki með)

Dæmi:

# Sjálfgefið (án íþrótta)
curl -H "X-API-Key: bladberi_þinn_lykill" \
  "https://bladberi.is/api/v1/news/latest?limit=10"

# Með íþróttafréttum
curl -H "X-API-Key: bladberi_þinn_lykill" \
  "https://bladberi.is/api/v1/news/latest?categories=all,domestic,foreign,business,sport"

2. Vinsælustu fréttir

Sækir fréttir raðaðar eftir vinsældum (klikkfjölda) innan tilgreinds tímabils.

GET /api/v1/news/popular

Query parametrar:

  • limit - Fjöldi frétta (sjálfgefið: 20, hámark: 50)
  • offset - Fjöldi frétta til að sleppa (sjálfgefið: 0)
  • hours - Fjöldi klukkustunda aftur í tímann (sjálfgefið: 24)
  • date_from - Byrjunardagsetning (ISO format)
  • date_to - Lokadagsetning (ISO format)
  • source - Fréttamiðill
  • categories - Flokkar

Dæmi:

curl -H "X-API-Key: bladberi_þinn_lykill" \
  "https://bladberi.is/api/v1/news/popular?hours=12&limit=10"

3. Leita í fréttum

Leitar í fyrirsögnum og texta frétta.

GET /api/v1/news/search

Query parametrar:

  • q - Leitarorð (skylda)
  • limit - Fjöldi frétta (sjálfgefið: 20, hámark: 50)
  • offset - Fjöldi frétta til að sleppa (sjálfgefið: 0)
  • date_from - Byrjunardagsetning (ISO format)
  • date_to - Lokadagsetning (ISO format)
  • source - Fréttamiðill

Dæmi:

curl -H "X-API-Key: bladberi_þinn_lykill" \
  "https://bladberi.is/api/v1/news/search?q=veður&limit=5"
Svörun

Endapunktar skila svörun á þessu formi:

{
  "articles": [
    {
      "id": "123",
      "headline": "Fyrirsögn fréttar",
      "summary": "Allt að 800 stafa samantekt...",
      "source": "mbl.is",
      "published_at": "2024-01-12T10:30:00Z",
      "url": "https://mbl.is/frettir/...",
      "click_count": 42
    }
  ],
  "total": 150,
  "offset": 0,
  "limit": 20,
  "period": {
    "from": "2024-01-11T10:30:00Z",
    "to": "2024-01-12T10:30:00Z"
  }
}
Villukóðar
  • 400 - Ógild beiðni (t.d. vantar leitarorð)
  • 401 - Vantar API lykil eða ógildur lykill
  • 429 - Of margar beiðnir (rate limit)
  • 500 - Villa á þjóni
Hafðu samband

Spurningar eða vandamál? Sendu tölvupóst á bladberi@bladberi.is

Um Blaðbera·Vefþjónusta