Pagination is the process of breaking down a large set of result into smaller, manageable chunks, known as pages. NewData.io API supports pagination to allow you to retrieve a large number of articles in smaller chunks.
10 articles / page
The default page size for all free tier requests. This can be customized between 1-10 only.
50 articles / page
Customizable number of articles per request for premium users
First Page Request Example
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.
GET /api/1/latest
https://newsdata.io/api/1/latest?apikey=YOUR_API_KEY&q=YOUR_QUERY
This request will retrieve 10 articles per page if you are a free user and 50 articles per page for paid plans.
Using the nextPage Token
To go to the next page, you need to use next page string given at the bottom of the page
GET /api/1/latest
https://newsdata.io/api/1/latest?apikey=YOUR_API_KEY&q=YOUR-QUERY&page=XXXPPPXXXXXXXXXX
This request will retrieve the next page of the request.
"{
“status”: "success"
“totalResults”: 4580
“results”: [ ... ]
“nextPage”: “XXXPPPXXXXXXXXXXX”
}"
Important Pagination Notes
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.
Data Distribution by Page
Was this page helpful?