API Reference

Athena News API supports two primary use cases: searching the news and retrieving headlines.

For news searches, we recommend using /api/v2/query-async, which lets you submit a query and retrieve the results later via /api/v2/get-results, making it well-suited for larger queries spanning extended timeframes. For shorter timeframes, such as one or two days, the /api/v2/query method is a more suitable option.

For retrieving headlines, use /api/v2/headlines. It will return headlines, which consists of news articles clustered around a given topic.

200

400

{
    "error": "not authorized"
}

500

{
    "state": "FAILED"
}