GET https://xquik.com/api/v1/x/tweets/{id}/embed
Embed tweet returns the HTML that shows one public tweet on a website.
The endpoint is GET /api/v1/x/tweets/{id}/embed.
GET /x/tweets/{id}/embed when a page, CMS, or newsletter tool shows a tweet.
The HTML is the markup X gives websites for that tweet.
Each call costs 1 credit. A refused request costs nothing.
Place the embed on a page
Insertembed.html where the tweet belongs.
The markup holds the tweet text and a script tag that loads X’s widget.
The widget then draws the full tweet card in the reader’s browser.
Send omitScript=true when a page shows several tweets.
Load X’s widget script once on that page instead.
Store embed.html with the tweet ID and the options you sent.
A stored embed saves a second call for the same tweet and look.Path parameters
Query parameters
Choose fields
Headers
Response
200 OK
400 Invalid input
{ "error": "invalid_input", "message": "Send theme as light or dark, and hideMedia, hideThread & omitScript as true or false." }
An option has a value the endpoint does not take. Fix the option and send the request again.400 Invalid tweet ID
{ "error": "invalid_tweet_id" }
The provided tweet ID is empty or not a valid format.401 Unauthenticated
Missing or invalid API key. Check thex-api-key header value.402 Payment required
Account keys get account options. Guest keys get guest top-up only. Anonymous calls receive a direct MPPWWW-Authenticate: Payment challenge plus a guest wallet creation action.
No checkout starts automatically. Confirm any payment action.404 Tweet not found
X has no embed for the tweet. The author may have deleted it, or the account is private.502 X API unavailable
The read service returned an error. Retry after a short delay.503 Service busy
X returned no embed, or Xquik is busy. Retry after a short delay. The request costs nothing.429 Rate limit exceeded
You exceeded your tier rate limit. Wait for theRetry-After header before retrying.424 Dependency failed
The normalized v1 response contract can return 424 when the read service is unavailable.Tweet embed API questions
How do I embed a tweet on a website with an API?
CallGET /x/tweets/{id}/embed with the tweet ID or URL.
Insert embed.html into your page where the tweet belongs.How do I get a dark theme tweet embed?
Sendtheme=dark. The returned markup then asks X’s widget for the dark card.How do I embed many tweets on one page?
SendomitScript=true for each tweet.
Load X’s widget script once on the page.How much does a tweet embed cost?
Each call costs 1 credit. A refused or failed request costs nothing.Does this replace X’s official API?
No. This page documents Xquik, an independent third-party service. It does not document X’s official API.Next steps. Get tweet reads the tweet’s fields as JSON. Download media saves its photos and videos.
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." } - 402
{ "error": "insufficient_credits", "message": "Insufficient credits. Top up or subscribe to continue." } - 403
{ "error": "api_key_paused", "message": "This API key is paused. Resume it at dashboard.xquik.com/api-keys to use it again." } - 404
{ "error": "tweet_not_found", "message": "Tweet not found. Check the tweet ID." } - 424
{ "error": "x_api_unavailable", "message": "X data source temporarily unavailable. Try again later." } - 429
{ "error": "rate_limit_exceeded", "message": "Too many requests. Try again later.", "retryAfter": 60 } - 502
{ "error": "x_api_unavailable", "message": "X data source temporarily unavailable. Try again later." } - 503
{ "error": "x_api_unavailable", "message": "Xquik is busy right now. Retry shortly." }