Skip to main content
GET
Read an audience list

Authorizations

Authorization
string
header
required

A SuperX API key ("sxk_..."), created in the SuperX app under Account > API / MCP / CLI. Keys are server-side secrets.

Path Parameters

kind
enum<string>
required
Available options:
followers,
following,
repliers,
reposters

Query Parameters

account_id
string

Account to act on, from GET /v1/accounts. Defaults to your main account. An id outside your accounts returns 404 account_not_found.

cursor
string

next_cursor from the previous page. Omit for the first page.

limit
integer
default:50
Required range: 1 <= x <= 100

Response

A page of the audience.

data
object[]
meta
object

The state of the whole audience list, not of this page.

pagination
object

Keyset pagination. next_cursor is present only when has_more is true; pass it back as cursor to read the next page. Cursors are opaque and are not valid across different queries.