Pagination

List endpoints in the Pixee PIM API return paginated results using offset-based pagination. The default page size is 50 items; the maximum is 500.

Offset pagination

Use the skip and limit query parameters to paginate through results:

Paginated request

GET

/products

curl "https://api.pixeepim.com/api/v1/products?skip=0&limit=50" \
  -H "Authorization: Bearer {api_key}"

Parameter	Type	Default	Max	Description
`skip`	integer	0	—	Number of items to skip
`limit`	integer	50	500	Number of items to return

Pagination metadata

Every list response wraps results in an items array and includes a meta object:

Paginated response

{
  "items": [...],
  "meta": {
    "total": 1234,
    "page": 1,
    "per_page": 50,
    "total_pages": 25,
    "has_next": true,
    "has_previous": false
  }
}

Field	Description
`total`	Total items matching the query
`page`	Current page number (1-indexed)
`per_page`	Items returned on this page
`total_pages`	Total number of pages
`has_next`	Whether a next page exists
`has_previous`	Whether a previous page exists

Iterating all pages

Page 1 (items 1–50)

curl "https://api.pixeepim.com/api/v1/products?skip=0&limit=50" \
  -H "Authorization: Bearer {api_key}"

Page 2 (items 51–100)

curl "https://api.pixeepim.com/api/v1/products?skip=50&limit=50" \
  -H "Authorization: Bearer {api_key}"

Continue incrementing skip by limit until has_next is false.

For large catalogs (100,000+ products), use the Exports feature to bulk-download your data instead of paginating through the API.