# The page
and page_size
Query Parameters
The page
and page_size
query parameters are used in conjunction most of the time on requests that
return object lists. The query parameter page_size
allows you to set the number of objects returned
in one page, while page
allows you to specify the page number you want to view, based on a specified
number or the default page_size
of 50.
The APIs use these query parameters themselves to construct links to the next and previous page of any list of objects. For example, if you request the URL:
GET /api/v2/measurements/
You'll see that the API returns a next
field that contains a link with the query parameters ?page=2
.
There are some important things to note when using these query parameters:
- Values over 500 on the query parameter
page_size
will be automatically limited to 500 - Using the
page
andpage_size
parameters is meant to limit the size of responses to be more convenient for users. Using many requests with small limits will not speed up (or slow down), the RIPE Atlas APIs. Using many small requests will, however, require more overhead on your network connection in comparison to one big request to RIPE Atlas.