Guides
  1. Getting Started

Connecting via API

The base URL, endpoint paths, rate limits, and pagination behaviour you need to know before making your first Attest API request.

Base URL

All API requests are made to the following base URL:

https://api.askattest.com/insights/api/v1

Append the endpoint path to this base URL for every request. For example:

https://api.askattest.com/insights/api/v1/studies/{studyId}/structure
https://api.askattest.com/insights/api/v1/study/{studyId}/rounds

See the API reference for information on all available endpoints, and read this guide to learn how to use them together to analyse results.

Finding your study ID

Both endpoints require a studyId. To find it:

  1. Go to Attest
  2. Open the survey you want
  3. Check the URL. The study ID is the segment after /survey/

For example, in this URL the study ID is the {studyId} segment:

https://dashboard.askattest.com/survey/{studyId}/results/overview

Rate limiting

The API is rate limited to 300 requests per IP address per 5-minute window. If you exceed this, you'll receive a 403 response. When looping over multiple surveys, space your requests out or add a short delay between calls to stay within the limit.

Pagination

The rounds endpoint returns all results in a single response — there is no pagination. For studies with many waves or large audiences, responses can be sizeable, so plan your pipeline accordingly.