Terms and Conditions

Cookie Policy

Refund Policy

Chat with us

News Count (count endpoint)

The Count Endpoint allows you to get the exact number of news articles on a daily and hourly 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

Crypto Endpoint - for crypto-specific article counts

Market Endpoint - for finance and stock news counts

Response Format

JSON

Authentication

Required

Rate Limited

1800 Credits

per 15 min (Paid Plans)

Archive Count Endpoint

https://newsdata.io/api/1/count?apikey=YOUR_API_KEY

Crypto Count Endpoint

https://newsdata.io/api/1/crypto/count?apikey=YOUR_API_KEY

Market Count Endpoint

https://newsdata.io/api/1/market/count?apikey=YOUR_API_KEY

Request Parameters

Below are the request parameters available to filter and customise your API query.

Name	Required	Description	Example
Search & Content Filters
`interval`	Optional	Specify 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.	interval=day interval=hour
Location, Language & Time Filters
`from_date`	Required	Use from_date filter to get news data from a particular date in the past.	from_date=YYYY-MM-DD from_date=2025-01-01 from_date=YYYY-MM-DD HH:MM:SS from_date=2025-01-01 06:12:45
`to_date`	Required	This filter is used to set an end date for the search result.	to_date=YYYY-MM-DD to_date=2025-01-30 to_date=YYYY-MM-DD HH:MM:SS to_date=2025-01-30 06:12:45

Note - Both from_date and to_date parameters are mandatory.

Example Queries

1. Total count of news about "electric vehicles" (Archive)

https://newsdata.io/api/1/count?apikey=YOUR_API_KEY&q=electric%20vehicle&from_date=2024-01-01&to_date=2024-01-31&interval=all

2. Daily count of crypto news with the keyword "Bitcoin"

https://newsdata.io/api/1/crypto/count?apikey=YOUR_API_KEY&q=bitcoin&from_date=2024-06-01&to_date=2024-06-15&interval=day

3. Hourly market news volume for "NASDAQ"

https://newsdata.io/api/1/market/count?apikey=YOUR_API_KEY&q=nasdaq&from_date=2024-04-01&to_date=2024-04-01&interval=hour