Time range

The maximum range between the from and to dates in your query should not exceed 7 days.


You can filter for any option that is available for the /articles endpoint.


The Data dictionary provides notes on how publisher, domain, and domains are populated with data. Please read v1/stats aggregation options to make a decision on which is an appropriate aggregation option for your use case.

total_matched_articles field

On 6th May 2021 we included a new field in the response for this endpoint – “total_matched_articles”. This value represents the sum of all articles that match the filters for that aggregation group.

Click Try It! to start a request and see the response here!