Pagination

List endpoints in the Products Manager API return paginated results. By default, pages contain 20 items. You can request up to 100 items per page.

Page-based pagination

Most list endpoints support page and per_page query parameters:

Paginated request

GET

/products

curl "https://api.productsmanager.app/api/v1/products?page=2&per_page=50" \
  -H "Authorization: Bearer {api_key}"

Pagination metadata

Every list response includes a meta object:

Paginated response

{
  "data": [...],
  "meta": {
    "page": 2,
    "per_page": 50,
    "total": 1234,
    "total_pages": 25
  }
}

Field	Description
`page`	Current page number (1-indexed)
`per_page`	Number of items per page
`total`	Total number of items matching the query
`total_pages`	Total number of pages

Iterating all pages

To retrieve all results, loop until you reach the last page:

Fetch all pages

# Page 1
curl "https://api.productsmanager.app/api/v1/products?page=1&per_page=100" \
  -H "Authorization: Bearer {api_key}"

# Page 2
curl "https://api.productsmanager.app/api/v1/products?page=2&per_page=100" \
  -H "Authorization: Bearer {api_key}"

# Continue until page == total_pages

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