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.

I will search for
published
2000
Searches per month
40
Monthly cost
With each search, you retrieve up to 100 articles per result page.

Tokens

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)
Arcticle search 1 token 5 token/searched year
Event search 5 token 20 token/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
Language detection 0.01
Semantic anntotation 0.02
Named entity detection 0.02
Sentiment detection 0.02
Text categorization 0.04
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
Tag cloud
Locations
Timeline
Top news sources
Sentiment
Concept graphs
Categories
5 token 10 token/searched year
Concepts trends
Date mentions
Clustering of events
Similar events
50 token/searched year

Subscription

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.

FAQ

What are the different ways to use the API?

Event Registry API can be accessed directly through using REST API calls or by using the Python or Node.js SDKs. Details about the API requests and how to make them are available on the documentation page.

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 info@eventregistry.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 info@eventregistry.org or contact us on our chat.

Ready to get started?