Preview an intent audience
curl --request POST \
--url https://api.aws53.cloud/v1/intent/audiences/preview \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"topicIds": [
1001,
1002
],
"minScore": 60,
"maxScore": 99,
"minTopicOverlap": 1
}
'import requests
url = "https://api.aws53.cloud/v1/intent/audiences/preview"
payload = {
"topicIds": [1001, 1002],
"minScore": 60,
"maxScore": 99,
"minTopicOverlap": 1
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({topicIds: [1001, 1002], minScore: 60, maxScore: 99, minTopicOverlap: 1})
};
fetch('https://api.aws53.cloud/v1/intent/audiences/preview', 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/preview",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'topicIds' => [
1001,
1002
],
'minScore' => 60,
'maxScore' => 99,
'minTopicOverlap' => 1
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.aws53.cloud/v1/intent/audiences/preview"
payload := strings.NewReader("{\n \"topicIds\": [\n 1001,\n 1002\n ],\n \"minScore\": 60,\n \"maxScore\": 99,\n \"minTopicOverlap\": 1\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.aws53.cloud/v1/intent/audiences/preview")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"topicIds\": [\n 1001,\n 1002\n ],\n \"minScore\": 60,\n \"maxScore\": 99,\n \"minTopicOverlap\": 1\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.aws53.cloud/v1/intent/audiences/preview")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"topicIds\": [\n 1001,\n 1002\n ],\n \"minScore\": 60,\n \"maxScore\": 99,\n \"minTopicOverlap\": 1\n}"
response = http.request(request)
puts response.read_body{
"data": {
"configHash": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"dataDate": "2026-01-15",
"strategy": "serving_table_in",
"totalCount": 0,
"breakdowns": {
"industries": [],
"seniorities": [],
"departments": [],
"companySizes": [],
"states": [],
"exportGrades": [],
"contactTiers": []
},
"sample": [],
"appliedFilters": [],
"normalizedConfig": {
"topicIds": [
1001
],
"minScore": 60,
"maxScore": 99,
"minTopicOverlap": 1,
"filters": {}
}
},
"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
Preview an intent audience
Counts and samples an audience using the latest available intent snapshot without saving an audience. Requires an authenticated organization member or API key. Sample contact details are masked, and counts can change as new intent data becomes available.
POST
/
v1
/
intent
/
audiences
/
preview
Preview an intent audience
curl --request POST \
--url https://api.aws53.cloud/v1/intent/audiences/preview \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"topicIds": [
1001,
1002
],
"minScore": 60,
"maxScore": 99,
"minTopicOverlap": 1
}
'import requests
url = "https://api.aws53.cloud/v1/intent/audiences/preview"
payload = {
"topicIds": [1001, 1002],
"minScore": 60,
"maxScore": 99,
"minTopicOverlap": 1
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({topicIds: [1001, 1002], minScore: 60, maxScore: 99, minTopicOverlap: 1})
};
fetch('https://api.aws53.cloud/v1/intent/audiences/preview', 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/preview",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'topicIds' => [
1001,
1002
],
'minScore' => 60,
'maxScore' => 99,
'minTopicOverlap' => 1
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.aws53.cloud/v1/intent/audiences/preview"
payload := strings.NewReader("{\n \"topicIds\": [\n 1001,\n 1002\n ],\n \"minScore\": 60,\n \"maxScore\": 99,\n \"minTopicOverlap\": 1\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.aws53.cloud/v1/intent/audiences/preview")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"topicIds\": [\n 1001,\n 1002\n ],\n \"minScore\": 60,\n \"maxScore\": 99,\n \"minTopicOverlap\": 1\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.aws53.cloud/v1/intent/audiences/preview")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"topicIds\": [\n 1001,\n 1002\n ],\n \"minScore\": 60,\n \"maxScore\": 99,\n \"minTopicOverlap\": 1\n}"
response = http.request(request)
puts response.read_body{
"data": {
"configHash": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"dataDate": "2026-01-15",
"strategy": "serving_table_in",
"totalCount": 0,
"breakdowns": {
"industries": [],
"seniorities": [],
"departments": [],
"companySizes": [],
"states": [],
"exportGrades": [],
"contactTiers": []
},
"sample": [],
"appliedFilters": [],
"normalizedConfig": {
"topicIds": [
1001
],
"minScore": 60,
"maxScore": 99,
"minTopicOverlap": 1,
"filters": {}
}
},
"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 .
Body
application/json
Required array length:
1 - 250 elementsExample:
[1001, 1002]
Minimum intent score. Values below 50 are accepted and normalized to 50.
Required range:
0 <= x <= 99Example:
50
Required range:
50 <= x <= 99Example:
99
Required range:
1 <= x <= 250Example:
1
Show child attributes
Show child attributes
Example:
{
"role": { "isDecisionMaker": true },
"contact": { "hasBusinessEmail": true },
"jobTitle": {
"include": ["chief financial officer", "cfo"],
"includeMode": "any"
}
}
Example:
"https://cloud.example.test"
Was this page helpful?