Pricing for API data access

When you subscribe to a paid plan, you receive a certain number of tokens (10K plan has 10.000 tokens, etc.). Tokens are then units that you consume by performing API calls. Different API calls can use different numbers of tokens.

For the 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 each search action, you can retrieve up to 100 articles or 50 events. If your search results contain more results, you can easily retrieve all of them by repeating the search and asking for the second, third, fourth, etc. page of results. Retrieving each page of results counts as a search action and uses a corresponding number of tokens.

When searching for articles, you can obtain article details like title, full article body, date of publishing, source information, article URL, image URL, list of disambiguated concepts mentioned in the article, list of article leadings, number of shares on social media, and other information. For the full list of properties, check the data models page. Note that some of these properties are not returned by default and require setting a certain flag when making the request (getting these properties will incur no extra cost).

When searching for events, you can retrieve the title of the event, short summary, location, date, list of related concepts, list of related topics, list of articles describing the event, etc. For the full list of properties, please visit the data models page. Note that some of these properties are not returned by default and require setting a certain flag when making the request (getting these properties will incur no extra cost).

Text Analytics API endpoints have the following costs per document.

When performing an article or event search calls, you can also request different types of aggregates as a result of the search. These aggregates represent a certain kind of summary of the results. An example of such a summary would be the number of articles per day that match your search results. The cost of each of these summaries depends on their complexity and is described in the bottom table.

When you subscribe to a plan, you receive the subscribed number of tokens that you can use inside the calendar month. Regardless of when during the month you subscribe, the subscription lasts between the first and last day of the month. On the first day of the next month, you'll be charged based on the currently selected plan for the usage in the previous month. For example, if you subscribe on May 10th, your tokens can be used until May 31st and on June 1st you'll be charged for the usage in May.

The subscriptions are monthly and automatically renew until you cancel the subscription.

You can change the subscribed Plan at any time during the month. You can upgrade or downgrade it at any point. It is however important that you have the appropriate plan selected at the end of the month since the currently active plan will be used when charging you for the usage.

You can unsubscribe by visiting your settings page and clicking the Unsubscribe button. After unsubscribing your account will still remain active until the last day of the calendar month. For example, if you unsubscribe on May 15h, you'll be able to use the API until May 31st, and on June 1st you'll receive the last charge for the usage in May.