Tokens and tracking of your usage

NewsApi.ai offers a wide range of actions - searching for articles, events, obtaining trends, top shared news, aggregated summary of search results, etc. Additionally you can also do text processing on your own documents by performing semantic annotation, categorization or other text analytics methods on them.

Because different actions are not equally complex, we don't track the user's API usage by the number of requests. Instead, each action is associated with a number of tokens, that corresponds to the complexity of the action. Performing an action will use a corresponding number of tokens from your account.

Each user has a certain number of tokens that can be used. Free users can use a total of 2,000 tokens for testing the service (up to 500 per day). Subscribed API users have a monthly quouta of tokens (contact us for a quote) as determined by their subscription plan.

News and event search

Number of tokens used when performing a search is determined by the time window of interest and the returned data type.

For majority of users, who want to search among recent news articles, a search action will use 1 token. Searching on historical data will however use more tokens. Searching among articles published in 2017 will, for example use 5 tokens, while searching among articles published between 2015 and 2017 it will take 15 tokens (3 years of content).

With a single search action you can retrieve up to 100 news articles or 50 events.

Obtaining summaries for search results

In addition to performing searches and retrieving a list of articles or events, Event Registry provides also a variety of other actions that you can perform. One group of actions includes computation of various summaries of the search results, such as top concepts, top keywords, top news sources, etc. These summaries also vary in their complexity and are split into four pricing groups as listed in the bottom table.