GET https://xquik.com/api/v1/drafts
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 (Twitter) compose interface.Free. This endpoint 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 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 does not
change while clients follow returned cursors.
The list contains Xquik draft records only. It excludes published tweets,
scheduled posts, native X drafts, and another account’s drafts.
Each draft contains one saved text string. It contains no thread order, media
attachment, reply target, or public tweet ID.Paginate through every draft
Request up to 10,000 drafts per page. The defaultlimit is 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 for a smaller review set.
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
The API omits optional fields that you did not supply 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 other clients create or delete drafts.
Use Get Draft before you delete drafts. 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. Keep the last successful cursor before retrying a page.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 10,000 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
Headers
Response
200 OK
400 Invalid cursor
{ "error": "invalid_input", "message": "Cursor invalid. Use nextCursor from the previous page, or omit it to start over." }
The afterCursor value is not a nextCursor from this route. Send the last
nextCursor received, or omit afterCursor to start from the first page.401 Unauthenticated
Authentication is missing or invalid. Replace the credential before retrying.429 Rate limited
{ "error": "rate_limit_exceeded", "message": "Too many requests. Try again later.", "retryAfter": 1 }
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.
- Delete Draft to remove it.
Response examples
- 400
{ "error": "invalid_input", "message": "Invalid input. Check the request body." } - 401
{ "error": "unauthenticated", "message": "Authentication required. Provide a valid API key or bearer token." } - 403
{ "error": "api_key_paused", "message": "This API key is paused. Resume it at dashboard.xquik.com/api-keys to use it again." } - 429
{ "error": "rate_limit_exceeded", "message": "Too many requests. Try again later.", "retryAfter": 60 }