Pagination

Page through large result sets with two query parameters: page and limit.

List endpoints support pagination using page and limit.

Parameters

• page — page index (starts at 0)
• limit — number of results per page (default: 50)

Example

curl --request GET \
  --url 'https://app.tryspecter.com/api/v1/searches/companies/5432/results?page=1&limit=500' \
  --header 'X-API-Key: YOUR_API_KEY'

Limits

• Maximum limit is typically 5000
• Some endpoints use lower caps (e.g. name search: 10, people: 100, transactions: 1000)
• Exceeding the limit returns 400

See each endpoint for its exact cap.

When to stop

• If response headers include totals (X-Total-Count, X-Total-Pages), use them
• Where present, follow the RFC 5988 Link header (next / prev URLs) to walk pages
• Otherwise, stop when a page returns fewer than limit results