Get available audience filter definitions
curl --request GET \
--url https://api.aws53.cloud/v1/intent/audiences/filtersimport requests
url = "https://api.aws53.cloud/v1/intent/audiences/filters"
response = requests.get(url)
print(response.text)const options = {method: 'GET'};
fetch('https://api.aws53.cloud/v1/intent/audiences/filters', 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/filters",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
]);
$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/filters"
req, _ := http.NewRequest("GET", url, nil)
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/filters")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.aws53.cloud/v1/intent/audiences/filters")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
response = http.request(request)
puts response.read_body{
"data": {
"version": {
"status": "catalog",
"sourceTable": "example_profiles",
"catalogTable": "example_filter_catalog",
"catalogVersion": "example-v1",
"buildId": "example-build",
"buildDate": "2026-01-15",
"generatedAt": "2026-01-15T12:00:00.000Z"
},
"summary": {
"groupCount": 1,
"filterCount": 1,
"valueCount": 1,
"recommendedFilterCount": 1,
"standardFilterCount": 0,
"advancedFilterCount": 0,
"supportsAdvancedLogic": true,
"defaultFieldLogic": "and"
},
"logic": {
"summary": "Use keys from groups[].filters[].key inside audience config.filters. Simple top-level filters are combined with AND. Advanced filters support explicit and/or groups.",
"uiHints": {
"useFields": [
"key",
"label",
"ui",
"type",
"valueType",
"operators",
"values",
"maxValues",
"maxTerms",
"min",
"max"
],
"technicalFields": [
"sourceColumn",
"source",
"requiresSidecar"
],
"valueHint": "Use values when present for dropdowns. Search-only text filters intentionally do not include values."
},
"simpleFilters": {
"shape": "{ \"filters\": { \"<group>\": { \"<field>\": <value> } } } or { \"filters\": { \"<filter.key>\": <value> } }",
"topLevelLogic": "AND across different filters.",
"multiSelectValueLogic": "OR within values for one multi_select filter.",
"textTermLogic": "text_terms use mode/includeMode \"any\" for OR or \"all\" for AND. jobTitle.exclude and negate=true invert the match."
},
"advancedFilters": {
"enabled": true,
"keys": [
"and",
"or"
],
"conditionShape": "{ \"field\": \"<filter.key>\", \"value\": <value> } or { \"field\": \"<filter.key>\", \"values\": [<value>] }",
"rules": [
"A group can contain either and or or at the same level, not both.",
"Top-level simple filters and top-level and/or groups are combined with AND.",
"Nested OR groups cannot mix serving-only and filter-surface-only filters.",
"Nested AND groups cannot mix serving-only and filter-surface-only filters; put those filters at top level instead."
]
},
"examples": {
"simple": {
"company": {
"industries": [
"software development"
]
}
},
"or": {
"or": [
{
"field": "company.industries",
"values": [
"software development"
]
},
{
"field": "company.isSaas",
"value": true
}
]
},
"nested": {
"and": [
{
"field": "contact.hasBusinessEmail",
"value": true
},
{
"or": [
{
"field": "company.industries",
"values": [
"software development"
]
},
{
"field": "company.isSaas",
"value": true
}
]
}
]
}
}
},
"groups": [
{
"key": "company",
"label": "Company",
"description": "Company attributes",
"filters": [
{
"key": "company.industries",
"label": "Industry",
"type": "multi_select",
"valueType": "enum",
"operators": [
"in"
],
"sourceColumn": "company_industry",
"source": "both",
"requiresSidecar": false,
"isSearchOnly": false,
"maxValues": 500,
"ui": {
"label": "Industry",
"description": "Company industry",
"control": "multi_select",
"section": "recommended",
"order": 10,
"recommended": true,
"advanced": false
},
"values": [
{
"value": "software development",
"label": "Software Development",
"count": 120
}
]
}
]
}
]
},
"meta": {
"timestamp": "2026-01-15T12:00:00.000Z",
"request_id": "example-request"
}
}{
"error": {
"code": "RATE_LIMIT_EXCEEDED",
"message": "Too many requests, please try again later"
},
"meta": {
"timestamp": "2026-01-15T12:00:00.000Z",
"request_id": "example-request"
}
}Topic discovery and filters
Audience filters
Audience filters using the public Orbit API
GET
/
v1
/
intent
/
audiences
/
filters
Get available audience filter definitions
curl --request GET \
--url https://api.aws53.cloud/v1/intent/audiences/filtersimport requests
url = "https://api.aws53.cloud/v1/intent/audiences/filters"
response = requests.get(url)
print(response.text)const options = {method: 'GET'};
fetch('https://api.aws53.cloud/v1/intent/audiences/filters', 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/filters",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
]);
$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/filters"
req, _ := http.NewRequest("GET", url, nil)
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/filters")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.aws53.cloud/v1/intent/audiences/filters")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
response = http.request(request)
puts response.read_body{
"data": {
"version": {
"status": "catalog",
"sourceTable": "example_profiles",
"catalogTable": "example_filter_catalog",
"catalogVersion": "example-v1",
"buildId": "example-build",
"buildDate": "2026-01-15",
"generatedAt": "2026-01-15T12:00:00.000Z"
},
"summary": {
"groupCount": 1,
"filterCount": 1,
"valueCount": 1,
"recommendedFilterCount": 1,
"standardFilterCount": 0,
"advancedFilterCount": 0,
"supportsAdvancedLogic": true,
"defaultFieldLogic": "and"
},
"logic": {
"summary": "Use keys from groups[].filters[].key inside audience config.filters. Simple top-level filters are combined with AND. Advanced filters support explicit and/or groups.",
"uiHints": {
"useFields": [
"key",
"label",
"ui",
"type",
"valueType",
"operators",
"values",
"maxValues",
"maxTerms",
"min",
"max"
],
"technicalFields": [
"sourceColumn",
"source",
"requiresSidecar"
],
"valueHint": "Use values when present for dropdowns. Search-only text filters intentionally do not include values."
},
"simpleFilters": {
"shape": "{ \"filters\": { \"<group>\": { \"<field>\": <value> } } } or { \"filters\": { \"<filter.key>\": <value> } }",
"topLevelLogic": "AND across different filters.",
"multiSelectValueLogic": "OR within values for one multi_select filter.",
"textTermLogic": "text_terms use mode/includeMode \"any\" for OR or \"all\" for AND. jobTitle.exclude and negate=true invert the match."
},
"advancedFilters": {
"enabled": true,
"keys": [
"and",
"or"
],
"conditionShape": "{ \"field\": \"<filter.key>\", \"value\": <value> } or { \"field\": \"<filter.key>\", \"values\": [<value>] }",
"rules": [
"A group can contain either and or or at the same level, not both.",
"Top-level simple filters and top-level and/or groups are combined with AND.",
"Nested OR groups cannot mix serving-only and filter-surface-only filters.",
"Nested AND groups cannot mix serving-only and filter-surface-only filters; put those filters at top level instead."
]
},
"examples": {
"simple": {
"company": {
"industries": [
"software development"
]
}
},
"or": {
"or": [
{
"field": "company.industries",
"values": [
"software development"
]
},
{
"field": "company.isSaas",
"value": true
}
]
},
"nested": {
"and": [
{
"field": "contact.hasBusinessEmail",
"value": true
},
{
"or": [
{
"field": "company.industries",
"values": [
"software development"
]
},
{
"field": "company.isSaas",
"value": true
}
]
}
]
}
}
},
"groups": [
{
"key": "company",
"label": "Company",
"description": "Company attributes",
"filters": [
{
"key": "company.industries",
"label": "Industry",
"type": "multi_select",
"valueType": "enum",
"operators": [
"in"
],
"sourceColumn": "company_industry",
"source": "both",
"requiresSidecar": false,
"isSearchOnly": false,
"maxValues": 500,
"ui": {
"label": "Industry",
"description": "Company industry",
"control": "multi_select",
"section": "recommended",
"order": 10,
"recommended": true,
"advanced": false
},
"values": [
{
"value": "software development",
"label": "Software Development",
"count": 120
}
]
}
]
}
]
},
"meta": {
"timestamp": "2026-01-15T12:00:00.000Z",
"request_id": "example-request"
}
}{
"error": {
"code": "RATE_LIMIT_EXCEEDED",
"message": "Too many requests, please try again later"
},
"meta": {
"timestamp": "2026-01-15T12:00:00.000Z",
"request_id": "example-request"
}
}Was this page helpful?