Intro to Building a Query

The query parameter can be as simple as a single search term or customized to include multiple search phrases while excluding others. Here are some examples:

Include Multiple Searches (AND):

To find articles that contain multiple phrases, combine them in a formula between terms. For example, to show articles containing "Donald Trump," "Elon Musk," and "Bitcoin," use:

("donald trump" and "elon musk" and "bitcoin")

Exclude Specific Phrases (NOT):

To exclude articles with certain phrases, use the - symbol. For instance, to find articles with "Tesla" and "Elon Musk" but not "Model 3," use:

("Tesla" and "Elon Musk") and not "Model 3"

Filtering by Date

The API can accept a start date and end date via the start_date and end_date parameters. The date must be in ISO 8601 format. Example "2024-11-12T05:00:00.000Z"

Filtering by Site

An array of strings representing website. The sites must be in 'domain.suffix' format. Example ["cnn.com", "nytimes.com"] etc...

Show Encoded Articles Only

By default, Athena shows all articles in it's database. Encoded articles are the ones for which entities, topics and relationships have been extracted. If you only want to view encoded articles, using the toggle_state parameter.