{ "data": { "post": { "id": "1938765432109876543", "url": "https://x.com/buildersam/status/1938765432109876543", "text": "I built my first product in 30 days with zero audience. Here is exactly what I would do differently:", "created_at": "2026-06-20T15:04:00.000Z", "author": { "x_user_id": "44196397", "username": "buildersam", "name": "Sam Fields", "avatar_url": "https://pbs.twimg.com/profile_images/1/avatar.jpg", "verified": true, "followers_count": 8421 }, "metrics": { "likes": 4211, "replies": 312, "reposts": 388, "quotes": 44, "views": 512000, "bookmarks": 1904 }, "in_reply_to_id": null } }}
{
"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": "post_not_found",
"message": "No public post with that id. It may be deleted, protected, or the id may be wrong. A live lookup that fails upstream can also report this."
}
}
{
"error": {
"code": "lookup_quota_exceeded",
"message": "Today's live X lookup allowance (300 lookups) is used up. It is shared with Ask SuperX in the app and resets at midnight UTC.",
"retry_after": 20400,
"limit": 300,
"reset_at": 1789430400
}
}
{
"error": {
"code": "upstream_error",
"message": "Failed to fetch scheduled posts. Try again shortly."
}
}
{
"error": {
"code": "upstream_unavailable",
"message": "The scheduling service is temporarily unavailable. Retry with the same Idempotency-Key."
}
}
X Lookups
Look up one public post live
Read one public X post as it is right now: full text (never
shortened), author, engagement counts, media, link card, and the
quoted post one level deep when there is one.
Owner-scoped, so there is no account_id: nothing upstream is
per-X-account. Costs ONE live-enrichment unit, TWO with
include_quotes, and also draws on the shared allowance of 300 live
lookups per UTC day that Ask SuperX in the app uses (see
Rate limits). Repeat lookups of the
same post within 15 minutes may be served from a server-side cache:
they still cost their enrichment units but do not touch the daily
allowance.
404 post_not_found means the post is deleted, protected, or the id
is wrong. Because the upstream batch read reports a missing post and
a failed read identically, an occasional transient upstream failure
surfaces here too, so retry once before concluding the post is gone.
The X-RateLimit-* headers on this endpoint report the ENRICHMENT
window, not the ordinary read window.
{ "data": { "post": { "id": "1938765432109876543", "url": "https://x.com/buildersam/status/1938765432109876543", "text": "I built my first product in 30 days with zero audience. Here is exactly what I would do differently:", "created_at": "2026-06-20T15:04:00.000Z", "author": { "x_user_id": "44196397", "username": "buildersam", "name": "Sam Fields", "avatar_url": "https://pbs.twimg.com/profile_images/1/avatar.jpg", "verified": true, "followers_count": 8421 }, "metrics": { "likes": 4211, "replies": 312, "reposts": 388, "quotes": 44, "views": 512000, "bookmarks": 1904 }, "in_reply_to_id": null } }}
{
"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": "post_not_found",
"message": "No public post with that id. It may be deleted, protected, or the id may be wrong. A live lookup that fails upstream can also report this."
}
}
{
"error": {
"code": "lookup_quota_exceeded",
"message": "Today's live X lookup allowance (300 lookups) is used up. It is shared with Ask SuperX in the app and resets at midnight UTC.",
"retry_after": 20400,
"limit": 300,
"reset_at": 1789430400
}
}
{"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":[],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/x-lookups/look-up-one-public-post-live","slug":"/api-reference/x-lookups/look-up-one-public-post-live","pageMetadata":{"title":"Look up one public post live","description":"Read one public X post as it is right now: full text (never\nshortened), author, engagement counts, media, link card, and the\nquoted post one level deep when there is one.\n\nOwner-scoped, so there is no `account_id`: nothing upstream is\nper-X-account. Costs ONE live-enrichment unit, TWO with\n`include_quotes`, and also draws on the shared allowance of 300 live\nlookups per UTC day that Ask SuperX in the app uses (see\n[Rate limits](/rate-limits#live-x-lookups)). Repeat lookups of the\nsame post within 15 minutes may be served from a server-side cache:\nthey still cost their enrichment units but do not touch the daily\nallowance.\n\n`404 post_not_found` means the post is deleted, protected, or the id\nis wrong. Because the upstream batch read reports a missing post and\na failed read identically, an occasional transient upstream failure\nsurfaces here too, so retry once before concluding the post is gone.\n\nThe `X-RateLimit-*` headers on this endpoint report the ENRICHMENT\nwindow, not the ordinary read window.\n","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","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 a: \"a\",\n code: \"code\",\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_Fragment, {\n children: [_jsx(_components.p, {\n children: \"Read one public X post as it is right now: full text (never\\nshortened), author, engagement counts, media, link card, and the\\nquoted post one level deep when there is one.\"\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"Owner-scoped, so there is no \", _jsx(_components.code, {\n children: \"account_id\"\n }), \": nothing upstream is\\nper-X-account. Costs ONE live-enrichment unit, TWO with\\n\", _jsx(_components.code, {\n children: \"include_quotes\"\n }), \", and also draws on the shared allowance of 300 live\\nlookups per UTC day that Ask SuperX in the app uses (see\\n\", _jsx(_components.a, {\n href: \"/rate-limits#live-x-lookups\",\n children: \"Rate limits\"\n }), \"). Repeat lookups of the\\nsame post within 15 minutes may be served from a server-side cache:\\nthey still cost their enrichment units but do not touch the daily\\nallowance.\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [_jsx(_components.code, {\n children: \"404 post_not_found\"\n }), \" means the post is deleted, protected, or the id\\nis wrong. Because the upstream batch read reports a missing post and\\na failed read identically, an occasional transient upstream failure\\nsurfaces here too, so retry once before concluding the post is gone.\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"The \", _jsx(_components.code, {\n children: \"X-RateLimit-*\"\n }), \" headers on this endpoint report the ENRICHMENT\\nwindow, not the ordinary read window.\"]\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":"Look up one public post live","description":"Read one public X post as it is right now: full text (never\nshortened), author, engagement counts, media, link card, and the\nquoted post one level deep when there is one.\n\nOwner-scoped, so there is no `account_id`: nothing upstream is\nper-X-account. Costs ONE live-enrichment unit, TWO with\n`include_quotes`, and also draws on the shared allowance of 300 live\nlookups per UTC day that Ask SuperX in the app uses (see\n[Rate limits](/rate-limits#live-x-lookups)). Repeat lookups of the\nsame post within 15 minutes may be served from a server-side cache:\nthey still cost their enrichment units but do not touch the daily\nallowance.\n\n`404 post_not_found` means the post is deleted, protected, or the id\nis wrong. Because the upstream batch read reports a missing post and\na failed read identically, an occasional transient upstream failure\nsurfaces here too, so retry once before concluding the post is gone.\n\nThe `X-RateLimit-*` headers on this endpoint report the ENRICHMENT\nwindow, not the ordinary read window.\n","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","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["X Lookups"],"operationId":"lookupXPost","summary":"Look up one public post live","description":"Read one public X post as it is right now: full text (never\nshortened), author, engagement counts, media, link card, and the\nquoted post one level deep when there is one.\n\nOwner-scoped, so there is no `account_id`: nothing upstream is\nper-X-account. Costs ONE live-enrichment unit, TWO with\n`include_quotes`, and also draws on the shared allowance of 300 live\nlookups per UTC day that Ask SuperX in the app uses (see\n[Rate limits](/rate-limits#live-x-lookups)). Repeat lookups of the\nsame post within 15 minutes may be served from a server-side cache:\nthey still cost their enrichment units but do not touch the daily\nallowance.\n\n`404 post_not_found` means the post is deleted, protected, or the id\nis wrong. Because the upstream batch read reports a missing post and\na failed read identically, an occasional transient upstream failure\nsurfaces here too, so retry once before concluding the post is gone.\n\nThe `X-RateLimit-*` headers on this endpoint report the ENRICHMENT\nwindow, not the ordinary read window.\n","parameters":["56028bc1-9d21-4163-aba9-a262a6ee94ee","d0e1869a-b823-47f4-8a3c-e17730675dea"],"responses":{"200":"ca4521ed-f11e-493d-980b-5442720bb3c9","400":"78537e97-9f25-43b0-bb4a-6c9f041f49ac","401":"37e72abb-7515-4e3f-9d30-01f237cd147b","403":"8993551e-1d27-44c3-9e24-033156b93bc4","404":"2fcf208b-0a50-4aeb-b1f5-393286d6211c","429":"045af3e5-c002-4713-91d2-6154564cd09e","500":"eac8d06e-5c65-4bc2-b0af-2b22e23156c4","502":"1c44eb67-60f1-42dc-b96b-2aa018f489b0","503":"2db38564-e249-43bc-8742-e87e09fa9f1c"},"method":"get","type":"path","servers":["3d538a38-214d-4480-97a3-9a44d5c3102b"],"security":["d3f7d345-7007-489f-b114-dac4df3cb92f"],"path":"/v1/x/posts/{id}","baseUrlOptions":["https://api.superx.so"],"title":"Look up one public post live","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"56028bc1-9d21-4163-aba9-a262a6ee94ee":{"name":"id","in":"path","required":true,"description":"Numeric X post id (the digits at the end of a post URL).","schema":{"type":"string","pattern":"^[0-9]{1,25}$","isRequired":true,"description":"Numeric X post id (the digits at the end of a post URL).","uniqueKey":"","typeLabel":"string"}},"d0e1869a-b823-47f4-8a3c-e17730675dea":{"name":"include_quotes","in":"query","description":"Also return a page of the posts quoting this one (up to 20, not\nexhaustive). Costs a second enrichment unit.\n","schema":{"type":"boolean","default":false,"description":"Also return a page of the posts quoting this one (up to 20, not\nexhaustive). Costs a second enrichment unit.\n","uniqueKey":"","typeLabel":"boolean"}}},"responses":{"ca4521ed-f11e-493d-980b-5442720bb3c9":{"description":"The post.","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":"object","properties":{"post":{"type":"object","description":"One public X post read live. Text is never shortened. Optional keys\n(`is_pinned`, `is_repost`, `entities`, `media`, `card`, `quoted_post`)\nare present only when the post has them.\n","properties":{"id":{"type":"string","description":"Numeric X post id, as a string.","uniqueKey":"data.post.id","typeLabel":"string"},"url":{"type":"string","uniqueKey":"data.post.url","typeLabel":"string"},"text":{"type":"string","description":"The full post text.","uniqueKey":"data.post.text","typeLabel":"string"},"created_at":{"oneOf":[{"type":"string","format":"date-time","uniqueKey":"data.post.created_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","uniqueKey":"data.post.created_at.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.post.created_at","typeLabel":"string\u003cdate-time> | null"},"author":{"oneOf":[{"type":"object","properties":{"x_user_id":{"type":"string","uniqueKey":"data.post.author.oneOf.0.x_user_id","typeLabel":"string"},"username":{"oneOf":[{"type":"string","uniqueKey":"data.post.author.oneOf.0.username.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"data.post.author.oneOf.0.username.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.post.author.oneOf.0.username","typeLabel":"string | null"},"name":{"oneOf":[{"type":"string","uniqueKey":"data.post.author.oneOf.0.name.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"data.post.author.oneOf.0.name.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.post.author.oneOf.0.name","typeLabel":"string | null"},"avatar_url":{"oneOf":[{"type":"string","uniqueKey":"data.post.author.oneOf.0.avatar_url.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"data.post.author.oneOf.0.avatar_url.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.post.author.oneOf.0.avatar_url","typeLabel":"string | null"},"verified":{"oneOf":[{"type":"boolean","description":"Null when the upstream payload for that read does not carry\nit (single-post lookups and their quoted posts).\n","uniqueKey":"data.post.author.oneOf.0.verified.oneOf.0","typeLabel":"boolean"},{"type":"null","description":"Null when the upstream payload for that read does not carry\nit (single-post lookups and their quoted posts).\n","uniqueKey":"data.post.author.oneOf.0.verified.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.post.author.oneOf.0.verified","typeLabel":"boolean | null"},"followers_count":{"oneOf":[{"type":"integer","uniqueKey":"data.post.author.oneOf.0.followers_count.oneOf.0","typeLabel":"integer"},{"type":"null","uniqueKey":"data.post.author.oneOf.0.followers_count.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.post.author.oneOf.0.followers_count","typeLabel":"integer | null"}},"uniqueKey":"data.post.author.oneOf.0","typeLabel":"object"},{"type":"null","properties":{"x_user_id":{"type":"string"},"username":{"oneOf":[{"type":"string"},{"type":"null"}]},"name":{"oneOf":[{"type":"string"},{"type":"null"}]},"avatar_url":{"oneOf":[{"type":"string"},{"type":"null"}]},"verified":{"oneOf":[{"type":"boolean","description":"Null when the upstream payload for that read does not carry\nit (single-post lookups and their quoted posts).\n"},{"type":"null","description":"Null when the upstream payload for that read does not carry\nit (single-post lookups and their quoted posts).\n"}]},"followers_count":{"oneOf":[{"type":"integer"},{"type":"null"}]}},"uniqueKey":"data.post.author.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.post.author","typeLabel":"object | null"},"metrics":{"type":"object","properties":{"likes":{"type":"integer","uniqueKey":"data.post.metrics.likes","typeLabel":"integer"},"replies":{"type":"integer","uniqueKey":"data.post.metrics.replies","typeLabel":"integer"},"reposts":{"type":"integer","uniqueKey":"data.post.metrics.reposts","typeLabel":"integer"},"quotes":{"type":"integer","uniqueKey":"data.post.metrics.quotes","typeLabel":"integer"},"views":{"oneOf":[{"type":"integer","uniqueKey":"data.post.metrics.views.oneOf.0","typeLabel":"integer"},{"type":"null","uniqueKey":"data.post.metrics.views.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.post.metrics.views","typeLabel":"integer | null"},"bookmarks":{"type":"integer","uniqueKey":"data.post.metrics.bookmarks","typeLabel":"integer"}},"uniqueKey":"data.post.metrics","typeLabel":"object"},"in_reply_to_id":{"oneOf":[{"type":"string","description":"Set when this post is a reply; the id of the post it answers.","uniqueKey":"data.post.in_reply_to_id.oneOf.0","typeLabel":"string"},{"type":"null","description":"Set when this post is a reply; the id of the post it answers.","uniqueKey":"data.post.in_reply_to_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.post.in_reply_to_id","typeLabel":"string | null"},"is_pinned":{"type":"boolean","description":"Present and true only on the account's pinned post (timeline reads).","uniqueKey":"data.post.is_pinned","typeLabel":"boolean"},"is_repost":{"type":"boolean","description":"Present and true only on a repost of someone else's post.","uniqueKey":"data.post.is_repost","typeLabel":"boolean"},"entities":{"type":"array","description":"t.co link mappings, so short links can be rendered as their real destination.","items":{"type":"object","properties":{"url":{"type":"string","uniqueKey":"data.post.entities.items.[INDEX].url","typeLabel":"string"},"display_url":{"oneOf":[{"type":"string","uniqueKey":"data.post.entities.items.[INDEX].display_url.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"data.post.entities.items.[INDEX].display_url.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.post.entities.items.[INDEX].display_url","typeLabel":"string | null"},"expanded_url":{"oneOf":[{"type":"string","uniqueKey":"data.post.entities.items.[INDEX].expanded_url.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"data.post.entities.items.[INDEX].expanded_url.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.post.entities.items.[INDEX].expanded_url","typeLabel":"string | null"}},"uniqueKey":"data.post.entities.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.post.entities","typeLabel":"object[]"},"media":{"type":"array","description":"Attached media. `video_url` is a playable MP4 for videos and GIFs.","items":{"type":"object","properties":{"type":{"type":"string","example":"photo","uniqueKey":"data.post.media.items.[INDEX].type","typeLabel":"string"},"url":{"oneOf":[{"type":"string","uniqueKey":"data.post.media.items.[INDEX].url.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"data.post.media.items.[INDEX].url.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.post.media.items.[INDEX].url","typeLabel":"string | null"},"video_url":{"oneOf":[{"type":"string","uniqueKey":"data.post.media.items.[INDEX].video_url.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"data.post.media.items.[INDEX].video_url.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.post.media.items.[INDEX].video_url","typeLabel":"string | null"},"width":{"type":"integer","uniqueKey":"data.post.media.items.[INDEX].width","typeLabel":"integer"},"height":{"type":"integer","uniqueKey":"data.post.media.items.[INDEX].height","typeLabel":"integer"}},"uniqueKey":"data.post.media.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.post.media","typeLabel":"object[]"},"card":{"type":"object","description":"Link preview card, when the post has one.","properties":{"url":{"oneOf":[{"type":"string","uniqueKey":"data.post.card.url.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"data.post.card.url.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.post.card.url","typeLabel":"string | null"},"title":{"type":"string","uniqueKey":"data.post.card.title","typeLabel":"string"},"description":{"oneOf":[{"type":"string","uniqueKey":"data.post.card.description.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"data.post.card.description.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.post.card.description","typeLabel":"string | null"},"domain":{"oneOf":[{"type":"string","uniqueKey":"data.post.card.domain.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"data.post.card.domain.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.post.card.domain","typeLabel":"string | null"},"image":{"oneOf":[{"type":"string","uniqueKey":"data.post.card.image.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"data.post.card.image.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.post.card.image","typeLabel":"string | null"}},"uniqueKey":"data.post.card","typeLabel":"object"},"quoted_post":{"oneOf":[{"description":"The post this one quotes, ONE level deep only - a quote of a\nquote is not nested further.\n","uniqueKey":"data.post.quoted_post.oneOf.0","typeLabel":"any"},{"type":"null","uniqueKey":"data.post.quoted_post.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.post.quoted_post","typeLabel":"any | null"}},"uniqueKey":"data.post","typeLabel":"object"},"quotes":{"type":"array","description":"Present only when `include_quotes` was set.","items":{"type":"object","description":"One public X post read live. Text is never shortened. Optional keys\n(`is_pinned`, `is_repost`, `entities`, `media`, `card`, `quoted_post`)\nare present only when the post has them.\n","properties":{"id":{"type":"string","description":"Numeric X post id, as a string.","uniqueKey":"data.quotes.items.[INDEX].id","typeLabel":"string"},"url":{"type":"string","uniqueKey":"data.quotes.items.[INDEX].url","typeLabel":"string"},"text":{"type":"string","description":"The full post text.","uniqueKey":"data.quotes.items.[INDEX].text","typeLabel":"string"},"created_at":{"oneOf":[{"type":"string","format":"date-time","uniqueKey":"data.quotes.items.[INDEX].created_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","uniqueKey":"data.quotes.items.[INDEX].created_at.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.quotes.items.[INDEX].created_at","typeLabel":"string\u003cdate-time> | null"},"author":{"oneOf":[{"type":"object","properties":{"x_user_id":{"type":"string","uniqueKey":"data.quotes.items.[INDEX].author.oneOf.0.x_user_id","typeLabel":"string"},"username":{"oneOf":[{"type":"string","uniqueKey":"data.quotes.items.[INDEX].author.oneOf.0.username.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"data.quotes.items.[INDEX].author.oneOf.0.username.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.quotes.items.[INDEX].author.oneOf.0.username","typeLabel":"string | null"},"name":{"oneOf":[{"type":"string","uniqueKey":"data.quotes.items.[INDEX].author.oneOf.0.name.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"data.quotes.items.[INDEX].author.oneOf.0.name.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.quotes.items.[INDEX].author.oneOf.0.name","typeLabel":"string | null"},"avatar_url":{"oneOf":[{"type":"string","uniqueKey":"data.quotes.items.[INDEX].author.oneOf.0.avatar_url.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"data.quotes.items.[INDEX].author.oneOf.0.avatar_url.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.quotes.items.[INDEX].author.oneOf.0.avatar_url","typeLabel":"string | null"},"verified":{"oneOf":[{"type":"boolean","description":"Null when the upstream payload for that read does not carry\nit (single-post lookups and their quoted posts).\n","uniqueKey":"data.quotes.items.[INDEX].author.oneOf.0.verified.oneOf.0","typeLabel":"boolean"},{"type":"null","description":"Null when the upstream payload for that read does not carry\nit (single-post lookups and their quoted posts).\n","uniqueKey":"data.quotes.items.[INDEX].author.oneOf.0.verified.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.quotes.items.[INDEX].author.oneOf.0.verified","typeLabel":"boolean | null"},"followers_count":{"oneOf":[{"type":"integer","uniqueKey":"data.quotes.items.[INDEX].author.oneOf.0.followers_count.oneOf.0","typeLabel":"integer"},{"type":"null","uniqueKey":"data.quotes.items.[INDEX].author.oneOf.0.followers_count.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.quotes.items.[INDEX].author.oneOf.0.followers_count","typeLabel":"integer | null"}},"uniqueKey":"data.quotes.items.[INDEX].author.oneOf.0","typeLabel":"object"},{"type":"null","properties":{"x_user_id":{"type":"string"},"username":{"oneOf":[{"type":"string"},{"type":"null"}]},"name":{"oneOf":[{"type":"string"},{"type":"null"}]},"avatar_url":{"oneOf":[{"type":"string"},{"type":"null"}]},"verified":{"oneOf":[{"type":"boolean","description":"Null when the upstream payload for that read does not carry\nit (single-post lookups and their quoted posts).\n"},{"type":"null","description":"Null when the upstream payload for that read does not carry\nit (single-post lookups and their quoted posts).\n"}]},"followers_count":{"oneOf":[{"type":"integer"},{"type":"null"}]}},"uniqueKey":"data.quotes.items.[INDEX].author.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.quotes.items.[INDEX].author","typeLabel":"object | null"},"metrics":{"type":"object","properties":{"likes":{"type":"integer","uniqueKey":"data.quotes.items.[INDEX].metrics.likes","typeLabel":"integer"},"replies":{"type":"integer","uniqueKey":"data.quotes.items.[INDEX].metrics.replies","typeLabel":"integer"},"reposts":{"type":"integer","uniqueKey":"data.quotes.items.[INDEX].metrics.reposts","typeLabel":"integer"},"quotes":{"type":"integer","uniqueKey":"data.quotes.items.[INDEX].metrics.quotes","typeLabel":"integer"},"views":{"oneOf":[{"type":"integer","uniqueKey":"data.quotes.items.[INDEX].metrics.views.oneOf.0","typeLabel":"integer"},{"type":"null","uniqueKey":"data.quotes.items.[INDEX].metrics.views.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.quotes.items.[INDEX].metrics.views","typeLabel":"integer | null"},"bookmarks":{"type":"integer","uniqueKey":"data.quotes.items.[INDEX].metrics.bookmarks","typeLabel":"integer"}},"uniqueKey":"data.quotes.items.[INDEX].metrics","typeLabel":"object"},"in_reply_to_id":{"oneOf":[{"type":"string","description":"Set when this post is a reply; the id of the post it answers.","uniqueKey":"data.quotes.items.[INDEX].in_reply_to_id.oneOf.0","typeLabel":"string"},{"type":"null","description":"Set when this post is a reply; the id of the post it answers.","uniqueKey":"data.quotes.items.[INDEX].in_reply_to_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.quotes.items.[INDEX].in_reply_to_id","typeLabel":"string | null"},"is_pinned":{"type":"boolean","description":"Present and true only on the account's pinned post (timeline reads).","uniqueKey":"data.quotes.items.[INDEX].is_pinned","typeLabel":"boolean"},"is_repost":{"type":"boolean","description":"Present and true only on a repost of someone else's post.","uniqueKey":"data.quotes.items.[INDEX].is_repost","typeLabel":"boolean"},"entities":{"type":"array","description":"t.co link mappings, so short links can be rendered as their real destination.","items":{"type":"object","properties":{"url":{"type":"string","uniqueKey":"data.quotes.items.[INDEX].entities.items.[INDEX].url","typeLabel":"string"},"display_url":{"oneOf":[{"type":"string","uniqueKey":"data.quotes.items.[INDEX].entities.items.[INDEX].display_url.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"data.quotes.items.[INDEX].entities.items.[INDEX].display_url.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.quotes.items.[INDEX].entities.items.[INDEX].display_url","typeLabel":"string | null"},"expanded_url":{"oneOf":[{"type":"string","uniqueKey":"data.quotes.items.[INDEX].entities.items.[INDEX].expanded_url.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"data.quotes.items.[INDEX].entities.items.[INDEX].expanded_url.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.quotes.items.[INDEX].entities.items.[INDEX].expanded_url","typeLabel":"string | null"}},"uniqueKey":"data.quotes.items.[INDEX].entities.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.quotes.items.[INDEX].entities","typeLabel":"object[]"},"media":{"type":"array","description":"Attached media. `video_url` is a playable MP4 for videos and GIFs.","items":{"type":"object","properties":{"type":{"type":"string","example":"photo","uniqueKey":"data.quotes.items.[INDEX].media.items.[INDEX].type","typeLabel":"string"},"url":{"oneOf":[{"type":"string","uniqueKey":"data.quotes.items.[INDEX].media.items.[INDEX].url.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"data.quotes.items.[INDEX].media.items.[INDEX].url.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.quotes.items.[INDEX].media.items.[INDEX].url","typeLabel":"string | null"},"video_url":{"oneOf":[{"type":"string","uniqueKey":"data.quotes.items.[INDEX].media.items.[INDEX].video_url.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"data.quotes.items.[INDEX].media.items.[INDEX].video_url.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.quotes.items.[INDEX].media.items.[INDEX].video_url","typeLabel":"string | null"},"width":{"type":"integer","uniqueKey":"data.quotes.items.[INDEX].media.items.[INDEX].width","typeLabel":"integer"},"height":{"type":"integer","uniqueKey":"data.quotes.items.[INDEX].media.items.[INDEX].height","typeLabel":"integer"}},"uniqueKey":"data.quotes.items.[INDEX].media.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.quotes.items.[INDEX].media","typeLabel":"object[]"},"card":{"type":"object","description":"Link preview card, when the post has one.","properties":{"url":{"oneOf":[{"type":"string","uniqueKey":"data.quotes.items.[INDEX].card.url.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"data.quotes.items.[INDEX].card.url.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.quotes.items.[INDEX].card.url","typeLabel":"string | null"},"title":{"type":"string","uniqueKey":"data.quotes.items.[INDEX].card.title","typeLabel":"string"},"description":{"oneOf":[{"type":"string","uniqueKey":"data.quotes.items.[INDEX].card.description.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"data.quotes.items.[INDEX].card.description.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.quotes.items.[INDEX].card.description","typeLabel":"string | null"},"domain":{"oneOf":[{"type":"string","uniqueKey":"data.quotes.items.[INDEX].card.domain.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"data.quotes.items.[INDEX].card.domain.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.quotes.items.[INDEX].card.domain","typeLabel":"string | null"},"image":{"oneOf":[{"type":"string","uniqueKey":"data.quotes.items.[INDEX].card.image.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"data.quotes.items.[INDEX].card.image.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.quotes.items.[INDEX].card.image","typeLabel":"string | null"}},"uniqueKey":"data.quotes.items.[INDEX].card","typeLabel":"object"},"quoted_post":{"oneOf":[{"description":"The post this one quotes, ONE level deep only - a quote of a\nquote is not nested further.\n","uniqueKey":"data.quotes.items.[INDEX].quoted_post.oneOf.0","typeLabel":"any"},{"type":"null","uniqueKey":"data.quotes.items.[INDEX].quoted_post.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.quotes.items.[INDEX].quoted_post","typeLabel":"any | null"}},"uniqueKey":"data.quotes.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.quotes","typeLabel":"object[]"},"quotes_note":{"type":"string","description":"What the `quotes` page covers, or why it is empty.\nPresent only when `include_quotes` was set.\n","uniqueKey":"data.quotes_note","typeLabel":"string"}},"uniqueKey":"data","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"example":{"data":{"post":{"id":"1938765432109876543","url":"https://x.com/buildersam/status/1938765432109876543","text":"I built my first product in 30 days with zero audience. Here is exactly what I would do differently:","created_at":"2026-06-20T15:04:00.000Z","author":{"x_user_id":"44196397","username":"buildersam","name":"Sam Fields","avatar_url":"https://pbs.twimg.com/profile_images/1/avatar.jpg","verified":true,"followers_count":8421},"metrics":{"likes":4211,"replies":312,"reposts":388,"quotes":44,"views":512000,"bookmarks":1904},"in_reply_to_id":null}}},"examples":{"Example":{"title":"Example","value":{"data":{"post":{"id":"1938765432109876543","url":"https://x.com/buildersam/status/1938765432109876543","text":"I built my first product in 30 days with zero audience. Here is exactly what I would do differently:","created_at":"2026-06-20T15:04:00.000Z","author":{"x_user_id":"44196397","username":"buildersam","name":"Sam Fields","avatar_url":"https://pbs.twimg.com/profile_images/1/avatar.jpg","verified":true,"followers_count":8421},"metrics":{"likes":4211,"replies":312,"reposts":388,"quotes":44,"views":512000,"bookmarks":1904},"in_reply_to_id":null}}}}},"exampleType":"examples"}},"exampleType":"examples"},"78537e97-9f25-43b0-bb4a-6c9f041f49ac":{"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"},"37e72abb-7515-4e3f-9d30-01f237cd147b":{"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"},"8993551e-1d27-44c3-9e24-033156b93bc4":{"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"},"2fcf208b-0a50-4aeb-b1f5-393286d6211c":{"description":"No public post with that id: it is deleted, protected, or the id is\nwrong. The upstream batch read reports a missing post and a failed\nread identically, so an occasional transient failure surfaces here\ntoo - retry once before concluding the post is gone.\n","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":"post_not_found","message":"No public post with that id. It may be deleted, protected, or the id may be wrong. A live lookup that fails upstream can also report this."}},"examples":{"Example":{"title":"Example","value":{"error":{"code":"post_not_found","message":"No public post with that id. It may be deleted, protected, or the id may be wrong. A live lookup that fails upstream can also report this."}}}},"exampleType":"examples"}},"exampleType":"examples"},"045af3e5-c002-4713-91d2-6154564cd09e":{"description":"A live-lookup 429. Either the plan's per-minute or per-day enrichment\nbucket is exhausted (`rate_limited`), or a daily live-lookup gate\nstopped the call (`lookup_quota_exceeded`). Read `error.code` to tell\nthose two apart; both carry `Retry-After`.\n\n`lookup_quota_exceeded` covers three cases and the body says which:\nyour own allowance is used up (`limit` is present, and that allowance\nis shared with Ask SuperX in the app, resetting at midnight UTC); the\nSuperX-wide allowance is used up (no `limit`, since it is not your\naccount's budget, still resetting at midnight); or the counter could\nnot be verified, in which case the call is refused rather than run\nunmetered (no `limit`, short `retry_after`). Always read\n`error.retry_after` rather than assuming midnight.\n","headers":{"Retry-After":{"description":"Seconds to wait before retrying.","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.","uniqueKey":"error.retry_after","typeLabel":"integer"},"limit":{"type":"integer","description":"Your daily live-lookup allowance. Present ONLY when\nit is your own allowance that ran out; absent for a\nSuperX-wide cap or an unverifiable counter.\n","uniqueKey":"error.limit","typeLabel":"integer"},"reset_at":{"type":"integer","description":"Unix seconds at the next UTC midnight. Present on\nthe two allowance cases, absent when the counter\ncould not be verified.\n","uniqueKey":"error.reset_at","typeLabel":"integer"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"example":{"error":{"code":"lookup_quota_exceeded","message":"Today's live X lookup allowance (300 lookups) is used up. It is shared with Ask SuperX in the app and resets at midnight UTC.","retry_after":20400,"limit":300,"reset_at":1789430400}},"examples":{"Example":{"title":"Example","value":{"error":{"code":"lookup_quota_exceeded","message":"Today's live X lookup allowance (300 lookups) is used up. It is shared with Ask SuperX in the app and resets at midnight UTC.","retry_after":20400,"limit":300,"reset_at":1789430400}}}},"exampleType":"examples"}},"exampleType":"examples"},"eac8d06e-5c65-4bc2-b0af-2b22e23156c4":{"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"},"1c44eb67-60f1-42dc-b96b-2aa018f489b0":{"description":"A dependent SuperX service returned an unexpected response.","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":"upstream_error","message":"Failed to fetch scheduled posts. Try again shortly."}},"examples":{"Example":{"title":"Example","value":{"error":{"code":"upstream_error","message":"Failed to fetch scheduled posts. Try again shortly."}}}},"exampleType":"examples"}},"exampleType":"examples"},"2db38564-e249-43bc-8742-e87e09fa9f1c":{"description":"The scheduling service is temporarily unreachable. Safe to retry; reuse your Idempotency-Key on POST.","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":"upstream_unavailable","message":"The scheduling service is temporarily unavailable. Retry with the same Idempotency-Key."}},"examples":{"Example":{"title":"Example","value":{"error":{"code":"upstream_unavailable","message":"The scheduling service is temporarily unavailable. Retry with the same Idempotency-Key."}}}},"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":"Look up one public post live - SuperX","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-07T18:31:25.779Z","originalFileLocation":"api-reference/x-lookups/look-up-one-public-post-live.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=\"Read one public X post as it is right now: full text (never shortened), author, engagement counts, media, link card, and the quoted post one level deep when there is one. Owner-scoped, so there is no account_id: nothing upstream is per-X-account. Costs ONE live-enrichment unit, TWO with include_quotes, and also draws on the shared allowance of 300 live lookups per UTC day that Ask SuperX in the app uses (see Rate limits). Repeat lookups of the same post within 15 minutes may be served from a server-side cache: they still cost their enrichment units but do not touch the daily allowance. 404 post_not_found means the post is deleted, protected, or the id is wrong. Because the upstream batch read reports a missing post and a failed read identically, an occasional transient upstream failure surfaces here too, so retry once before concluding the post is gone. The X-RateLimit-* headers on this endpoint report the ENRICHMENT window, not the ordinary read window.\">\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=\"Look up one public post live - SuperX\">\u003cmeta data-mint-head property=\"og:description\" content=\"Read one public X post as it is right now: full text (never shortened), author, engagement counts, media, link card, and the quoted post one level deep when there is one. Owner-scoped, so there is no account_id: nothing upstream is per-X-account. Costs ONE live-enrichment unit, TWO with include_quotes, and also draws on the shared allowance of 300 live lookups per UTC day that Ask SuperX in the app uses (see Rate limits). Repeat lookups of the same post within 15 minutes may be served from a server-side cache: they still cost their enrichment units but do not touch the daily allowance. 404 post_not_found means the post is deleted, protected, or the id is wrong. Because the upstream batch read reports a missing post and a failed read identically, an occasional transient upstream failure surfaces here too, so retry once before concluding the post is gone. The X-RateLimit-* headers on this endpoint report the ENRICHMENT window, not the ordinary read window.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"SuperX\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.superx.so/api-reference/x-lookups/look-up-one-public-post-live\">\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=X+Lookups\u0026amp;title=Look+up+one+public+post+live\u0026amp;description=Read+one+public+X+post+as+it+is+right+now%3A+full+text+%28never%0Ashortened%29%2C+author%2C+engagement+counts%2C+media%2C+link+card%2C+and+the%0Aquoted+post+one+level+deep+when+the\u0026amp;theme=4e9a0bdaa172d4dfc537fe9f\u0026amp;signature=8502a3326a2d654deafacbc146959e697cddaacd3785e36ecb31e6938b1fdb5f\">\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=\"Look up one public post live - SuperX\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Read one public X post as it is right now: full text (never shortened), author, engagement counts, media, link card, and the quoted post one level deep when there is one. Owner-scoped, so there is no account_id: nothing upstream is per-X-account. Costs ONE live-enrichment unit, TWO with include_quotes, and also draws on the shared allowance of 300 live lookups per UTC day that Ask SuperX in the app uses (see Rate limits). Repeat lookups of the same post within 15 minutes may be served from a server-side cache: they still cost their enrichment units but do not touch the daily allowance. 404 post_not_found means the post is deleted, protected, or the id is wrong. Because the upstream batch read reports a missing post and a failed read identically, an occasional transient upstream failure surfaces here too, so retry once before concluding the post is gone. The X-RateLimit-* headers on this endpoint report the ENRICHMENT window, not the ordinary read window.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://superx.mintlify.app/_mintlify/api/og/v2?division=X+Lookups\u0026amp;title=Look+up+one+public+post+live\u0026amp;description=Read+one+public+X+post+as+it+is+right+now%3A+full+text+%28never%0Ashortened%29%2C+author%2C+engagement+counts%2C+media%2C+link+card%2C+and+the%0Aquoted+post+one+level+deep+when+the\u0026amp;theme=4e9a0bdaa172d4dfc537fe9f\u0026amp;signature=8502a3326a2d654deafacbc146959e697cddaacd3785e36ecb31e6938b1fdb5f\">\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/x-lookups/look-up-one-public-post-live\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/x-lookups/look-up-one-public-post-live.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/x-lookups/look-up-one-public-post-live#webpage\",\"url\":\"https://docs.superx.so/api-reference/x-lookups/look-up-one-public-post-live\",\"name\":\"Look up one public post live\",\"description\":\"Read one public X post as it is right now: full text (never shortened), author, engagement counts, media, link card, and the quoted post one level deep when there is one. Owner-scoped, so there is no account_id: nothing upstream is per-X-account. Costs ONE live-enrichment unit, TWO with include_quotes, and also draws on the shared allowance of 300 live lookups per UTC day that Ask SuperX in the app uses (see Rate limits). Repeat lookups of the same post within 15 minutes may be served from a server-side cache: they still cost their enrichment units but do not touch the daily allowance. 404 post_not_found means the post is deleted, protected, or the id is wrong. Because the upstream batch read reports a missing post and a failed read identically, an occasional transient upstream failure surfaces here too, so retry once before concluding the post is gone. The X-RateLimit-* headers on this endpoint report the ENRICHMENT window, not the ordinary read window.\",\"dateModified\":\"2026-10-07T18:31:25.779Z\",\"isPartOf\":{\"@id\":\"https://docs.superx.so#website\"},\"breadcrumb\":{\"@id\":\"https://docs.superx.so/api-reference/x-lookups/look-up-one-public-post-live#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.superx.so/api-reference/x-lookups/look-up-one-public-post-live#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"SuperX\",\"item\":\"https://docs.superx.so\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Look up one public post live\",\"item\":\"https://docs.superx.so/api-reference/x-lookups/look-up-one-public-post-live\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.superx.so/api-reference/x-lookups/look-up-one-public-post-live#apireference\",\"headline\":\"Look up one public post live\",\"name\":\"Look up one public post live\",\"description\":\"Read one public X post as it is right now: full text (never shortened), author, engagement counts, media, link card, and the quoted post one level deep when there is one. Owner-scoped, so there is no account_id: nothing upstream is per-X-account. Costs ONE live-enrichment unit, TWO with include_quotes, and also draws on the shared allowance of 300 live lookups per UTC day that Ask SuperX in the app uses (see Rate limits). Repeat lookups of the same post within 15 minutes may be served from a server-side cache: they still cost their enrichment units but do not touch the daily allowance. 404 post_not_found means the post is deleted, protected, or the id is wrong. Because the upstream batch read reports a missing post and a failed read identically, an occasional transient upstream failure surfaces here too, so retry once before concluding the post is gone. The X-RateLimit-* headers on this endpoint report the ENRICHMENT window, not the ordinary read window.\",\"url\":\"https://docs.superx.so/api-reference/x-lookups/look-up-one-public-post-live\",\"mainEntityOfPage\":{\"@id\":\"https://docs.superx.so/api-reference/x-lookups/look-up-one-public-post-live#webpage\"},\"dateModified\":\"2026-10-07T18:31:25.779Z\",\"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","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","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","description":"Judges each row's own text against a natural-language `criterion` and\nkeeps or drops it, then optionally sorts and caps what is left into a\nNEW dataset. The source dataset is never modified.\n\nOnly datasets whose rows carry text can be refined this way (a\nrepliers or quoters collection). Anything else answers `400`: use the\nprofile filters on `POST /v1/datasets` instead.\n\nRows the classifier cannot judge confidently are **kept** and counted\nas `unclear`, never silently dropped. Classification is best-effort:\nread the kept rows before acting on them.\n\n**This endpoint can answer before the work is finished.** Up to 100\nrows with text classify inside the request and answer `200`; more than\nthat answers `202` with a `collecting` dataset to poll through\n`GET /v1/datasets/{id}`. If nothing was kept, the answer is `200` with\n`data: null` and a `note`.\n\n**Cost.** A refinement creates a dataset, so it counts against the\nsame 10 collections a day this account shares with Ask SuperX\n(`429 collection_quota_exceeded`), and it costs AI credits, measured\nfrom the classifier's real cost. It spends no live-data allowance.\nNeeds a key with the `write` scope.\n","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","description":"The best-liked DIRECT replies to a public post, read live from X.\n\nThis walks up to 3 relevance-ranked upstream pages (about 60\ncandidate replies), ranks what it found by likes and returns the top\n`limit`. It is a SAMPLE of the strongest replies, not every reply and\nnot chronological order, and it cannot page further. To collect\neveryone who replied to a post, use the audience collections built in\nthe SuperX app (`GET /v1/datasets`).\n\nUnlike the same feature inside the SuperX app, replies written by the\naccount owner themselves are NOT filtered out: an owner-scoped read\nhas no \"active account\" to compare against.\n\nCosts a flat THREE live-enrichment units and draws on the shared\n300/day live-lookup allowance (one unit of that per page actually\nfetched). `data.post` is the post being replied to when the upstream\npayload carried it, and null otherwise; it is never a second lookup.\n\nThe `X-RateLimit-*` headers on this endpoint report the ENRICHMENT\nwindow, not the ordinary read window.\n","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":"Look up one public post live - 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"]}