Newsdata.io is a News API that provides access to news articles from all over the world. To get started with the platform, you can sign up for a free trial account at https://newsdata.io/register.
NewsData.io gathers news from more than 82018 news sources which cover around 206 countries in 89 languages. As of now, NewsData.io has access to over 100 million news articles which are gathered from 2018 till today.
Once you have an account, you can access the news data by using the provided API. The API allows you to search for news articles based on keywords, phrases, date range, language, location, publisher and other criteria.
Once you have the API key, you can start making requests to the API to retrieve news articles. The API documentation provides detailed information on how to use the API and the different parameters that can be used in the requests.
Additionally, the platform offers a range of tools to analyze and visualize the data. These tools include sentiment analysis, entity extraction, and topic modeling. However, these text analysis modules are not part of the NewsData.io API.
It's also worth noting that Newsdata.io offers different subscription plans, so be sure to check which one best suits your needs before getting started. You can upgrade or cancel your plan anytime.
To get access to an API key, you will first need to sign up. Once your email is verified, you can access the dashboard by logging in. On the dashboard, you will find the API key.
Once you have the API key, you can start making requests to the API to retrieve news articles. It's also important to keep your API key secure and not share it with anyone.
For a comprehensive look, visit our detailed article - How to Get Your NewsData.io News API Key
Once you get the access of the API key, you can fetch the data using the API key in the request URL.
You can use platforms like HTTP REST clients (such as Postman) or Curl to fetch the data in JSON format.
Here is an example of a request to retrieve news articles:
This request will search for the latest news articles that contain the keyword "pizza". The apikey parameter is used to authenticate your account and is required in all requests.
You can also use additional parameters to refine your search, such as specifying a language, category, domain name etc.
This request will search for English language news articles published between August 26, 2022 and January 25, 2023 that contain the keyword "pizza".
Once you've made a request, you will receive a response in JSON format containing the news articles that match your search criteria.
For practical understanding visit - How to Make Your First Request With NewsData.io
Newsdata.io uses API key authentication to access the platform's features and data. An API key is a unique string of characters that is generated for each account, and it is required in all requests to the API.
When making requests to the API, you need to include the API key in the request URL. The API key can be passed as a request header as X-ACCESS-KEY or as a query parameter apikey.
If the API key is not included in the request headers or it is invalid, the API will return a 403 Unauthorized error and the request will be denied.
You will get the following data points in JSON response while requesting the API.
Sample Response
For a comprehensive look, visit our detailed article - Response Objects: Data you receive from NewsData.io News API
Secure login and authentication: Newsdata.io uses secure methods for user authentication.
Data encryption: Newsdata.io uses encryption to protect user data, both in transit and at rest, to prevent unauthorized access to sensitive information.
Access controls: Newsdata.io may implement strict access controls to prevent unauthorized access to user data and ensure that only authorized personnel can access sensitive information.
Regular security updates and patches: Newsdata.io regularly update their systems and software to fix any discovered vulnerabilities and ensure the security of user data.
Compliance with industry-standard security regulations: Newsdata.io complies with industry-standard security and data protection regulations such as General Data Protection Regulation (GDPR) and the Payment Card Industry Data Security Standard (PCI DSS) to protect user data.
Incident management and incident response: Newsdata.io has a process in place to detect and respond to security incidents, such as data breaches or system failures, to minimize the impact on users.
Regular backups and disaster recovery plans: Newsdata.io maintains regular backups and disaster recovery plans to ensure data availability in case of an incident.
Strict access controls on the part of the company to their own systems and data: Newsdata.io has strict controls on their own systems and data to prevent any unauthorized access.
As a user, you should also take your own security measures such as keeping your API key secure and not sharing it with anyone, use unique and complex passwords and keep your software updated.
API Integration: Newsdata.io has strict controls on how their APIs are integrated into third-party apps to ensure that user data is protected. This could include rate limiting, IP whitelisting, and encryption of data in transit.
Regular Audits: Newsdata.io conducts regular security audits and penetration testing to identify and address vulnerabilities in their systems and third-party apps that integrate with their APIs.
Security awareness and training: Newsdata.io provides the necessary security awareness training to their employees to ensure they are aware of the security threats and how to handle them.
In summary, to maintain security and safety for users at Newsdata.io, the platform should have strict controls on the level of access that third-party apps have to user data, a vetting process for third-party apps, strict controls on API integration, regular security audits and penetration testing, compliance with industry-standard security regulations, incident management process, and security awareness and training for the employees.
Pagination is the process of breaking down a large set of results into smaller, manageable chunks, known as pages. Newsdata.io API supports pagination to allow you to retrieve a large number of articles in smaller chunks.
When you make a request, the default page size is 10 articles per page for free plan and 50 articles per page for paid plans. You can customize the number of articles you get per request.
For example:
This request will retrieve 10 articles per page if you are a free user and 50 articles per page for paid plans.
To go to the next page, you need to use next page string given at the bottom of the page
This request will retrieve the next page of the request.
Please note that you can only go to the next page from your current page. In case you want to go back to the previous page, you need to save the "nextPage" variable in your database.
For practical understanding visit - All About Pagination in NewsData.io News API
There are various ways to search for a topic or an event at Newsdata.io. These filters enable the users to narrow down the search and get accurate results. Please refer the table below to understand all the filters you can use with "q", "qInTitle" or "qInMeta" parameters:
"Please note that the maximum character limit for a single query (q", "qInTitle" and "qInMeta") is 512. If the number of characters exceeds this limit, the API will show error. Additionally, please note that the operators AND, OR, NOT, as well as brackets and spaces, are included in the character count."
For practical understanding and use cases of "q", "qInTitle" and "qInMeta" kindly visit - How to use "q", "qInTitle" and "qInMeta" parameters
Newsdata.io API has a rate limit, which is the number of requests that can be made to the API within a certain time period. The rate limit is in place to ensure that the API is available for all users and to prevent any one user from overloading the system.
The specific rate limit for the API varies depending on the plan you have subscribed to. For example, a free plan may have a lower rate limit than a paid plan.
The API limit you get for different plans is as follows:
Free Plan: 30 credits every 15 minutes
Paid plans: 1800 credits every 15 minutes
If you exceed the rate limit for your plan, the API will return a "Rate Limit Exceeded" error and you will not be able to make any further requests until the rate limit resets after 15 minutes.
For detailed understanding visit - Rate Limit of NewsData.io
Newsdata.io API has a credit limit for different subscription plans. The credit limit is a way to control the amount of usage of the API by the users.
The free plan gives access to 200 API credits on a daily basis. The paid plan has an API credit of 20,000 per month for Basic plan, 50,000 per month for Professional plan and 300,000 per month for Corporate plan.
You can opt any of the subscription plans as per your requirements.
Please refer the table below to check the API Credit limit for different Subscription plans:
You can customize the number of articles you get per request from 1 to 50.
For example:
This request will retrieve 15 articles per page or per request if you are a paid user and if you are a free user then you need to define the size between 1 to 10.
API credit at Newsdata.io gets consumed each time a request is made to the API. The number of credits consumed do not depend on the type of request made and the data returned.
You can track the API credit limit and monitor the usage of the API at your NewsData.io account.
For detailed understanding visit - How NewsData.io Credits Are Consumed
Newsdata.io API returns various HTTP response codes depending on the request. Below are all the HTTP response codes:
The latest news endpoint provides access to the latest and breaking news. The news articles are sorted by the published date. With the "latest" endpoint, you can access the news articles up to the past 48 hours.
Retrieving the latest news allows you to build experience such as showcasing the latest news, breaking news tickers and analyzing News to better understand their content.
Resource URL
Example Queries
1. News from Australia and United States
Sample Response
2. News for domain BBC
3. News for Category Science
To dive deeper with practical examples visit - Get Latest News using NewsData.io "News" Endpoint: In Detail
Search and Monitor Worldwide Cryptocurrency-related news and blog data from the most reliable News and Blog Websites.
Retrieving the latest news allows you to build experience such as showcasing the latest news, breaking news tickers and analyzing News to better understand their content.
Resource URL
Example Queries
1. Crypto News from countries Germany and Hong Kong
2. Crypto News in Italian and Japanese language
3. Crypto News from domain nytimes
To dive deeper with practical examples visit - Crypto News API Endpoints
The news archive endpoint provides access to the old news data for a topic, event, country, for a specific category in a country, or for a single or multiple domains.
Retrieving a piece of old news allows you to get the past news data for research and analysis purposes.
The News Archive endpoint is available only in Paid plans. You can get news data for the past 2 years using the Archive endpoint.
There is limited access to the news archive endpoint for each paid plan:
Basic | 6 months of historical data |
Professional | 1 year of historical data |
Corporate | 2 years of historical data |
Under your plan, you will not be able to access news data beyond these limits. To get news beyond the past 2 years, click here
Resource URL
Example Queries
1. News from category technology and science
2. News from_date 23-Jan-2020 to 17-Feb-2022
3. News from 12-Dec-2022 till present date
To dive deeper with practical examples visit - All about News "Archive" Endpoint
Sources endpoint provides names of randomly selected 100 domains from a country, category or/and language.
It is mainly a convenience endpoint that you can use to keep track of the publishers available on the API.
Resource URL
Example Queries
1. News sources that show from specific country
2. News sources that show from specific category
3. News sources that show from specific language
To dive deeper with practical examples visit - News Sources Endpoints
Use the Newsdata.io Python client library to integrate Newsdata.io API into your Python application without having to make HTTP requests directly.
Source: Newsdata.io Python Client
Installation:
Usage:
Pagination
Use the Newsdata.io PHP client library to integrate Newsdata API into your PHP application without having to make HTTP requests directly.
Source: Newsdata.io PHP bindings