---
title: "Get generated X (Twitter) posts for the authenticated user"
method: GET
path: "/x/posts"
tags: ["X"]
---

# Get generated X (Twitter) posts for the authenticated user

`GET /x/posts`

Returns the list of generated X posts and threads, including visualization image URLs when available. Supports optional pagination.

## Query parameters

- `page` integer
- `limit` integer

## Response `200`

Successfully retrieved X posts

- union
  - object — Non-paginated response (when page and limit are not provided)
    - `posts` object[]
      - `id` string — Unique ID of the post (use this for refinement)
      - `requestId` string — The request ID that generated this post
      - `result` string — The generated content or metadata
      - `type` string — The post type (e.g., tweet or thread item)
      - `order` integer — Order in the thread (starts at 0)
      - `createdOn` string, date-time — When the post was created
      - `tweetImageUrl` string, nullable — Main image for the tweet (from user upload or provided URL)
      - `dataTableImageUrl` string, nullable — Optional URL to a generated data table image
      - `barChartImageUrl` string, nullable — Optional URL to a generated bar chart image
      - `sources` XPostSource[] — Provenance entries describing where the content came from
        - `type` string — Classification of the source (e.g. feed, resource, deep-research)
        - `sourceId` string, nullable — Optional identifier for the source record
        - `reference` string, nullable — User-friendly reference like a URL or handle
        - `description` string, nullable — Short summary of the source content
        - `metadata` object, nullable — Arbitrary metadata captured for the source
      - `shareUrl` string — Share URL for the post (only in getPodcasts response)
  - object — Paginated response (when page or limit are provided)
    - `posts` object[]
      - `id` string — Unique ID of the post (use this for refinement)
      - `requestId` string — The request ID that generated this post
      - `result` string — The generated content or metadata
      - `type` string — The post type (e.g., tweet or thread item)
      - `order` integer — Order in the thread (starts at 0)
      - `createdOn` string, date-time — When the post was created
      - `tweetImageUrl` string, nullable — Main image for the tweet (from user upload or provided URL)
      - `dataTableImageUrl` string, nullable — Optional URL to a generated data table image
      - `barChartImageUrl` string, nullable — Optional URL to a generated bar chart image
      - `sources` XPostSource[] — Provenance entries describing where the content came from
        - `type` string — Classification of the source (e.g. feed, resource, deep-research)
        - `sourceId` string, nullable — Optional identifier for the source record
        - `reference` string, nullable — User-friendly reference like a URL or handle
        - `description` string, nullable — Short summary of the source content
        - `metadata` object, nullable — Arbitrary metadata captured for the source
      - `shareUrl` string — Share URL for the post (only in getPodcasts response)
    - `totalCount` integer — Total number of posts
    - `page` integer — Current page number
    - `pageSize` integer — Number of items per page
    - `totalPages` integer — Total number of pages

## Other responses

- `401` — Unauthorized - invalid or missing token
- `500` — Internal server error

---

[API](https://skmtc.net/autocontentapi/apis/content-api.md) · [All operations](https://skmtc.net/autocontentapi/apis/content-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/autocontentapi/content-api/revisions/355890b6b4cc/schema)