> ## Documentation Index
> Fetch the complete documentation index at: https://docs.archeraffiliates.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Pagination

> How to move through large Archer API responses.

Most list endpoints accept a `limit` parameter so you can control page size.
The pagination style depends on the endpoint.

## Offset pagination

Catalog-style endpoints use `skip` and `limit`.

```bash theme={null}
curl "https://api.archeraffiliates.com/getproducts?skip=0&limit=100" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"
```

Responses include:

| Field           | Meaning                                |
| --------------- | -------------------------------------- |
| `total_count`   | Total rows that match the filters.     |
| `fetched_count` | Rows returned in the current response. |

Increase `skip` by `limit` until you have fetched the rows you need.

## Page pagination

Link listing uses `page` and `limit`.

```bash theme={null}
curl "https://api.archeraffiliates.com/get_all_links?page=1&limit=100" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"
```

Increase `page` to fetch the next set of links.

## Cursor pagination

Reports use cursor pagination.

```bash theme={null}
curl "https://api.archeraffiliates.com/reports?start=2026-05-01&end=2026-05-31&limit=100" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"
```

If the response includes `next_cursor`, pass it back as `cursor`:

```bash theme={null}
curl "https://api.archeraffiliates.com/reports?start=2026-05-01&end=2026-05-31&limit=100&cursor=NEXT_CURSOR" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"
```

When `next_cursor` is `null`, there are no more rows.

Seller report responses also include `total_count_exact`. It's `true`
when `total_count` is an exact count of matching rows. If the underlying
count hit the database's bounded time limit, `total_count_exact` comes
back `false` — treat `total_count` as a lower bound and keep paging via
`next_cursor`.