{
"error": {
"code": "invalid_parameter",
"message": "since must be a UTC ISO-8601 timestamp"
}
}
{
"error": {
"code": "invalid_api_key",
"message": "Unknown or revoked API key"
}
}
{
"error": "subscription_required: The SuperX API requires an active subscription"
}
{
"error": {
"code": "account_not_found",
"message": "No account with that id belongs to this key"
}
}
{
"error": {
"code": "rate_limited",
"message": "Rate limit exceeded for the Pro plan (30 requests/min). Upgrade for higher limits.",
"retry_after": 42
}
}
{
"error": {
"code": "accounts_unavailable",
"message": "Account information is temporarily unavailable. Try again shortly."
}
}
Audience
Read an audience list
A page of the account’s followers, following, repliers or reposters
from SuperX’s synced snapshot.
These four are the system lists in the app’s Contacts tab. They live
in SuperX’s own audience store rather than in the contact lists you
create, which is why /v1/contact-lists/{id}/members will not read
them and this endpoint exists.
Paging is by CURSOR, not page number: pass pagination.next_cursor
back as cursor to continue. A cursor points at the last row of the
page you were given, so new rows arriving mid-walk never shift the
pages you already read. There is no total; meta.synced_count is
the size of the whole list.
followers and following come from the follow graph SuperX syncs
for the account, so meta reports the sync status, the plan’s
backfill_cap and whether the account is deeper than that cap.
repliers and reposters are a rolling 90-day window
(meta.window_days), so someone whose last reply ages past 90 days
drops out and reappears on their next reply.
engaged_count is replies plus reposts in the last 90 days for the
follow lists, and this list’s own action count for repliers and
reposters. icp_score and icp_rationale are always null here:
scoring belongs to signal-agent deposits, not to the snapshot.
{
"error": {
"code": "invalid_parameter",
"message": "since must be a UTC ISO-8601 timestamp"
}
}
{
"error": {
"code": "invalid_api_key",
"message": "Unknown or revoked API key"
}
}
{
"error": "subscription_required: The SuperX API requires an active subscription"
}
{
"error": {
"code": "account_not_found",
"message": "No account with that id belongs to this key"
}
}
{
"error": {
"code": "rate_limited",
"message": "Rate limit exceeded for the Pro plan (30 requests/min). Upgrade for higher limits.",
"retry_after": 42
}
}
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.
Show child attributes
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"SuperX","colors":{"primary":"#F4503B","light":"#FB7359","dark":"#D93820"},"logo":{"light":"https://mintcdn.com/superx/ZOrKRYsYXbBhitoI/logo/light.svg?fit=max\u0026auto=format\u0026n=ZOrKRYsYXbBhitoI\u0026q=85\u0026s=d465c38938c34f6ab75cfc50d0039be2","dark":"https://mintcdn.com/superx/ZOrKRYsYXbBhitoI/logo/dark.svg?fit=max\u0026auto=format\u0026n=ZOrKRYsYXbBhitoI\u0026q=85\u0026s=b717e05282be47857b4c42e3c9f28b15"},"favicon":"https://mintcdn.com/superx/ZOrKRYsYXbBhitoI/favicon.png?fit=max\u0026auto=format\u0026n=ZOrKRYsYXbBhitoI\u0026q=85\u0026s=05aaa6612cdd959e0edb14d963806660","appearance":{"default":"system"},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"superx","hasAudioNarration":false,"actualSubdomain":"superx","customDomains":["docs.superx.so"],"gitSource":{"type":"github","owner":"superx-so","repo":"superx-docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"chroma":{"latestBuiltDeploymentHistoryId":"6ac68ff611e54a617d7548d2","collectionId":"371386e6-3679-44e4-aa28-f1b7adee5865","liveDeploymentHistoryId":"6ac68ff611e54a617d7548d2","schemaVersion":"v3"},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6ac68ff611e54a617d7548d2","clientVersion":"0.0.4067","searchFilterCounts":[{"language":"default","tag":"API Reference","count":106},{"language":"default","tag":"Signals","count":12},{"language":"default","tag":"Documentation","count":10},{"language":"default","tag":"Articles","count":10},{"language":"default","tag":"Scheduling","count":10},{"language":"default","tag":"Audience","count":9},{"language":"default","tag":"Contact Lists","count":9},{"language":"default","tag":"Datasets","count":8},{"language":"default","tag":"Context","count":7},{"language":"default","tag":"Engage","count":7}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/audience/read-an-audience-list","slug":"/api-reference/audience/read-an-audience-list","pageMetadata":{"title":"Read an audience list","description":"A page of the account's followers, following, repliers or reposters\nfrom SuperX's synced snapshot.\n\nThese four are the system lists in the app's Contacts tab. They live\nin SuperX's own audience store rather than in the contact lists you\ncreate, which is why `/v1/contact-lists/{id}/members` will not read\nthem and this endpoint exists.\n\nPaging is by CURSOR, not page number: pass `pagination.next_cursor`\nback as `cursor` to continue. A cursor points at the last row of the\npage you were given, so new rows arriving mid-walk never shift the\npages you already read. There is no `total`; `meta.synced_count` is\nthe size of the whole list.\n\n`followers` and `following` come from the follow graph SuperX syncs\nfor the account, so `meta` reports the sync `status`, the plan's\n`backfill_cap` and whether the account is deeper than that cap.\n`repliers` and `reposters` are a rolling 90-day window\n(`meta.window_days`), so someone whose last reply ages past 90 days\ndrops out and reappears on their next reply.\n\n`engaged_count` is replies plus reposts in the last 90 days for the\nfollow lists, and this list's own action count for `repliers` and\n`reposters`. `icp_score` and `icp_rationale` are always null here:\nscoring belongs to signal-agent deposits, not to the snapshot.\n","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /v1/audience/{kind}","href":"/api-reference/audience/read-an-audience-list","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {Fragment: _Fragment, jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_Fragment, {\n children: [_jsx(_components.p, {\n children: \"A page of the account’s followers, following, repliers or reposters\\nfrom SuperX’s synced snapshot.\"\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"These four are the system lists in the app’s Contacts tab. They live\\nin SuperX’s own audience store rather than in the contact lists you\\ncreate, which is why \", _jsx(_components.code, {\n children: \"/v1/contact-lists/{id}/members\"\n }), \" will not read\\nthem and this endpoint exists.\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"Paging is by CURSOR, not page number: pass \", _jsx(_components.code, {\n children: \"pagination.next_cursor\"\n }), \"\\nback as \", _jsx(_components.code, {\n children: \"cursor\"\n }), \" to continue. A cursor points at the last row of the\\npage you were given, so new rows arriving mid-walk never shift the\\npages you already read. There is no \", _jsx(_components.code, {\n children: \"total\"\n }), \"; \", _jsx(_components.code, {\n children: \"meta.synced_count\"\n }), \" is\\nthe size of the whole list.\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [_jsx(_components.code, {\n children: \"followers\"\n }), \" and \", _jsx(_components.code, {\n children: \"following\"\n }), \" come from the follow graph SuperX syncs\\nfor the account, so \", _jsx(_components.code, {\n children: \"meta\"\n }), \" reports the sync \", _jsx(_components.code, {\n children: \"status\"\n }), \", the plan’s\\n\", _jsx(_components.code, {\n children: \"backfill_cap\"\n }), \" and whether the account is deeper than that cap.\\n\", _jsx(_components.code, {\n children: \"repliers\"\n }), \" and \", _jsx(_components.code, {\n children: \"reposters\"\n }), \" are a rolling 90-day window\\n(\", _jsx(_components.code, {\n children: \"meta.window_days\"\n }), \"), so someone whose last reply ages past 90 days\\ndrops out and reappears on their next reply.\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [_jsx(_components.code, {\n children: \"engaged_count\"\n }), \" is replies plus reposts in the last 90 days for the\\nfollow lists, and this list’s own action count for \", _jsx(_components.code, {\n children: \"repliers\"\n }), \" and\\n\", _jsx(_components.code, {\n children: \"reposters\"\n }), \". \", _jsx(_components.code, {\n children: \"icp_score\"\n }), \" and \", _jsx(_components.code, {\n children: \"icp_rationale\"\n }), \" are always null here:\\nscoring belongs to signal-agent deposits, not to the snapshot.\"]\n })]\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Read an audience list","description":"A page of the account's followers, following, repliers or reposters\nfrom SuperX's synced snapshot.\n\nThese four are the system lists in the app's Contacts tab. They live\nin SuperX's own audience store rather than in the contact lists you\ncreate, which is why `/v1/contact-lists/{id}/members` will not read\nthem and this endpoint exists.\n\nPaging is by CURSOR, not page number: pass `pagination.next_cursor`\nback as `cursor` to continue. A cursor points at the last row of the\npage you were given, so new rows arriving mid-walk never shift the\npages you already read. There is no `total`; `meta.synced_count` is\nthe size of the whole list.\n\n`followers` and `following` come from the follow graph SuperX syncs\nfor the account, so `meta` reports the sync `status`, the plan's\n`backfill_cap` and whether the account is deeper than that cap.\n`repliers` and `reposters` are a rolling 90-day window\n(`meta.window_days`), so someone whose last reply ages past 90 days\ndrops out and reappears on their next reply.\n\n`engaged_count` is replies plus reposts in the last 90 days for the\nfollow lists, and this list's own action count for `repliers` and\n`reposters`. `icp_score` and `icp_rationale` are always null here:\nscoring belongs to signal-agent deposits, not to the snapshot.\n","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /v1/audience/{kind}","href":"/api-reference/audience/read-an-audience-list","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["Audience"],"operationId":"getAudience","summary":"Read an audience list","description":"A page of the account's followers, following, repliers or reposters\nfrom SuperX's synced snapshot.\n\nThese four are the system lists in the app's Contacts tab. They live\nin SuperX's own audience store rather than in the contact lists you\ncreate, which is why `/v1/contact-lists/{id}/members` will not read\nthem and this endpoint exists.\n\nPaging is by CURSOR, not page number: pass `pagination.next_cursor`\nback as `cursor` to continue. A cursor points at the last row of the\npage you were given, so new rows arriving mid-walk never shift the\npages you already read. There is no `total`; `meta.synced_count` is\nthe size of the whole list.\n\n`followers` and `following` come from the follow graph SuperX syncs\nfor the account, so `meta` reports the sync `status`, the plan's\n`backfill_cap` and whether the account is deeper than that cap.\n`repliers` and `reposters` are a rolling 90-day window\n(`meta.window_days`), so someone whose last reply ages past 90 days\ndrops out and reappears on their next reply.\n\n`engaged_count` is replies plus reposts in the last 90 days for the\nfollow lists, and this list's own action count for `repliers` and\n`reposters`. `icp_score` and `icp_rationale` are always null here:\nscoring belongs to signal-agent deposits, not to the snapshot.\n","parameters":["a7008072-7c1b-4a9e-8ece-72df9de36686","fd2043de-a255-4623-98d2-a74ba201b8f1","93bed3e3-fbda-4f5a-ab59-64b71a62e602","f9e0b41b-9f35-4cc2-aaa0-53823d1142cc"],"responses":{"200":"7f602da7-06db-458d-958a-b2757b496f45","400":"2ce1b3fa-f0f6-450a-99a8-5040308a598b","401":"7009c4e9-c72f-4408-a924-6e013cca4e6c","403":"49eb9266-d89b-43a5-b08c-32f7e3f3e610","404":"a0a1853f-f264-485d-afe4-ee6caac95e97","429":"e6506716-bf33-4d5a-b27f-063f1fbbad54","500":"ac6d5119-2d60-4b42-8976-950867ffc5bd","503":"9d1cbf9b-ccd1-4ae7-9a13-b5f8e98921e8"},"method":"get","type":"path","servers":["3d538a38-214d-4480-97a3-9a44d5c3102b"],"security":["d3f7d345-7007-489f-b114-dac4df3cb92f"],"path":"/v1/audience/{kind}","baseUrlOptions":["https://api.superx.so"],"title":"Read an audience list","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"a7008072-7c1b-4a9e-8ece-72df9de36686":{"name":"kind","in":"path","required":true,"schema":{"type":"string","enum":["followers","following","repliers","reposters"],"isRequired":true,"uniqueKey":"","typeLabel":"enum\u003cstring>"}},"fd2043de-a255-4623-98d2-a74ba201b8f1":{"name":"account_id","in":"query","required":false,"description":"Account to act on, from `GET /v1/accounts`. Defaults to your main account. An id outside your accounts returns `404 account_not_found`.","schema":{"type":"string","isRequired":false,"description":"Account to act on, from `GET /v1/accounts`. Defaults to your main account. An id outside your accounts returns `404 account_not_found`.","uniqueKey":"","typeLabel":"string"}},"93bed3e3-fbda-4f5a-ab59-64b71a62e602":{"name":"cursor","in":"query","description":"next_cursor from the previous page. Omit for the first page.","schema":{"type":"string","description":"next_cursor from the previous page. Omit for the first page.","uniqueKey":"","typeLabel":"string"}},"f9e0b41b-9f35-4cc2-aaa0-53823d1142cc":{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":100,"default":50,"uniqueKey":"","typeLabel":"integer"}}},"responses":{"7f602da7-06db-458d-958a-b2757b496f45":{"description":"A page of the audience.","headers":{"X-RateLimit-Limit":{"description":"The limit of the rate window closest to exhaustion.","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in that window.","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Unix timestamp (seconds) when that window resets.","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","description":"One person in a system audience list. Field names match\nContactListMember so one mapping covers both, but `id` here is the X\nuser id rather than a membership id (there is nothing to remove).\n","properties":{"id":{"type":"string","description":"The person's X user id (same value as x_user_id).","uniqueKey":"data.items.[INDEX].id","typeLabel":"string"},"x_user_id":{"type":"string","uniqueKey":"data.items.[INDEX].x_user_id","typeLabel":"string"},"username":{"oneOf":[{"type":"string","uniqueKey":"data.items.[INDEX].username.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"data.items.[INDEX].username.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.items.[INDEX].username","typeLabel":"string | null"},"name":{"oneOf":[{"type":"string","uniqueKey":"data.items.[INDEX].name.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"data.items.[INDEX].name.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.items.[INDEX].name","typeLabel":"string | null"},"avatar_url":{"oneOf":[{"type":"string","uniqueKey":"data.items.[INDEX].avatar_url.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"data.items.[INDEX].avatar_url.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.items.[INDEX].avatar_url","typeLabel":"string | null"},"location":{"oneOf":[{"type":"string","uniqueKey":"data.items.[INDEX].location.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"data.items.[INDEX].location.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.items.[INDEX].location","typeLabel":"string | null"},"followers_count":{"oneOf":[{"type":"integer","uniqueKey":"data.items.[INDEX].followers_count.oneOf.0","typeLabel":"integer"},{"type":"null","uniqueKey":"data.items.[INDEX].followers_count.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.items.[INDEX].followers_count","typeLabel":"integer | null"},"following_count":{"oneOf":[{"type":"integer","uniqueKey":"data.items.[INDEX].following_count.oneOf.0","typeLabel":"integer"},{"type":"null","uniqueKey":"data.items.[INDEX].following_count.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.items.[INDEX].following_count","typeLabel":"integer | null"},"engaged_count":{"type":"integer","description":"Replies + reposts to the account in the last 90 days for\nfollowers/following; this list's own action count for\nrepliers/reposters.\n","uniqueKey":"data.items.[INDEX].engaged_count","typeLabel":"integer"},"source":{"type":"string","description":"The audience kind this row came from.","uniqueKey":"data.items.[INDEX].source","typeLabel":"string"},"added_at":{"oneOf":[{"type":"string","format":"date-time","description":"When SuperX first saw the follow edge, or the person's most\nrecent reply or repost.\n","uniqueKey":"data.items.[INDEX].added_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","description":"When SuperX first saw the follow edge, or the person's most\nrecent reply or repost.\n","uniqueKey":"data.items.[INDEX].added_at.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.items.[INDEX].added_at","typeLabel":"string\u003cdate-time> | null"},"icp_score":{"oneOf":[{"type":"integer","description":"Always null here; lead scoring belongs to signal-agent deposits.","uniqueKey":"data.items.[INDEX].icp_score.oneOf.0","typeLabel":"integer"},{"type":"null","description":"Always null here; lead scoring belongs to signal-agent deposits.","uniqueKey":"data.items.[INDEX].icp_score.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.items.[INDEX].icp_score","typeLabel":"integer | null"},"icp_rationale":{"oneOf":[{"type":"string","description":"Always null here.","uniqueKey":"data.items.[INDEX].icp_rationale.oneOf.0","typeLabel":"string"},{"type":"null","description":"Always null here.","uniqueKey":"data.items.[INDEX].icp_rationale.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.items.[INDEX].icp_rationale","typeLabel":"string | null"},"can_dm":{"oneOf":[{"type":"boolean","description":"Whether the person's DMs looked open when SuperX last saw them.","uniqueKey":"data.items.[INDEX].can_dm.oneOf.0","typeLabel":"boolean"},{"type":"null","description":"Whether the person's DMs looked open when SuperX last saw them.","uniqueKey":"data.items.[INDEX].can_dm.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.items.[INDEX].can_dm","typeLabel":"boolean | null"}},"uniqueKey":"data.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data","typeLabel":"object[]"},"meta":{"type":"object","description":"The state of the whole audience list, not of this page.","properties":{"kind":{"type":"string","enum":["followers","following","repliers","reposters"],"uniqueKey":"meta.kind","typeLabel":"enum\u003cstring>"},"account_id":{"type":"string","description":"The account id you pass as `account_id`, echoed back. Same id\nspace as every other /v1 surface.\n","uniqueKey":"meta.account_id","typeLabel":"string"},"x_account_id":{"type":"string","description":"The X user id the audience is stored under.","uniqueKey":"meta.x_account_id","typeLabel":"string"},"synced_count":{"type":"integer","description":"How many people SuperX has synced for this list. For followers\nand following this counts synced edges rather than re-checking\nevery one against X, so it may exceed the rows a full walk\nreturns: edges that were later removed are still counted.\n","uniqueKey":"meta.synced_count","typeLabel":"integer"},"status":{"type":"string","description":"Sync state: missing (never started), pending, running, complete\nor paused for the follow lists; missing, running or complete for\nrepliers and reposters.\n","uniqueKey":"meta.status","typeLabel":"string"},"backfill_cap":{"oneOf":[{"type":"integer","description":"How deep the plan syncs the follow graph. Null for repliers and\nreposters.\n","uniqueKey":"meta.backfill_cap.oneOf.0","typeLabel":"integer"},{"type":"null","description":"How deep the plan syncs the follow graph. Null for repliers and\nreposters.\n","uniqueKey":"meta.backfill_cap.oneOf.1","typeLabel":"null"}],"uniqueKey":"meta.backfill_cap","typeLabel":"integer | null"},"is_capped":{"oneOf":[{"type":"boolean","description":"True when the account is deeper than backfill_cap, so the list is\nthe most recent slice rather than everyone. Null for repliers and\nreposters.\n","uniqueKey":"meta.is_capped.oneOf.0","typeLabel":"boolean"},{"type":"null","description":"True when the account is deeper than backfill_cap, so the list is\nthe most recent slice rather than everyone. Null for repliers and\nreposters.\n","uniqueKey":"meta.is_capped.oneOf.1","typeLabel":"null"}],"uniqueKey":"meta.is_capped","typeLabel":"boolean | null"},"window_days":{"oneOf":[{"type":"integer","description":"The rolling window repliers and reposters are measured over (90).\nNull for the follow lists, which are not windowed.\n","uniqueKey":"meta.window_days.oneOf.0","typeLabel":"integer"},{"type":"null","description":"The rolling window repliers and reposters are measured over (90).\nNull for the follow lists, which are not windowed.\n","uniqueKey":"meta.window_days.oneOf.1","typeLabel":"null"}],"uniqueKey":"meta.window_days","typeLabel":"integer | null"}},"uniqueKey":"meta","typeLabel":"object"},"pagination":{"type":"object","description":"Keyset pagination. `next_cursor` is present only when `has_more` is\ntrue; pass it back as `cursor` to read the next page. Cursors are\nopaque and are not valid across different queries.\n","required":["has_more"],"properties":{"has_more":{"type":"boolean","isRequired":true,"uniqueKey":"pagination.has_more","typeLabel":"boolean"},"limit":{"type":"integer","description":"Absent on endpoints whose page size is fixed upstream.","uniqueKey":"pagination.limit","typeLabel":"integer"},"next_cursor":{"type":"string","uniqueKey":"pagination.next_cursor","typeLabel":"string"}},"uniqueKey":"pagination","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"example":{"data":[{"id":"44196397001234567","x_user_id":"44196397001234567","username":"activefan","name":"Sam Porter","avatar_url":"https://pbs.twimg.com/profile_images/example3.jpg","location":"Lisbon","followers_count":3120,"following_count":480,"engaged_count":12,"source":"followers","added_at":"2026-08-30T09:14:00.000Z","icp_score":null,"icp_rationale":null,"can_dm":true}],"meta":{"kind":"followers","account_id":"9HVHDe4WsJfJcR5SFauMD","x_account_id":"1178367350552305665","synced_count":13270,"status":"complete","backfill_cap":25000,"is_capped":false,"window_days":null},"pagination":{"limit":50,"has_more":true,"next_cursor":"MTc1NjU0NDA0MDAwMDo0NDE5NjM5NzAwMTIzNDU2Nw"}},"examples":{"Example":{"title":"Example","value":{"data":[{"id":"44196397001234567","x_user_id":"44196397001234567","username":"activefan","name":"Sam Porter","avatar_url":"https://pbs.twimg.com/profile_images/example3.jpg","location":"Lisbon","followers_count":3120,"following_count":480,"engaged_count":12,"source":"followers","added_at":"2026-08-30T09:14:00.000Z","icp_score":null,"icp_rationale":null,"can_dm":true}],"meta":{"kind":"followers","account_id":"9HVHDe4WsJfJcR5SFauMD","x_account_id":"1178367350552305665","synced_count":13270,"status":"complete","backfill_cap":25000,"is_capped":false,"window_days":null},"pagination":{"limit":50,"has_more":true,"next_cursor":"MTc1NjU0NDA0MDAwMDo0NDE5NjM5NzAwMTIzNDU2Nw"}}}},"exampleType":"examples"}},"exampleType":"examples"},"2ce1b3fa-f0f6-450a-99a8-5040308a598b":{"description":"A parameter is missing, malformed, or out of range.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","description":"Stable machine-readable error code.","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"retry_after":{"type":"integer","description":"Seconds to wait before retrying (rate-limit errors only).","uniqueKey":"error.retry_after","typeLabel":"integer"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"example":{"error":{"code":"invalid_parameter","message":"since must be a UTC ISO-8601 timestamp"}},"examples":{"Example":{"title":"Example","value":{"error":{"code":"invalid_parameter","message":"since must be a UTC ISO-8601 timestamp"}}}},"exampleType":"examples"}},"exampleType":"examples"},"7009c4e9-c72f-4408-a924-6e013cca4e6c":{"description":"Missing/malformed Authorization header (`unauthorized`) or an unknown/revoked key (`invalid_api_key`).","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","description":"Stable machine-readable error code.","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"retry_after":{"type":"integer","description":"Seconds to wait before retrying (rate-limit errors only).","uniqueKey":"error.retry_after","typeLabel":"integer"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"example":{"error":{"code":"invalid_api_key","message":"Unknown or revoked API key"}},"examples":{"Example":{"title":"Example","value":{"error":{"code":"invalid_api_key","message":"Unknown or revoked API key"}}}},"exampleType":"examples"}},"exampleType":"examples"},"49eb9266-d89b-43a5-b08c-32f7e3f3e610":{"description":"Subscription lapsed. NOTE the legacy body shape: `error` is a plain\nstring here, not the `{ code, message }` object. Read-only keys on\nwrite endpoints instead get the object envelope with code\n`insufficient_scope`.\n","content":{"application/json":{"schema":{"oneOf":[{"type":"object","description":"Legacy shape used ONLY by the shared subscription middleware: a plain\nstring `error` field. Seen on `403` when the subscription has lapsed\n(string starts with \"subscription_required:\") and on `500` when\nsubscription verification fails (string starts with \"internal_error:\").\n","required":["error"],"properties":{"error":{"type":"string","example":"subscription_required: The SuperX API requires an active subscription","isRequired":true,"uniqueKey":"oneOf.0.error","typeLabel":"string"}},"uniqueKey":"oneOf.0","typeLabel":"object"},{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","description":"Stable machine-readable error code.","isRequired":true,"uniqueKey":"oneOf.1.error.code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"oneOf.1.error.message","typeLabel":"string"},"retry_after":{"type":"integer","description":"Seconds to wait before retrying (rate-limit errors only).","uniqueKey":"oneOf.1.error.retry_after","typeLabel":"integer"}},"isRequired":true,"uniqueKey":"oneOf.1.error","typeLabel":"object"}},"uniqueKey":"oneOf.1","typeLabel":"object"}],"uniqueKey":"","typeLabel":"object"},"example":{"error":"subscription_required: The SuperX API requires an active subscription"},"examples":{"Example":{"title":"Example","value":{"error":"subscription_required: The SuperX API requires an active subscription"}}},"exampleType":"examples"}},"exampleType":"examples"},"a0a1853f-f264-485d-afe4-ee6caac95e97":{"description":"account_id is not one of your accounts.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","description":"Stable machine-readable error code.","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"retry_after":{"type":"integer","description":"Seconds to wait before retrying (rate-limit errors only).","uniqueKey":"error.retry_after","typeLabel":"integer"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"example":{"error":{"code":"account_not_found","message":"No account with that id belongs to this key"}},"examples":{"Example":{"title":"Example","value":{"error":{"code":"account_not_found","message":"No account with that id belongs to this key"}}}},"exampleType":"examples"}},"exampleType":"examples"},"e6506716-bf33-4d5a-b27f-063f1fbbad54":{"description":"Rate limit exceeded (limits vary by plan). Honor Retry-After.","headers":{"Retry-After":{"description":"Seconds to wait before retrying.","schema":{"type":"integer"}},"X-RateLimit-Limit":{"description":"The limit of the rate window closest to exhaustion.","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in that window.","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Unix timestamp (seconds) when that window resets.","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","description":"Stable machine-readable error code.","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"retry_after":{"type":"integer","description":"Seconds to wait before retrying (rate-limit errors only).","uniqueKey":"error.retry_after","typeLabel":"integer"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"example":{"error":{"code":"rate_limited","message":"Rate limit exceeded for the Pro plan (30 requests/min). Upgrade for higher limits.","retry_after":42}},"examples":{"Example":{"title":"Example","value":{"error":{"code":"rate_limited","message":"Rate limit exceeded for the Pro plan (30 requests/min). Upgrade for higher limits.","retry_after":42}}}},"exampleType":"examples"}},"exampleType":"examples"},"ac6d5119-2d60-4b42-8976-950867ffc5bd":{"description":"Unexpected server error. May also use the legacy string envelope when subscription verification fails.","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","description":"Stable machine-readable error code.","isRequired":true,"uniqueKey":"oneOf.0.error.code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"oneOf.0.error.message","typeLabel":"string"},"retry_after":{"type":"integer","description":"Seconds to wait before retrying (rate-limit errors only).","uniqueKey":"oneOf.0.error.retry_after","typeLabel":"integer"}},"isRequired":true,"uniqueKey":"oneOf.0.error","typeLabel":"object"}},"uniqueKey":"oneOf.0","typeLabel":"object"},{"type":"object","description":"Legacy shape used ONLY by the shared subscription middleware: a plain\nstring `error` field. Seen on `403` when the subscription has lapsed\n(string starts with \"subscription_required:\") and on `500` when\nsubscription verification fails (string starts with \"internal_error:\").\n","required":["error"],"properties":{"error":{"type":"string","example":"subscription_required: The SuperX API requires an active subscription","isRequired":true,"uniqueKey":"oneOf.1.error","typeLabel":"string"}},"uniqueKey":"oneOf.1","typeLabel":"object"}],"uniqueKey":"","typeLabel":"object"},"example":{"error":{"code":"internal_error","message":"Failed to fetch posts"}},"examples":{"Example":{"title":"Example","value":{"error":{"code":"internal_error","message":"Failed to fetch posts"}}}},"exampleType":"examples"}},"exampleType":"examples"},"9d1cbf9b-ccd1-4ae7-9a13-b5f8e98921e8":{"description":"Linked-account verification is temporarily unavailable (fail closed). The main account keeps working.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","description":"Stable machine-readable error code.","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"retry_after":{"type":"integer","description":"Seconds to wait before retrying (rate-limit errors only).","uniqueKey":"error.retry_after","typeLabel":"integer"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"example":{"error":{"code":"accounts_unavailable","message":"Account information is temporarily unavailable. Try again shortly."}},"examples":{"Example":{"title":"Example","value":{"error":{"code":"accounts_unavailable","message":"Account information is temporarily unavailable. Try again shortly."}}}},"exampleType":"examples"}},"exampleType":"examples"}},"security":{"d3f7d345-7007-489f-b114-dac4df3cb92f":{"apiKey":{"type":"http","scheme":"bearer","description":"A SuperX API key (\"sxk_...\"), created in the SuperX app under Account > API / MCP / CLI. Keys are server-side secrets.","scopes":[],"schemeName":"apiKey"}}},"servers":{"3d538a38-214d-4480-97a3-9a44d5c3102b":{"url":"https://api.superx.so"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","description":"A SuperX API key (\"sxk_...\"), created in the SuperX app under Account > API / MCP / CLI. Keys are server-side secrets.","scopes":[],"schemeName":"apiKey"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"A SuperX API key (\"sxk_...\"), created in the SuperX app under Account > API / MCP / CLI. Keys are server-side secrets.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"apiKey","name":"Authorization"}],"title":"apiKey"}]},"originalFileLocation":"api-reference/openapi.yaml"},"subdomain":"superx","siteName":"SuperX","title":"Read an audience list - SuperX","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-07T18:31:24.762Z","originalFileLocation":"api-reference/audience/read-an-audience-list.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"A page of the account\u0026#x27;s followers, following, repliers or reposters from SuperX\u0026#x27;s synced snapshot. These four are the system lists in the app\u0026#x27;s Contacts tab. They live in SuperX\u0026#x27;s own audience store rather than in the contact lists you create, which is why /v1/contact-lists/{id}/members will not read them and this endpoint exists. Paging is by CURSOR, not page number: pass pagination.next_cursor back as cursor to continue. A cursor points at the last row of the page you were given, so new rows arriving mid-walk never shift the pages you already read. There is no total; meta.synced_count is the size of the whole list. followers and following come from the follow graph SuperX syncs for the account, so meta reports the sync status, the plan\u0026#x27;s backfill_cap and whether the account is deeper than that cap. repliers and reposters are a rolling 90-day window (meta.window_days), so someone whose last reply ages past 90 days drops out and reappears on their next reply. engaged_count is replies plus reposts in the last 90 days for the follow lists, and this list\u0026#x27;s own action count for repliers and reposters. icp_score and icp_rationale are always null here: scoring belongs to signal-agent deposits, not to the snapshot.\">\u003cmeta data-mint-head name=\"application-name\" content=\"SuperX\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/superx/Ohz_C_TMxE84ikvK/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/superx/Ohz_C_TMxE84ikvK/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/superx/Ohz_C_TMxE84ikvK/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/superx/Ohz_C_TMxE84ikvK/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/superx/Ohz_C_TMxE84ikvK/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/superx/Ohz_C_TMxE84ikvK/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/superx/Ohz_C_TMxE84ikvK/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/superx/Ohz_C_TMxE84ikvK/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/superx/Ohz_C_TMxE84ikvK/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Read an audience list - SuperX\">\u003cmeta data-mint-head property=\"og:description\" content=\"A page of the account\u0026#x27;s followers, following, repliers or reposters from SuperX\u0026#x27;s synced snapshot. These four are the system lists in the app\u0026#x27;s Contacts tab. They live in SuperX\u0026#x27;s own audience store rather than in the contact lists you create, which is why /v1/contact-lists/{id}/members will not read them and this endpoint exists. Paging is by CURSOR, not page number: pass pagination.next_cursor back as cursor to continue. A cursor points at the last row of the page you were given, so new rows arriving mid-walk never shift the pages you already read. There is no total; meta.synced_count is the size of the whole list. followers and following come from the follow graph SuperX syncs for the account, so meta reports the sync status, the plan\u0026#x27;s backfill_cap and whether the account is deeper than that cap. repliers and reposters are a rolling 90-day window (meta.window_days), so someone whose last reply ages past 90 days drops out and reappears on their next reply. engaged_count is replies plus reposts in the last 90 days for the follow lists, and this list\u0026#x27;s own action count for repliers and reposters. icp_score and icp_rationale are always null here: scoring belongs to signal-agent deposits, not to the snapshot.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"SuperX\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.superx.so/api-reference/audience/read-an-audience-list\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://superx.mintlify.app/_mintlify/api/og/v2?division=Audience\u0026amp;title=Read+an+audience+list\u0026amp;description=A+page+of+the+account%27s+followers%2C+following%2C+repliers+or+reposters%0Afrom+SuperX%27s+synced+snapshot.%0A%0AThese+four+are+the+system+lists+in+the+app%27s+Contacts+tab.+T\u0026amp;theme=4e9a0bdaa172d4dfc537fe9f\u0026amp;signature=9d26cc3f1a5b01ad270733098eb6592f0a75581110809033092a62aeaf4b8d69\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Read an audience list - SuperX\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"A page of the account\u0026#x27;s followers, following, repliers or reposters from SuperX\u0026#x27;s synced snapshot. These four are the system lists in the app\u0026#x27;s Contacts tab. They live in SuperX\u0026#x27;s own audience store rather than in the contact lists you create, which is why /v1/contact-lists/{id}/members will not read them and this endpoint exists. Paging is by CURSOR, not page number: pass pagination.next_cursor back as cursor to continue. A cursor points at the last row of the page you were given, so new rows arriving mid-walk never shift the pages you already read. There is no total; meta.synced_count is the size of the whole list. followers and following come from the follow graph SuperX syncs for the account, so meta reports the sync status, the plan\u0026#x27;s backfill_cap and whether the account is deeper than that cap. repliers and reposters are a rolling 90-day window (meta.window_days), so someone whose last reply ages past 90 days drops out and reappears on their next reply. engaged_count is replies plus reposts in the last 90 days for the follow lists, and this list\u0026#x27;s own action count for repliers and reposters. icp_score and icp_rationale are always null here: scoring belongs to signal-agent deposits, not to the snapshot.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://superx.mintlify.app/_mintlify/api/og/v2?division=Audience\u0026amp;title=Read+an+audience+list\u0026amp;description=A+page+of+the+account%27s+followers%2C+following%2C+repliers+or+reposters%0Afrom+SuperX%27s+synced+snapshot.%0A%0AThese+four+are+the+system+lists+in+the+app%27s+Contacts+tab.+T\u0026amp;theme=4e9a0bdaa172d4dfc537fe9f\u0026amp;signature=9d26cc3f1a5b01ad270733098eb6592f0a75581110809033092a62aeaf4b8d69\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/superx/Ohz_C_TMxE84ikvK/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"SuperX\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#F4503B\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.superx.so/api-reference/audience/read-an-audience-list\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/audience/read-an-audience-list.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.superx.so/#organization\",\"name\":\"SuperX\",\"url\":\"https://docs.superx.so\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/superx/ZOrKRYsYXbBhitoI/logo/light.svg?fit=max\u0026auto=format\u0026n=ZOrKRYsYXbBhitoI\u0026q=85\u0026s=d465c38938c34f6ab75cfc50d0039be2\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.superx.so#website\",\"name\":\"SuperX\",\"url\":\"https://docs.superx.so\",\"publisher\":{\"@id\":\"https://docs.superx.so/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.superx.so/api-reference/audience/read-an-audience-list#webpage\",\"url\":\"https://docs.superx.so/api-reference/audience/read-an-audience-list\",\"name\":\"Read an audience list\",\"description\":\"A page of the account's followers, following, repliers or reposters from SuperX's synced snapshot. These four are the system lists in the app's Contacts tab. They live in SuperX's own audience store rather than in the contact lists you create, which is why /v1/contact-lists/{id}/members will not read them and this endpoint exists. Paging is by CURSOR, not page number: pass pagination.next_cursor back as cursor to continue. A cursor points at the last row of the page you were given, so new rows arriving mid-walk never shift the pages you already read. There is no total; meta.synced_count is the size of the whole list. followers and following come from the follow graph SuperX syncs for the account, so meta reports the sync status, the plan's backfill_cap and whether the account is deeper than that cap. repliers and reposters are a rolling 90-day window (meta.window_days), so someone whose last reply ages past 90 days drops out and reappears on their next reply. engaged_count is replies plus reposts in the last 90 days for the follow lists, and this list's own action count for repliers and reposters. icp_score and icp_rationale are always null here: scoring belongs to signal-agent deposits, not to the snapshot.\",\"dateModified\":\"2026-10-07T18:31:24.762Z\",\"isPartOf\":{\"@id\":\"https://docs.superx.so#website\"},\"breadcrumb\":{\"@id\":\"https://docs.superx.so/api-reference/audience/read-an-audience-list#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.superx.so/api-reference/audience/read-an-audience-list#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Audience\",\"item\":\"https://docs.superx.so/api-reference/audience/list-replies-you-received\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Read an audience list\",\"item\":\"https://docs.superx.so/api-reference/audience/read-an-audience-list\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.superx.so/api-reference/audience/read-an-audience-list#apireference\",\"headline\":\"Read an audience list\",\"name\":\"Read an audience list\",\"description\":\"A page of the account's followers, following, repliers or reposters from SuperX's synced snapshot. These four are the system lists in the app's Contacts tab. They live in SuperX's own audience store rather than in the contact lists you create, which is why /v1/contact-lists/{id}/members will not read them and this endpoint exists. Paging is by CURSOR, not page number: pass pagination.next_cursor back as cursor to continue. A cursor points at the last row of the page you were given, so new rows arriving mid-walk never shift the pages you already read. There is no total; meta.synced_count is the size of the whole list. followers and following come from the follow graph SuperX syncs for the account, so meta reports the sync status, the plan's backfill_cap and whether the account is deeper than that cap. repliers and reposters are a rolling 90-day window (meta.window_days), so someone whose last reply ages past 90 days drops out and reappears on their next reply. engaged_count is replies plus reposts in the last 90 days for the follow lists, and this list's own action count for repliers and reposters. icp_score and icp_rationale are always null here: scoring belongs to signal-agent deposits, not to the snapshot.\",\"url\":\"https://docs.superx.so/api-reference/audience/read-an-audience-list\",\"mainEntityOfPage\":{\"@id\":\"https://docs.superx.so/api-reference/audience/read-an-audience-list#webpage\"},\"dateModified\":\"2026-10-07T18:31:24.762Z\",\"publisher\":{\"@id\":\"https://docs.superx.so/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.superx.so#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"SuperX\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"SuperX","nav":{"global":null,"tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":"/introduction"}]},{"tab":"API Reference","groups":[{"group":"Identity","pages":[{"title":"Get the key owner","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /v1/me","href":"/api-reference/identity/get-the-key-owner"},{"title":"List your accounts","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /v1/accounts","href":"/api-reference/identity/list-your-accounts"}]},{"group":"Content","pages":[{"title":"List published posts","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /v1/posts","href":"/api-reference/content/list-published-posts"},{"title":"List replies you sent","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /v1/replies","href":"/api-reference/content/list-replies-you-sent"}]},{"group":"Analytics","pages":[{"title":"Get analytics","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /v1/posts/analytics","href":"/api-reference/analytics/get-analytics"}]},{"group":"Scheduling","pages":[{"title":"Write post drafts in your voice","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /v1/posts/draft","href":"/api-reference/scheduling/write-post-drafts-in-your-voice"},{"title":"Rewrite a post in your voice","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /v1/posts/remix","href":"/api-reference/scheduling/rewrite-a-post-in-your-voice"},{"title":"List drafts and scheduled posts","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /v1/scheduled-posts","href":"/api-reference/scheduling/list-drafts-and-scheduled-posts"},{"title":"Create a draft or scheduled post, or publish now","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /v1/scheduled-posts","href":"/api-reference/scheduling/create-a-draft-or-scheduled-post-or-publish-now"},{"title":"Retime queued posts in bulk","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /v1/scheduled-posts/bulk/retime","href":"/api-reference/scheduling/retime-queued-posts-in-bulk"},{"title":"Enable auto retweet on queued posts in bulk","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /v1/scheduled-posts/bulk/auto-retweet","href":"/api-reference/scheduling/enable-auto-retweet-on-queued-posts-in-bulk"},{"title":"Delete queued posts in bulk","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /v1/scheduled-posts/bulk/delete","href":"/api-reference/scheduling/delete-queued-posts-in-bulk"},{"title":"Delete a draft or scheduled post","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml delete /v1/scheduled-posts/{id}","href":"/api-reference/scheduling/delete-a-draft-or-scheduled-post"},{"title":"Edit a draft or scheduled post","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml patch /v1/scheduled-posts/{id}","href":"/api-reference/scheduling/edit-a-draft-or-scheduled-post"},{"title":"List plug templates","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /v1/plug-templates","href":"/api-reference/scheduling/list-plug-templates"}]},{"group":"Tools","pages":[{"title":"Edit one selected piece of a post","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /v1/tools/inline-edit","href":"/api-reference/tools/edit-one-selected-piece-of-a-post"},{"title":"Rewrite a post one preset way","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /v1/tools/rephrase","href":"/api-reference/tools/rewrite-a-post-one-preset-way"},{"title":"Check a statement against a web search","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /v1/tools/factcheck","href":"/api-reference/tools/check-a-statement-against-a-web-search"},{"title":"Score a draft against this account's own posts","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /v1/posts/viral-score","href":"/api-reference/tools/score-a-draft-against-this-accounts-own-posts"},{"title":"Sort recent posts on a topic into Read, Pass or Not sure","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /v1/posts/triage","href":"/api-reference/tools/sort-recent-posts-on-a-topic-into-read-pass-or-not-sure"}]},{"group":"Audience","pages":[{"title":"List replies you received","description":"Every stored reply the selected account has received across all of its posts, with the replier's profile and the replied-to post when available.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /v1/replies/received","href":"/api-reference/audience/list-replies-you-received"},{"title":"Read an audience list","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /v1/audience/{kind}","href":"/api-reference/audience/read-an-audience-list"},{"title":"List engaged contacts","description":"People who engaged with the selected account over the moving 90-day window, with reply and repost tallies.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /v1/contacts","href":"/api-reference/audience/list-engaged-contacts"},{"title":"Get one contact","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /v1/contacts/{id}","href":"/api-reference/audience/get-one-contact"},{"title":"List one contact's replies to you","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /v1/contacts/{id}/replies","href":"/api-reference/audience/list-one-contacts-replies-to-you"},{"title":"List notes on a contact","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /v1/contacts/{id}/notes","href":"/api-reference/audience/list-notes-on-a-contact"},{"title":"Add a note to a contact","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /v1/contacts/{id}/notes","href":"/api-reference/audience/add-a-note-to-a-contact"},{"title":"Delete a note on a contact","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml delete /v1/contacts/{id}/notes/{noteId}","href":"/api-reference/audience/delete-a-note-on-a-contact"},{"title":"Edit a note on a contact","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml patch /v1/contacts/{id}/notes/{noteId}","href":"/api-reference/audience/edit-a-note-on-a-contact"}]},{"group":"Inspiration","pages":[{"title":"Search the inspiration library","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /v1/inspiration","href":"/api-reference/inspiration/search-the-inspiration-library"},{"title":"Search the inspiration media index","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /v1/inspiration/media","href":"/api-reference/inspiration/search-the-inspiration-media-index"}]},{"group":"Contact Lists","pages":[{"title":"List contact lists","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /v1/contact-lists","href":"/api-reference/contact-lists/list-contact-lists"},{"title":"Create a contact list","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /v1/contact-lists","href":"/api-reference/contact-lists/create-a-contact-list"},{"title":"Delete a contact list","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml delete /v1/contact-lists/{id}","href":"/api-reference/contact-lists/delete-a-contact-list"},{"title":"Rename a contact list","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml patch /v1/contact-lists/{id}","href":"/api-reference/contact-lists/rename-a-contact-list"},{"title":"List contact list members","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /v1/contact-lists/{id}/members","href":"/api-reference/contact-lists/list-contact-list-members"},{"title":"Add a contact list member","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /v1/contact-lists/{id}/members","href":"/api-reference/contact-lists/add-a-contact-list-member"},{"title":"Remove a contact list member","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml delete /v1/contact-lists/{id}/members/{memberId}","href":"/api-reference/contact-lists/remove-a-contact-list-member"},{"title":"Add contact list members in bulk","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /v1/contact-lists/{id}/members/bulk","href":"/api-reference/contact-lists/add-contact-list-members-in-bulk"},{"title":"Remove contact list members in bulk","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /v1/contact-lists/{id}/members/bulk-delete","href":"/api-reference/contact-lists/remove-contact-list-members-in-bulk"}]},{"group":"Signals","pages":[{"title":"List signal agents","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /v1/signals/agents","href":"/api-reference/signals/list-signal-agents"},{"title":"Create a signal agent","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /v1/signals/agents","href":"/api-reference/signals/create-a-signal-agent"},{"title":"Delete a signal agent","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml delete /v1/signals/agents/{id}","href":"/api-reference/signals/delete-a-signal-agent"},{"title":"Update a signal agent","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml patch /v1/signals/agents/{id}","href":"/api-reference/signals/update-a-signal-agent"},{"title":"Add a signal to an agent","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /v1/signals/agents/{id}/signals","href":"/api-reference/signals/add-a-signal-to-an-agent"},{"title":"Remove a signal from an agent","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml delete /v1/signals/agents/{id}/signals/{signalId}","href":"/api-reference/signals/remove-a-signal-from-an-agent"},{"title":"Set feedback on a lead","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /v1/signals/leads/{id}/feedback","href":"/api-reference/signals/set-feedback-on-a-lead"},{"title":"Search for leads on X now","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /v1/signals/leads/search","href":"/api-reference/signals/search-for-leads-on-x-now"},{"title":"List signal leads","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /v1/signals/leads","href":"/api-reference/signals/list-signal-leads"},{"title":"Suggest keyword watches","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /v1/signals/keywords/suggest","href":"/api-reference/signals/suggest-keyword-watches"},{"title":"Expand an audience description into a rubric","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /v1/signals/icp/expand","href":"/api-reference/signals/expand-an-audience-description-into-a-rubric"},{"title":"Build an audience profile from a website","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /v1/signals/icp/expand-from-url","href":"/api-reference/signals/build-an-audience-profile-from-a-website"}]},{"group":"Engage","pages":[{"title":"List Engage feeds","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /v1/engage/feeds","href":"/api-reference/engage/list-engage-feeds"},{"title":"Create an Engage feed","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /v1/engage/feeds","href":"/api-reference/engage/create-an-engage-feed"},{"title":"Delete an Engage feed","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml delete /v1/engage/feeds/{id}","href":"/api-reference/engage/delete-an-engage-feed"},{"title":"Update an Engage feed","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml patch /v1/engage/feeds/{id}","href":"/api-reference/engage/update-an-engage-feed"},{"title":"Get posts from an Engage feed","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /v1/engage/feeds/{id}/posts","href":"/api-reference/engage/get-posts-from-an-engage-feed"},{"title":"Get mentions of the account","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /v1/engage/mentions","href":"/api-reference/engage/get-mentions-of-the-account"},{"title":"Draft one reply to a post","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /v1/engage/reply-draft","href":"/api-reference/engage/draft-one-reply-to-a-post"}]},{"group":"Media","pages":[{"title":"Presign an image upload","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /v1/media","href":"/api-reference/media/presign-an-image-upload"}]},{"group":"Workers","pages":[{"title":"List Workers","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /v1/workers","href":"/api-reference/workers/list-workers"},{"title":"List Worker suggestions","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /v1/workers/suggestions","href":"/api-reference/workers/list-worker-suggestions"},{"title":"Save a suggestion as a draft","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /v1/workers/suggestions/{id}/draft","href":"/api-reference/workers/save-a-suggestion-as-a-draft"},{"title":"Schedule a suggestion","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /v1/workers/suggestions/{id}/schedule","href":"/api-reference/workers/schedule-a-suggestion"},{"title":"Dismiss a suggestion","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /v1/workers/suggestions/{id}/dismiss","href":"/api-reference/workers/dismiss-a-suggestion"}]},{"group":"Context","pages":[{"title":"Get context settings","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /v1/context","href":"/api-reference/context/get-context-settings"},{"title":"Update context settings","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml patch /v1/context","href":"/api-reference/context/update-context-settings"},{"title":"Replace the product list","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml put /v1/context/products","href":"/api-reference/context/replace-the-product-list"},{"title":"Remove one product","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml delete /v1/context/products/{id}","href":"/api-reference/context/remove-one-product"},{"title":"Add or edit one product","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml patch /v1/context/products/{id}","href":"/api-reference/context/add-or-edit-one-product"},{"title":"Rebuild the generated style guide","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /v1/context/style-guide/regenerate","href":"/api-reference/context/rebuild-the-generated-style-guide"},{"title":"Refresh a product from its page","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /v1/context/products/{id}/scrape","href":"/api-reference/context/refresh-a-product-from-its-page"}]},{"group":"DMs","pages":[{"title":"Queue a DM campaign","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /v1/dm/campaigns","href":"/api-reference/dms/queue-a-dm-campaign"},{"title":"Read one DM campaign","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /v1/dm/campaigns/{id}","href":"/api-reference/dms/read-one-dm-campaign"},{"title":"Cancel a campaign's unsent messages","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml delete /v1/dm/campaigns/{id}","href":"/api-reference/dms/cancel-a-campaigns-unsent-messages"},{"title":"List the DM queue","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /v1/dm/queue","href":"/api-reference/dms/list-the-dm-queue"},{"title":"DM allowances and usage","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /v1/dm/limits","href":"/api-reference/dms/dm-allowances-and-usage"}]},{"group":"Queue","pages":[{"title":"Get queue settings","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /v1/queue-settings","href":"/api-reference/queue/get-queue-settings"},{"title":"Update queue settings","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml patch /v1/queue-settings","href":"/api-reference/queue/update-queue-settings"}]},{"group":"Tags","pages":[{"title":"List tags","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /v1/tags","href":"/api-reference/tags/list-tags"},{"title":"Create a tag","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /v1/tags","href":"/api-reference/tags/create-a-tag"},{"title":"Delete a tag","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml delete /v1/tags/{id}","href":"/api-reference/tags/delete-a-tag"},{"title":"Rename or recolor a tag","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml patch /v1/tags/{id}","href":"/api-reference/tags/rename-or-recolor-a-tag"}]},{"group":"Articles","pages":[{"title":"List articles","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /v1/articles","href":"/api-reference/articles/list-articles"},{"title":"Create an article draft","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /v1/articles","href":"/api-reference/articles/create-an-article-draft"},{"title":"Get an article","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /v1/articles/{id}","href":"/api-reference/articles/get-an-article"},{"title":"Delete an article","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml delete /v1/articles/{id}","href":"/api-reference/articles/delete-an-article"},{"title":"Edit an article","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml patch /v1/articles/{id}","href":"/api-reference/articles/edit-an-article"},{"title":"Publish an article to X now","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /v1/articles/{id}/publish","href":"/api-reference/articles/publish-an-article-to-x-now"},{"title":"Schedule or reschedule an article","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /v1/articles/{id}/schedule","href":"/api-reference/articles/schedule-or-reschedule-an-article"},{"title":"Unschedule an article","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /v1/articles/{id}/unschedule","href":"/api-reference/articles/unschedule-an-article"},{"title":"Generate an AI cover image","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /v1/articles/{id}/cover","href":"/api-reference/articles/generate-an-ai-cover-image"},{"title":"List saved cover styles","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /v1/cover-styles","href":"/api-reference/articles/list-saved-cover-styles"}]},{"group":"Datasets","pages":[{"title":"List datasets","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /v1/datasets","href":"/api-reference/datasets/list-datasets"},{"title":"Collect an audience into a dataset","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /v1/datasets","href":"/api-reference/datasets/collect-an-audience-into-a-dataset"},{"title":"Get a dataset","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /v1/datasets/{id}","href":"/api-reference/datasets/get-a-dataset"},{"title":"Get dataset rows","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /v1/datasets/{id}/rows","href":"/api-reference/datasets/get-dataset-rows"},{"title":"Export a dataset as CSV","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /v1/datasets/{id}/export","href":"/api-reference/datasets/export-a-dataset-as-csv"},{"title":"Add a dataset's people to a contact list","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /v1/datasets/{id}/contacts","href":"/api-reference/datasets/add-a-datasets-people-to-a-contact-list"},{"title":"Draft outreach messages onto a research dataset","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /v1/datasets/{id}/outreach-drafts","href":"/api-reference/datasets/draft-outreach-messages-onto-a-research-dataset"},{"title":"Refine a dataset by what each person wrote","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /v1/datasets/{id}/refine","href":"/api-reference/datasets/refine-a-dataset-by-what-each-person-wrote"}]},{"group":"X Lookups","pages":[{"title":"Look up one public post live","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /v1/x/posts/{id}","href":"/api-reference/x-lookups/look-up-one-public-post-live"},{"title":"Top replies to a public post","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /v1/x/posts/{id}/replies","href":"/api-reference/x-lookups/top-replies-to-a-public-post"},{"title":"Look up one public profile live","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /v1/x/users/{handle}","href":"/api-reference/x-lookups/look-up-one-public-profile-live"},{"title":"Latest posts of a public account","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /v1/x/users/{handle}/posts","href":"/api-reference/x-lookups/latest-posts-of-a-public-account"}]},{"group":"Meta","pages":[{"title":"Machine-readable quickstart","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /v1/docs","href":"/api-reference/meta/machine-readable-quickstart"}]}]}]},"basePath":"","title":"Read an audience list - SuperX","buildId":"dpl_9VVk5y1P8k1ATeJguVngy9Q3cmbD","deploymentId":"dpl_9VVk5y1P8k1ATeJguVngy9Q3cmbD","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-DX1Meug0.js","utils-B_OMIQVC.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-ChxhRPMa.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-CuKvD8Iv.js","snippetPresets-C5d7p2hp.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-CfHcE8m4.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-C1zZV314.js","shallow-CmQhqCJn.js","getApiPlaygroundDisplay-YRo9s1O7.js","CodeSnippet-RN1MTdfk.js","CodeSnippets-DKLPHxJA.js","Page-BAvA99GL.js","getPastedJson-bz0M41mU.js","icon-CsmhpPrv.js","MethodPill-CNGsVE77.js","DuplicateIcon-DilfU_Z2.js","createIcon-BdsYzQck.js","DynamicMarkdown-CbqEDjbV.js","SectionHeading-O6hXpFCN.js","axios-vUo_bRtp.js","Markdown-nKm-uidQ.js","clsx-ClVdStUn.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-CIQkMg3R.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-ImrFS4Fy.js"]}