Athena News API Documentation
FeaturesPricingContact UsCreate AccountSign In
Athena API v3
Athena API v3
  • About Athena News API
  • v3 Change Summary
  • Account Overview
    • Account Overview
    • Dashboard
    • News Search
    • API Key
    • Account Settings
    • Manage Subscription
  • Getting Started
    • API Quickstart
    • Python SDK
    • Intro to Building a Query
    • API Reference
      • News Search
      • Headlines (BETA)
    • Data Model Reference
      • Articles
      • Entities
    • Supported Languages
    • Rate Limits
    • Troubleshooting
Powered by GitBook
On this page
  • Filtering by Date
  • Filtering by Site
  • Show Encoded Articles Only
  1. Getting Started

Intro to Building a Query

Athena make use of a hybrid of semantic and text search, meaning that you can search for a topic and then further refine the results using text based logic.

Standard Query

Our standard query fields makes use of Semantic Search. Semantic search means that instead of just matching exact keywords, the search engine understands the intent behind your query.

For example, if you search for “latest updates on U.S. economic policy changes” a semantic search engine will interpret that you're interested in news about fiscal, trade, or monetary policy, even if those specific terms aren't used in every article. It might return articles on government budget changes, regulatory reforms, or related market reactions—all because it recognizes that these topics are contextually related to your original query.

You could then combine that with Key Phrases to make sure articles talk about the federal reserve. For instance ("federal reserve" and "rates").

Key Phrases

The Key Phrases parameter is used to further filter results by whether they contain (or don't contain) specific words and phrases. It 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.

PreviousPython SDKNextAPI Reference

Last updated 1 month ago