Get an intent audience
curl --request GET \
--url https://api.aws53.cloud/v1/intent/audiences/{id} \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.aws53.cloud/v1/intent/audiences/{id}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.aws53.cloud/v1/intent/audiences/{id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.aws53.cloud/v1/intent/audiences/{id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.aws53.cloud/v1/intent/audiences/{id}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.aws53.cloud/v1/intent/audiences/{id}")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.aws53.cloud/v1/intent/audiences/{id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"data": {
"id": "11111111-1111-4111-8111-111111111111",
"organizationId": "33333333-3333-4333-8333-333333333333",
"name": "Example cloud research",
"status": "draft",
"config": {
"topicIds": [
1001
],
"minScore": 60,
"maxScore": 99,
"minTopicOverlap": 1,
"filters": {},
"topics": [
{
"topicId": 1001,
"topicName": "Example cloud platform",
"type": "b2b",
"industry": "Technology",
"category": "Cloud Computing"
}
]
},
"accessType": "paid",
"dailyRefreshEnabled": true,
"audienceSize": 0,
"createdBy": null,
"lastRefreshedAt": null,
"createdAt": "2026-01-15T12:00:00.000Z",
"updatedAt": "2026-01-15T12:00:00.000Z",
"pausedAt": null
},
"meta": {
"timestamp": "2026-01-15T12:00:00.000Z",
"request_id": "example-request"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": "<unknown>"
},
"meta": {
"timestamp": "2023-11-07T05:31:56Z",
"request_id": "<string>"
}
}Audience builder
Get an intent audience
Returns one audience owned by the authenticated organization, including its normalized configuration, topic labels, access type, and refresh state. An audience outside the organization is treated as not found.
GET
/
v1
/
intent
/
audiences
/
{id}
Get an intent audience
curl --request GET \
--url https://api.aws53.cloud/v1/intent/audiences/{id} \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.aws53.cloud/v1/intent/audiences/{id}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.aws53.cloud/v1/intent/audiences/{id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.aws53.cloud/v1/intent/audiences/{id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.aws53.cloud/v1/intent/audiences/{id}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.aws53.cloud/v1/intent/audiences/{id}")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.aws53.cloud/v1/intent/audiences/{id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"data": {
"id": "11111111-1111-4111-8111-111111111111",
"organizationId": "33333333-3333-4333-8333-333333333333",
"name": "Example cloud research",
"status": "draft",
"config": {
"topicIds": [
1001
],
"minScore": 60,
"maxScore": 99,
"minTopicOverlap": 1,
"filters": {},
"topics": [
{
"topicId": 1001,
"topicName": "Example cloud platform",
"type": "b2b",
"industry": "Technology",
"category": "Cloud Computing"
}
]
},
"accessType": "paid",
"dailyRefreshEnabled": true,
"audienceSize": 0,
"createdBy": null,
"lastRefreshedAt": null,
"createdAt": "2026-01-15T12:00:00.000Z",
"updatedAt": "2026-01-15T12:00:00.000Z",
"pausedAt": null
},
"meta": {
"timestamp": "2026-01-15T12:00:00.000Z",
"request_id": "example-request"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": "<unknown>"
},
"meta": {
"timestamp": "2023-11-07T05:31:56Z",
"request_id": "<string>"
}
}Authorizations
bearerAuthapiKeyAuth
Dashboard access token. Send as Authorization: Bearer .
Path Parameters
Audience identifier within the authenticated organization.
Example:
"11111111-1111-4111-8111-111111111111"
Was this page helpful?