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.
Til að fá API lykil, sendu tölvupóst á bladberi@bladberi.is
API notar header-based auðkenningu. Þú þarft að senda API lykilinn þinn með hverri beiðni:
X-API-Key: bladberi_þinn_lykill_hér
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ðillcategories
- FlokkarDæ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ðillDæmi:
curl -H "X-API-Key: bladberi_þinn_lykill" \
"https://bladberi.is/api/v1/news/search?q=veður&limit=5"
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"
}
}
400
- Ógild beiðni (t.d. vantar leitarorð)401
- Vantar API lykil eða ógildur lykill429
- Of margar beiðnir (rate limit)500
- Villa á þjóniSpurningar eða vandamál? Sendu tölvupóst á bladberi@bladberi.is