Analyze performance

1 credit per tweet · All plans from $0.00012/credit

curl -X GET https://xquik.com/api/v1/styles/elonmusk/performance \
  -H "x-api-key: xq_YOUR_KEY_HERE" | jq

Path parameters

string

required

Style profile ID or X username whose cached tweets to analyze. Must have been cached with Analyze & Cache Style first.

Headers

x-api-key

string

required

Your API key. Session cookie authentication is also supported. Generate a key from the dashboard.

Response

200 OK
401 Unauthenticated
402 Subscription Required
404 Not Found
429 Rate Limited

xUsername

string

Normalized X username (lowercase, no @ prefix).

tweetCount

number

Number of tweets with engagement data.

tweets

object[]

Array of tweets with engagement metrics.

Show tweet object

string

Tweet ID.

text

string

Tweet text content.

bookmarkCount

number

Number of bookmarks.

likeCount

number

Number of likes.

quoteCount

number

Number of quote tweets.

replyCount

number

Number of replies.

retweetCount

number

Number of retweets.

viewCount

number

Number of views.

{
  "xUsername": "elonmusk",
  "tweetCount": 20,
  "tweets": [
    {
      "id": "1893456789012345678",
      "text": "The future is now.",
      "bookmarkCount": 2340,
      "likeCount": 15420,
      "quoteCount": 1280,
      "replyCount": 890,
      "retweetCount": 3210,
      "viewCount": 1250000
    }
  ]
}

{ "error": "unauthenticated", "message": "Missing or invalid API key" }

Missing or invalid API key.

Possible error codes:

no_subscription - No active subscription
subscription_inactive - Subscription is inactive or cancelled
insufficient_credits - Insufficient credits

{ "error": "no_subscription", "message": "No active subscription" }

Subscribe from the dashboard.

{ "error": "style_not_found", "message": "No cached style found for this username" }

No cached style exists for this username. Use Analyze & Cache Style to fetch and cache tweets first.

{ "error": "rate_limit_exceeded", "message": "Too many requests. Try again later.", "retryAfter": 1 }

Too many requests. Wait for the Retry-After header before retrying.

Engagement metrics are fetched live from X at request time. Results may vary between calls as tweets gain interactions.

Related: Analyze & Cache Style to cache tweets before fetching metrics, Get Style to view the cached tweet text, or Compare Styles to compare two accounts.

Documentation Index

​Path parameters

​Headers

​Response

Path parameters

Headers

Response