{ "error": "invalid_tweet_id", "message": "Tweet ID is empty or invalid" }
The provided tweet ID or URL could not be resolved to a valid tweet ID.
{ "error": "too_many_tweets", "message": "Max 50 tweets per request" }
The tweetIds array exceeds the 50-item limit. Split into multiple requests.
{ "error": "no_media", "message": "Tweet has no downloadable media" }
The tweet does not contain any images, videos, or GIFs.
{ "error": "unauthenticated", "message": "Missing or invalid API key" }
Missing or invalid API key / session cookie.
{ "error": "no_subscription", "message": "No active subscription" }
An active subscription is required. Subscribe from the dashboard.
For MPP requests without a valid payment credential, 402 returns a WWW-Authenticate: Payment challenge header instead.
{ "error": "x_api_unavailable" }
The X data source returned an error. Retry after a short delay.
First download is metered and counts toward your monthly credit allowance. Subsequent requests for the same tweet return cached URLs at no cost (cacheHit: true). All downloads are saved to your gallery at https://xquik.com/gallery.
This endpoint supports dual authentication: API key (x-api-key header) or session cookie from the dashboard.Related:Get Tweet to look up tweet details and metrics, or use the xquikMCP tool for AI agent access.
