List X authored posts
Reads a synchronous, cursor-paginated page of posts authored by one connected X account. Filtering happens after the upstream scan, so returned_count can be lower than scanned_count. The existing x_credits_billing_v1 flag controls customer accounting only.
Authorization
AuthorizationBearer <token>In header
Workspace API key.
Idempotency-KeystringRequired header
Unique key for this exact page request. Reuse it only when retrying identical parameters.
Path Params
account_idstring
Connected X account ID.
Query Params
external_user_idstringRequired
Managed User that owns the connected account.
limitintegerRequired
Upstream resources to scan. Must be between 5 and 100; UniPost never silently reduces it.
cursorstring
Opaque cursor returned by the preceding request. Cursors are scoped to the account, Managed User, time range, and filters.
start_timestring
Optional inclusive RFC 3339 lower bound.
end_timestring
Optional exclusive RFC 3339 upper bound. Must be after start_time.
exclude_repostsboolean
Exclude reposts after UniPost scans the upstream page.
exclude_replies_to_othersboolean
Exclude replies to other users while retaining self-replies.
Response Body
200
data[]array
Normalized posts authored by the connected X account, deduplicated by external_post_id.
data[].account_idstring
UniPost connected-account ID.
data[].external_post_idstring
Stable X post ID and the deduplication key.
data[].textstring
Post text returned by X.
data[].created_atstring
RFC 3339 publication time.
data[].content_typestring
original_post, reply, quote, or repost, with repost > reply > quote precedence.
data[].is_replyboolean
Whether the post is a reply.
data[].is_self_replyboolean
Whether the reply targets the same connected author.
data[].is_repostboolean
Whether the post is a repost.
data[].is_quoteboolean
Whether the post quotes another post.
data[].thread.thread_idstring
X conversation ID used as the thread_id. Thread position is not exposed because X does not return a reliable authored-timeline position.
data[].mediaarray
Normalized media types: image, video, or gif.
data[].public_metricsobject
Likes, replies, reposts, quotes, and impressions.
meta.limitinteger
Requested upstream scan limit.
meta.scanned_countinteger
Resources inspected upstream and used for final Credits charging.
meta.returned_countinteger
Posts remaining after validation, deduplication, and filters.
meta.has_moreboolean
Whether another upstream page is available.
meta.next_cursorstring
Opaque next-page cursor when has_more is true.
meta.cursor_expires_atstring
RFC 3339 cursor expiry, normally seven days after issuance.
meta.creditsobject
Estimate, reservation, charge, release, operation, catalog version, and accounting mode.
400
error.codestring
Stable machine-readable error code.
error.messagestring
Human-readable error message.
error.detailsobject
May include estimated_credits, available_credits, and max_affordable_limit.
error.details.retry_cursorstring
Refreshed opaque cursor when a retriable delay would outlive the submitted cursor. Retry the same logical page with the same Idempotency-Key.
error.details.retry_cursor_expires_atstring
RFC 3339 expiry for retry_cursor.
request_idstring
Request identifier for support.
401
error.codestring
Stable machine-readable error code.
error.messagestring
Human-readable error message.
error.detailsobject
May include estimated_credits, available_credits, and max_affordable_limit.
error.details.retry_cursorstring
Refreshed opaque cursor when a retriable delay would outlive the submitted cursor. Retry the same logical page with the same Idempotency-Key.
error.details.retry_cursor_expires_atstring
RFC 3339 expiry for retry_cursor.
request_idstring
Request identifier for support.
402
error.codestring
Stable machine-readable error code.
error.messagestring
Human-readable error message.
error.detailsobject
May include estimated_credits, available_credits, and max_affordable_limit.
error.details.retry_cursorstring
Refreshed opaque cursor when a retriable delay would outlive the submitted cursor. Retry the same logical page with the same Idempotency-Key.
error.details.retry_cursor_expires_atstring
RFC 3339 expiry for retry_cursor.
request_idstring
Request identifier for support.
403
error.codestring
Stable machine-readable error code.
error.messagestring
Human-readable error message.
error.detailsobject
May include estimated_credits, available_credits, and max_affordable_limit.
error.details.retry_cursorstring
Refreshed opaque cursor when a retriable delay would outlive the submitted cursor. Retry the same logical page with the same Idempotency-Key.
error.details.retry_cursor_expires_atstring
RFC 3339 expiry for retry_cursor.
request_idstring
Request identifier for support.
404
error.codestring
Stable machine-readable error code.
error.messagestring
Human-readable error message.
error.detailsobject
May include estimated_credits, available_credits, and max_affordable_limit.
error.details.retry_cursorstring
Refreshed opaque cursor when a retriable delay would outlive the submitted cursor. Retry the same logical page with the same Idempotency-Key.
error.details.retry_cursor_expires_atstring
RFC 3339 expiry for retry_cursor.
request_idstring
Request identifier for support.
409
error.codestring
Stable machine-readable error code.
error.messagestring
Human-readable error message.
error.detailsobject
May include estimated_credits, available_credits, and max_affordable_limit.
error.details.retry_cursorstring
Refreshed opaque cursor when a retriable delay would outlive the submitted cursor. Retry the same logical page with the same Idempotency-Key.
error.details.retry_cursor_expires_atstring
RFC 3339 expiry for retry_cursor.
request_idstring
Request identifier for support.
422
error.codestring
Stable machine-readable error code.
error.messagestring
Human-readable error message.
error.detailsobject
May include estimated_credits, available_credits, and max_affordable_limit.
error.details.retry_cursorstring
Refreshed opaque cursor when a retriable delay would outlive the submitted cursor. Retry the same logical page with the same Idempotency-Key.
error.details.retry_cursor_expires_atstring
RFC 3339 expiry for retry_cursor.
request_idstring
Request identifier for support.
429
error.codestring
Stable machine-readable error code.
error.messagestring
Human-readable error message.
error.detailsobject
May include estimated_credits, available_credits, and max_affordable_limit.
error.details.retry_cursorstring
Refreshed opaque cursor when a retriable delay would outlive the submitted cursor. Retry the same logical page with the same Idempotency-Key.
error.details.retry_cursor_expires_atstring
RFC 3339 expiry for retry_cursor.
request_idstring
Request identifier for support.
502
error.codestring
Stable machine-readable error code.
error.messagestring
Human-readable error message.
error.detailsobject
May include estimated_credits, available_credits, and max_affordable_limit.
error.details.retry_cursorstring
Refreshed opaque cursor when a retriable delay would outlive the submitted cursor. Retry the same logical page with the same Idempotency-Key.
error.details.retry_cursor_expires_atstring
RFC 3339 expiry for retry_cursor.
request_idstring
Request identifier for support.