# API Reference

Athena News API supports two primary use cases: [**searching the news**](https://athena-10.gitbook.io/athena-api/getting-started/api-reference/news-search) and [**retrieving headlines**](https://athena-10.gitbook.io/athena-api/getting-started/api-reference/headlines-beta).

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.

{% tabs %}
{% tab title="200" %}

```json
```

{% endtab %}

{% tab title="400" %}

```json
{
    "error": "not authorized"
}
```

{% endtab %}

{% tab title="500" %}

```
{
    "state": "FAILED"
}
```

{% endtab %}
{% endtabs %}