Drafts
List Xquik Tweet Drafts with Cursor-Based Pagination
List Xquik tweet drafts with exact text, optional topic and goal, timestamps, stable cursor pagination, authentication, and clear 401 or 429 recovery.
- 200
- 401
- 429
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 onedrafts 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 maximumlimit are both 50.
A smaller value helps clients process short review batches.
Follow this cursor workflow:
- Request the first page without
afterCursor. - Process every draft in the returned order.
- Check
hasMoreafter processing the page. - Copy
nextCursorwhenhasMoreistrue. - Send that value as the next
afterCursor. - Stop when
hasMorebecomesfalse.
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 fortopic 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.- List the newest Xquik tweet drafts.
- Store each returned draft ID once.
- Review its text, topic, goal, and timestamps.
- Retrieve one draft again before final approval.
- Publish approved text through a separate X write route.
- Delete obsolete drafts after required review.
- Continue until
hasMoreisfalse.
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?
CallGET /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. UsenextCursor 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
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
429 Rate Limited
Retry-After before retrying.
Related: Create Draft to save tweet text, Get Draft to retrieve one record, or Delete Draft to remove it.
- 200
- 401
- 429
List Xquik Tweet Drafts with Cursor-Based Pagination