1. Nýjustu fréttir

Sækir nýjustu fréttirnar, raðað eftir birtingartíma.

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, aðskildir með kommu (sjálfgefið: all,domestic,foreign,business — íþróttir ekki með nema óskað sé eftir)

Dæmi:

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"

Svörun:

{
  "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/..."
  }],
  "total": 4523,
  "offset": 0,
  "limit": 20
}

2. Vinsælustu fréttir

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

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, yfirskrifar hours)
• date_to - Lokadagsetning (ISO format)
• source - Fréttamiðill
• categories - Flokkar, aðskildir með kommu (sýnir íþróttir ef "sports" er innifalið)

Dæmi:

# Vinsælast síðustu 12 klukkustundir
curl -H "X-API-Key: bladberi_þinn_lykill" \
  "https://bladberi.is/api/v1/news/popular?hours=12&limit=10"

# Vinsælast síðustu 7 daga
curl -H "X-API-Key: bladberi_þinn_lykill" \
  "https://bladberi.is/api/v1/news/popular?hours=168&limit=20"

Svörun:

{
  "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"
  }
}

3. Leita í fréttum

Fulltextaleit í fyrirsögnum og texta frétta (PostgreSQL FTS).

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
• categories - Flokkar, aðskildir með kommu
• prefix - Forskeytisleit, "true" til að virkja (t.d. "veð" finnur "veður")

Dæmi:

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

# Forskeytisleit
curl -H "X-API-Key: bladberi_þinn_lykill" \
  "https://bladberi.is/api/v1/news/search?q=stjórn&prefix=true&limit=10"

Svörun:

{
  "articles": [{
    "id": "456",
    "headline": "Fyrirsögn fréttar",
    "summary": "Allt að 800 stafa samantekt...",
    "source": "visir.is",
    "published_at": "2024-01-12T10:30:00Z",
    "url": "https://visir.is/..."
  }],
  "total": 42,
  "offset": 0,
  "limit": 20
}