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

• limit sets the page size, and its maximum depends on the endpoint family: by-date signal and transaction feeds and most per-entity endpoints cap limit at 50 per page, while list results and saved-search results endpoints accept up to 5000 per page. Some endpoints also cap the total rows available across pages (for example, company transaction histories return up to 1,000 rows). Each endpoint page states its own limits.
• 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