Pagination
List endpoints in the Pixee PIM API return paginated results using page-based pagination. The default page size is 20 items; the maximum is 100.
Page-based pagination
Use the page and per_page query parameters to paginate through results:
Paginated request
GET
/productscurl "https://api.pixeepim.com/api/v1/products?page=1&per_page=20" \
-H "Authorization: Bearer {api_key}"
| Parameter | Type | Default | Max | Description |
|---|---|---|---|---|
page | integer | 1 | — | Page number (1-indexed) |
per_page | integer | 20 | 100 | Number of items to return per page |
Pagination response format
Every list response wraps results in an items array and includes pagination fields directly at the root level:
Paginated response
{
"items": [...],
"total": 1247,
"page": 1,
"per_page": 20,
"pages": 63
}
| Field | Description |
|---|---|
total | Total items matching the query |
page | Current page number (1-indexed) |
per_page | Items returned per page |
pages | Total number of pages |
Iterating all pages
Page 1 (items 1–20)
curl "https://api.pixeepim.com/api/v1/products?page=1&per_page=20" \
-H "Authorization: Bearer {api_key}"
Page 2 (items 21–40)
curl "https://api.pixeepim.com/api/v1/products?page=2&per_page=20" \
-H "Authorization: Bearer {api_key}"
Continue incrementing page until page exceeds pages.
The legacy skip and limit parameters are available as aliases for
backward compatibility but are not recommended for new integrations. Prefer
page and per_page instead.
For large catalogs (100,000+ products), use the Exports feature to bulk-download your data instead of paginating through the API.