---
title: "Get daily briefing"
method: GET
path: "/briefing"
tags: ["Briefing"]
---

# Get daily briefing

`GET /briefing`

## Request

- Base URL: `https://api.agentic-news.ai`
- URL: `https://api.agentic-news.ai/briefing`
- Auth: HTTP bearer

Personalized daily news briefing based on your monitoring agents. Returns a hero story, top stories, and overflow stories ranked by relevance with AI-generated hooks and quality scores.

## Response `200`

Default Response

- object
  - `hero` object, nullable: Top story of the day
  - `topStories` object[]: Next 4 top stories
  - `overflow` object[]: Additional stories beyond top 5
  - `agentSummary` object[]: Per-agent match counts
  - `totalMatches` number
  - `reviewCounts` object, nullable: Last-24h moat stats for this user. reviewed=total above-threshold matches validated; rejected=how many Stage-1 argued against; delivered=stories shown. Surface 'We reviewed N and argued against X — here are the M that survived.'
    - `reviewed` number
    - `rejected` number
    - `delivered` number
    - `sourcesScanned` number: Distinct publishers ingested into the shared pool in the last 24h — the breadth of the net cast before judging. 0 when the count is unavailable (masthead omits the clause).
  - `rejectedSample` object, nullable: ONE concrete argued-down story (title + the validator's reason) backing the count, for the Variant-B masthead. Populated from the user's own most-recent rejection when reviewCounts.rejected > 0; null (count-only masthead) when there is no publishable rejection.
    - `title` string
    - `publisher` string, nullable
    - `reason` string
  - `state` 'no_agents' | 'no_matches_today' | 'processing' | 'few_matches' | 'ready' | 'access_expired'
  - `validating` boolean: True when above-threshold matches are still pending LLM validation
  - `headline` string, nullable: AI-generated briefing headline
  - `digestDate` string, date-time

---

[API](https://skmtc.dev/agentic-news/apis/agentic-news-api.md) · [All operations](https://skmtc.dev/agentic-news/apis/agentic-news-api/llms.txt) · [OpenAPI document](https://skmtc.dev/agentic-news/apis/agentic-news-api/revisions/02fe31decff9?raw)