Your First Request
Five minutes from a login to reading your own audiences: get a token, see what your account can build, then list what it has built. After the login, every request is a read: nothing is built, and nothing counts toward your data-scan limit.
1. Get a token
Exchange the email and password you use for the Intuizi console for a token:
curl -X POST "https://console.intuizi.com/api/v2/auth/login" \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{"email": "you@example.com", "password": "your-password"}'The token is in data.token:
{
"status": "success",
"code": 200,
"message": "Token generated successfully.",
"data": { "token": "FxGrKXTS0iLgonnQZtELC0dWu73xslzHjGjaBVef" }
}A login token is fine for trying things out, but each login replaces it. For servers, scripts, and CI, create a long-lived API token instead - see Which token should I use?
2. See what you can build
Send the token as Authorization: Bearer <token> on every request. Start with
the dataset types your account can build audiences from:
curl "https://console.intuizi.com/api/v2/analyses/reference/common/dataset-types" \
-H "Authorization: Bearer <YOUR_TOKEN>" \
-H "Accept: application/json"Every response comes in the same envelope, with the result in data:
{
"status": "success",
"code": 200,
"message": "Resources fetched successfully.",
"data": [
{ "value": "WebDomain", "text": "Web Domain" },
{ "value": "Apps", "text": "Apps" }
]
}Each value is a dataset type you can put in an audience.
3. List your audiences
curl "https://console.intuizi.com/api/v2/analyses/audiences/index" \
-H "Authorization: Bearer <YOUR_TOKEN>" \
-H "Accept: application/json"Long lists come a page at a time, as data.items with a pagination block:
{
"status": "success",
"code": 200,
"message": "Resources fetched successfully.",
"data": {
"items": [
{
"id": 88,
"name": "Coffee Buyers NYC",
"status": { "id": 104, "name": "Completed" },
"results_count": 482311
}
],
"pagination": { "current_page": 1, "per_page": 25, "total": 1, "last_page": 1 }
}
}Status 104 Completed means the audience is built and ready to deliver.
Status Codes lists the others. The real response
carries more fields per audience; see
List Audiences.