In this article, we will focus on the news count endpoint introduced by NewsData.io.
News Count Endpoint Of NewsData.io
News Count Endpoint provides you with the number of articles in a particular time on an hourly or daily basis, available in the NewsData.io database that match your query filters, without fetching the actual articles.
This helps you analyze data volume, plan queries, or understand coverage before making detailed requests.
This feature is available for Basic, Professional, and Corporate users, and each API request consumes 50 API credits.
You can use the Count Endpoint with the following:
- Archive Endpoint – for historical news data
For the archive count endpoint use:
https://newsdata.io/api/1/count?apikey=YOUR_API_KEY
- Crypto Endpoint – for crypto-specific article counts
For the crypto count endpoint use:
https://newsdata.io/api/1/crypto/count?apikey=YOUR_API_KEY
- Market Endpoint – for finance and stock news counts
For the market count endpoint use:
https://newsdata.io/api/1/market/count?apikey=YOUR_API_KEY
Request Parameters for Count Endpoint
1. From_date
You can use the from_date filter to get news data from a particular date in the past.
- from_date=YYYY-MM-DD
- from_date=YYYY-MM-DD HH:MM:SS
2. To_date
You can use this filter to set an end date for the search result.
- to_date=YYYY-MM-DD
- to_date=YYYY-MM-DD HH:MM:SS
Note – Both ‘from_date’ and ‘to_date’ parameters are mandatory in the count news endpoint.
For better understanding, below are some examples.
https://newsdata.io/api/1/count?apikey=YOUR_API_KEY&q=electric%20vehicle&from_date=2025-01-01 06:12:45&to_date=2025-05-01 07:12:47
https://newsdata.io/api/1/count?apikey=YOUR_API_KEY&q=environmentalissues&from_date=2025-01-01&to_date=2025-05-01
( examples above are for the archive count endpoint )
3. Interval
This parameter specifies how the count data should be grouped – by All, Day, or Hour intervals.
- all – Returns the total aggregated count for the full date range.
- day – Returns daily grouped article counts.
- hour – Returns hourly grouped article counts.
https://newsdata.io/api/1/count?apikey=YOUR_API_KEYq=electric%20vehicle&from_date=2025-01-01&to_date=2025-01-31&interval=all
Let’s take a look at another example for the interval parameter, where interval=day.
https://newsdata.io/api/1/crypto/count?apikey=YOUR_API_KEY&coin=btc&from_date=2025-01-01&to_date=2025-11-21&interval=day
( In the second example for the interval parameter, the request is made through the crypto endpoint.)
All The Supported Parameters
All filtering parameters available in the Archive, Crypto, and Market endpoints work the same on the Count Endpoint.
1. Archive Parameters
With the archive news endpoint, you can access the historical data from up to the past 7 years. The News “Archive” endpoint allows users to retrieve news content from a specific date range.
For more information about the parameters supported by the Archive News Endpoint, you can refer to the News Archive Endpoint article.
Below are a few examples of archive parameters:
https://newsdata.io/api/1/count?apikey=YOUR_API_KEY&q=modi&country=us,in&from_date=2025-01-01&to_date=2025-01-31&interval=all
Parameters used in the above example are – query=modi and country = US and India
Along with that, we have applied the mandatory parameters for the count endpoint, which are from_date and to_date.
Here, the interval parameter has also been applied as ‘interval=all’. If the interval parameter is not applied in any request, then it will provide the result as the total aggregated count for the full date range by default.
Let’s understand with another example:
https://newsdata.io/api/1/count?apikey=YOUR_API_KEY&q=modi&language=as,en&from_date=2025-01-01&to_date=2025-01-31&interval=day
Parameters used in the above example are query= modi and language= Assamese and English.
Along with that, we have applied the mandatory parameters for the count endpoint, which are from_date and to_date.
Here, the interval parameter is used as ‘interval=day’. This parameter returns daily grouped article counts.
2. Crypto Parameters
Crypto News Endpoint delivers real-time news articles exclusively related to cryptocurrencies and blockchain technology. This endpoint provides a curated stream of crypto-focused news articles that also includes market trends, so you can stay up-to-date with the evolving world of cryptocurrency.
For more information about the parameters supported by Crypto News Endpoint, you can refer to the Crypto News Endpoint article.
Below are a few examples of crypto parameters:
https://newsdata.io/api//1/crypto/count?apikey=YOUR_API_KEY&coin=btc&from_date=2025-01-01&to_date=2025-01-31&interval=all
The parameter used in the above example is coin=btc.
Along with that, we have applied the mandatory parameters for the count endpoint, which are from_date and to_date.
Here, the interval parameter has also been applied as ‘interval=all’. If the interval parameter is not applied in any request, then it will provide the result as the total aggregated count for the full date range by default.
Let’s understand with another example:
https://newsdata.io/api//1/crypto/count?apikey=YOUR_API_KEY&coin=btc&from_date=2025-01-01&to_date=2025-01-31&interval=all
The parameter used in the above example is coin=btc and language=Spanish and English.
Along with that, we have applied the mandatory parameters for the count endpoint, which are from_date and to_date.
3. Market Parameters
Market News Endpoint provides you with the latest news articles related to financial news, stock market news, and business-related mergers. This endpoint helps users with a better market analysis and staying ahead in the market competition with the latest trends.
For more information about the parameters supported by Market News Endpoint, you can refer to the Market News Endpoint article.
Below are a few examples of market parameters:
https://newsdata.io/api//1/market/count?apikey=YOUR_API_KEY&q=amazon&language=en&from_date=2025-01-30&to_date=2025-11-23
Parameters used in the above example are query=Amazon and language=English.
Along with that, we have applied the mandatory parameters for the count endpoint, which are from_date and to_date.
Let’s understand with another example:
https://newsdata.io/api//1/market/count?apikey=YOUR_API_KEY&symbol=AMZN&from_date=2024-12-25&to_date=2025-11-23&interval=all
Parameters used in the above example are symbol=AMZN.
Along with that, we have applied the mandatory parameters for the count endpoint, which are from_date and to_date.
For more information, you can refer to the documentation.
Aditi Chaudhary is an enthusiastic content writer at Newsdata.io, where she covers topics related to real-time news, News APIs, data-driven journalism, and emerging trends in media and technology. Aditi is passionate about storytelling, research, and creating content that informs and inspires. As a student of Journalism and Mass Communication with a strong interest in the evolving landscape of digital media, she aims to merge her creativity with credibility to expand her knowledge and bring innovation into every piece she creates.
