Skip to main content
GET
List Xquik Tweet Drafts with Cursor-Based Pagination

List Saved Tweet Drafts

List tweet drafts stored in your authenticated Xquik account. Each result contains saved text, an optional topic, an optional goal, and timestamps. Use this route to build a draft inventory or review queue. It returns drafts newest first and supports cursor pagination. The route never publishes draft text or sends it to followers. Xquik drafts are separate from X’s native Unsent posts. This API cannot list drafts saved inside the X compose interface.
Free - does not consume credits

Understand the Tweet Draft List

The response contains one drafts array and pagination fields. An empty array is a successful result. It means the account currently has no saved drafts. Drafts use descending creation order. A newer createdAt value appears first. The draft ID breaks ties between equal creation times. This order stays predictable while clients follow returned cursors. The list contains Xquik draft records only. It excludes published tweets, scheduled posts, native X drafts, and drafts owned by another account. Each draft contains one saved text string. The canonical draft object contains no thread order, media attachment, reply target, or public tweet ID.

Paginate Through Every Draft

Request up to 50 drafts per page. The default and maximum limit are both 50. A smaller value helps clients process short review batches. Follow this cursor workflow:
  1. Request the first page without afterCursor.
  2. Process every draft in the returned order.
  3. Check hasMore after processing the page.
  4. Copy nextCursor when hasMore is true.
  5. Send that value as the next afterCursor.
  6. Stop when hasMore becomes false.
Treat nextCursor as an opaque value. Never decode, edit, or construct it. Keep only the latest cursor after a page succeeds. The final page omits nextCursor. Do not expect an empty string or null. Use hasMore as the loop condition. This route exposes no topic, goal, text, date, or status filter. Filter the returned draft objects inside your client when a smaller review set is needed. Do not paginate with timestamps or guessed draft IDs. Those values cannot replace the returned cursor. A cursor from another account also cannot select that account’s drafts.

Read the Draft Inventory Fields

Optional fields are omitted when they were not supplied during draft creation. Check for topic and goal before reading them. The text field can contain up to 25,000 characters. The optional topic field can contain up to 500 characters. A goal can be engagement, followers, authority, or conversation.

Build a Tweet Draft Review Queue

Use list pagination before retrieval, publishing, or cleanup.
  1. List the newest Xquik tweet drafts.
  2. Store each returned draft ID once.
  3. Review its text, topic, goal, and timestamps.
  4. Retrieve one draft again before final approval.
  5. Publish approved text through a separate X write route.
  6. Delete obsolete drafts after required review.
  7. Continue until hasMore is false.
Listing a draft does not reserve, approve, publish, or delete it. Your client must record those workflow states separately. The list response provides no draft count across every page. Count processed IDs locally when an inventory total matters. Deduplicate by id during long runs where drafts can be created or deleted concurrently. Use Get Draft before destructive cleanup. Use Create Tweet only after content approval.

Keep Native X Drafts Separate

Native X drafts appear under Unsent posts inside the compose interface. Native thread drafts may contain several connected posts. Native drafts may also contain photos, GIFs, or video. An Xquik draft stores one text value and optional composition context. It does not mirror the native X draft collection. Do not send a public tweet ID as afterCursor. Public tweet IDs and draft cursors identify different resources.

Recover From Draft List Errors

An empty drafts array is not a 404. It is a valid 200 response. Never retry 401 without replacing the credential. Retry 429 only after the server’s delay. Preserve the last successful cursor before retrying a page.

Answer Tweet Draft List Questions

How Can I List My Saved Tweet Drafts?

Call GET /drafts with an API key or OAuth bearer token. The response lists drafts owned by that authenticated Xquik account.

Does This API List Native Twitter or X Drafts?

No. Native drafts remain under Unsent posts. This route lists records created through the Xquik draft API.

How Many Tweet Drafts Can One Page Return?

One page returns at most 50 drafts. Use nextCursor when hasMore is true.

Can I Search Draft Text or Filter by Topic?

No server-side search or filter parameter exists. Paginate, then filter fields inside your client.

Does One Draft Include a Thread or Media?

No. One result contains a text string and optional composition context. It contains no thread sequence, media collection, or reply target.

Are Deleted Drafts Included?

No. Deleted drafts are absent. Xquik provides no deleted-draft restore route.

Does Listing Tweet Drafts Consume Credits?

No. This authenticated list request is free and consumes no Xquik credits.

Query Parameters

number
Results per page. Default 50, maximum 50.
string
Opaque cursor from nextCursor. Pass it unchanged to fetch the next page.

Headers

string
Your Xquik API key. Generate one from the dashboard.
string
An OAuth bearer token formatted as Bearer YOUR_TOKEN. Send this header or x-api-key, not both.

Response

200 OK

object[]
Draft objects ordered by creation time, newest first.
string
Unique Xquik draft ID.
string
Exact saved tweet text.
string
Optional draft topic. Omitted when unset.
string
Optional composition goal. Omitted when unset.
string
ISO 8601 creation timestamp.
string
ISO 8601 update timestamp.
boolean
Whether another page exists.
string
Opaque next-page cursor. Present only when hasMore is true.

401 Unauthenticated

Authentication is missing or invalid. Replace the credential before retrying.

429 Rate Limited

Too many requests reached the route. Wait for Retry-After before retrying.
Related: Create Draft to save tweet text, Get Draft to retrieve one record, or Delete Draft to remove it.