Headlines (BETA)

POST /api/v2/headlines

Returns headlines consisting of news articles clustered around leading topics.

Body

Name	Type	Description
api_key	string (required)	Your Athena API key.

Response

Name	Type	Description
headlines	array	An array of dicts. Each dict contains a topic and an array of articles tied to that topic
state	string	Query success or fail

Example Response

{
    "state":"SUCCESS",
    "headlines": [
        {
            "topic":"Israel-Hamas ceasefire just hours away from taking effect",
            "count":109,
            "articles": [
                {
                    "category": null,
                    "datePublished": "2025-01-19 01:04:00",
                    "favicon": "https://runathena.s3.us-east-1.amazonaws.com/site_favicons/671449f8701439b7c98174dd.png",
                    "image": null,
                    "site": "cbsnews.com",
                    "title": "Israel-Hamas ceasefire just hours away from taking effect",
                    "url": "https://www.cbsnews.com/video/israel-hamas-ceasefire-just-hours-away-from-taking-effect/"
                },
                {
                    "category": null,
                    "datePublished": "2025-01-19 02:09:00",
                    "favicon": "https://runathena.s3.us-east-1.amazonaws.com/site_favicons/67144a01701439b7c9817598.png",
                    "image": "https://img.etimg.com/thumb/msid-117365431,width-1200,height-630,imgsize-136990,overlay-etdefence/articleshow.jpg",
                    "site": "indiatimes.com",
                    "title": "Gaza ceasefire and hostage release set to begin",
                    "url": "https://economictimes.indiatimes.com/news/defence/gaza-ceasefire-and-hostage-release-set-to-begin/articleshow/117365428.cms"
                },
                ...
}