POST https://xquik.com/api/v1/x/analysis/viral-score
2 credits per analyzed post · All plans from $0.00012/credit · Supports guest paid reads
0 to 100. The endpoint
is POST /api/v1/x/analysis/viral-score.
The score rates the wording. It does not predict likes or views.
A giveaway, contest, scam, joke, or hype post scores
informative 0.
Score drafts before you post
Send your drafts intexts. Xquik reads nothing from X for them. Each draft
costs the same as 1 analyzed post. Drafts come back with the IDs text:1,
text:2, and so on.
Rewrite a draft with a low hook or clarity first. Those 2 traits carry half
of the score.Read the Viral Score
Hook, clarity, payoff, and the expected reaction raise the score. Payoff is the higher ofinformative and funny. Wording that reads like generic machine
copy lowers it.Hard stops cap the score of likely spam, ragebait, and generic machine copy.
viral.stops lists the stops that applied, such as spam. viral.weights
names the version of these rules, such as viral_lite:1.
viralScore is null when a trait has no answer. Xquik never fills a missing
score with a guess.Compare with real engagement
viralAlgorithmScore applies X’s published ranking weights to public counts of
posts read from X. A like weighs 0.5, a reply 5, a repost 1, and a quote 5.
It divides the sum by views and multiplies by 1,000. A post without a view count
uses followers. viral.algorithmBasis names the divisor.
The AI never sees these counts. It reads the text and its context only. The
estimate is not X’s score, since X uses signals outside public data.
viralActualEngagementRate is log10(1 + weighted engagement per 1,000 followers). analysisSummary.viral.calibration compares it with the Viral
Score across the posts.Score an account’s posts
Sendusername to score an account’s recent posts. analysisSummary.viral
then holds a report per author in accounts and a leaderboard.Pick the posts to analyze
SendtweetIds, texts, a page, or a search, never more than 1. See pick the posts to analyze for each source.Compare with an earlier answer
Send theresults of an earlier call as baseline to see what changed. The comparison costs nothing extra. See compare with an earlier answer for an example.Budget the analysis
Each analyzed post costs 2 credits. Each text intexts costs the same. Posts in unanalyzed cost nothing. See budget the analysis for each reason.Body
See body parameters for every field. Common ones aretweetIds, texts, query, username, and limit.Headers
Response
200 OK
400 Invalid input
{ "error": "invalid_input", "message": "Send 1 or more texts in texts, each with words in it." }
The body names no posts or names more than 1 source. A body with an invalid field gets the same error.
The message says what to send instead. The request costs nothing.401 Unauthenticated
Anonymous requests getWWW-Authenticate: Bearer and a guest wallet checkout action. This is not a Payment challenge.
Missing or invalid API key. Check the x-api-key header value.402 Payment required
Full account keys can receiveno_subscription, subscription_inactive, no_credits, or insufficient_credits with account payment options. Guest keys receive only the guest top-up action.
The failed request creates no checkout. Ask the user to confirm before calling any checkout or top-up route.403 Protected account
{ "error": "x_account_protected" }
A search that needs a protected author returns this. Choose a public account.
The request costs nothing.502 X API unavailable
The read service returned an error. Retry after a short delay.503 Service busy
Xquik is busy. Wait for theRetry-After header, then send the request again.
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 viral score API questions
How do I check if a tweet will go viral?
Send the draft intexts. viralScore rates its wording from 0 to 100.
viralVerdict says whether to post it, edit it, or wait.Does the score predict likes or views?
No. It rates the wording only. Timing, followers, and X’s ranking decide the reach.viralAlgorithmScore shows how a posted tweet actually performed.Why did my draft score low?
Readanswers. A low hook or clarity costs the most points. viral.stops
names any hard stop, such as spam or ragebait, that capped the score.Can I score someone else’s posts?
Yes. Send their handle inusername, post IDs in tweetIds, or a search in
query.How much does the viral score cost?
Each analyzed post or draft costs 2 credits. Posts inunanalyzed and refused
requests cost 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. Classify posts asks your own questions, or Sentiment analysis reads the attitude of posts.
Response examples
- 400
{ "error": "invalid_input", "message": "Invalid input. Check the request body." } - 401
{ "error": "unauthenticated", "message": "Authentication required." } - 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." } - 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." }