Signals Image Artist: My API search result spans several pages, how do I request a specific page?

Created
April 09, 2024 11:07

When querying the Search API, the search result (count) may exceed the maximum number of permitted items in the response document (items_per_page).

"count": 1073,
"items_per_page": 50,

(Note, the items_per_page value is hard-coded to 50 and cannot be easily modified).

In such cases the response will span several pages, and pagination links will be embedded in the response.

"first": { 
            "href": "/api/1.1/search/" 
        }, 
        "next": { 
            "href": "/api/1.1/search/?page=2" 
        }, 
        "last": { 
            "href": "/api/1.1/search/?page=22"

In the above example the response spans 22 pages. The pagination links can be used to request the next pages as required. For example, to request page 2:

curl -k --location --request GET 'https://sima-server.com/api/1.1/search/?page=2' --header 'PKI-Columbus-Authentication: <TOKEN>' --header 'Content-Type: application/json' --data-raw ''

Related articles