Pricing for API data access
We provide different plan options for users who would like to access our API. Each plan provides a certain number of tokens. Different actions, that can be performed, will use a certain number of tokens. The number of tokens used by a search action will depend on the data type and the time-span.
World’s leading companies are using NewsAPI.ai
What are tokens?
When you subscribe to a paid plan, you receive a certain number of tokens. 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).
|Search type||Recent (last 30 days)||Archive (since 2014)|
|Article search||1 token||5 tokens/searched year|
|Event search||5 tokens||20 tokens/searched year|
How many articles/events can be retrieved per search?
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.
Which properties of an article or event can be retrieved?
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).
What is the cost of Text Analytics API or various search aggregates?
Text Analytics API endpoints have the following costs per document.
|Action||Tokens per document|
|Named entity detection||0.02|
|Semantic text similarity||0.05|
|Extract article info||0.05|
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.
|Search type||Recent (last 30 days)||Archive (since 2014)|
| Top concepts
Top news sources
|5 tokens||10 tokens/searched year|
| Concepts trends
Clustering of events
|10 tokens||50 tokens/searched year|
|Text to event||3 tokens|
How does the subscription work?
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.
Can I change the subscribed plan?
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.
How can I unsubscribe?
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.
What are the different ways to use the API?
Are unused tokens transferrable to the next month?
No, tokens are not transferrable to the next month so please choose a suitable plan.
What happens when I use all the tokens in the plan?
Depending on your settings. By default, once you reach the token limit, your next API requests are rejected. If you want to continue making the API requests, you can uncheck the checkbox "Block API calls once the monthly cap is reached" on your settings page. In that case, each token above the plan limit will be charged on top of the plan. The cost of each extra token is 0.015$.
What payment options are available?
All major credit cards are supported as well as the use of PayPal. For organizations that can't subscribe using a credit card, we can also issue an invoice that can be paid directly. Contact us as firstname.lastname@example.org for more information.
Are there any discounts for academic use?
If you plan to use the data exclusively for academic purposes then a discount can be provided. Send an inquiry from your academic email address to email@example.com or contact us on our chat.