Analyze & cache style

Free - does not consume credits

This endpoint uses a two-tier system. If a cached style exists and is less than 7 days old, it returns cached data for free. If no cache exists or the cache is older than 7 days, it auto-refreshes from X (subscription required, consumes usage).

curl -X POST https://xquik.com/api/v1/styles \
  -H "x-api-key: xq_YOUR_KEY_HERE" \
  -H "Content-Type: application/json" \
  -d '{
    "username": "elonmusk"
  }' | jq

Headers

x-api-key

string

required

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

Content-Type

string

required

Must be application/json.

Body

username

string

required

X username to analyze. 1-15 characters, alphanumeric and underscores only.

Response

Returns cached style data when a fresh cache exists (less than 7 days old). Same response shape as 201 Created.

xUsername

string

Normalized X username (lowercase, no @ prefix).

tweetCount

number

Number of tweets fetched and cached.

isOwnAccount

boolean

true if the user has set their X identity to this account.

fetchedAt

string

ISO 8601 timestamp when tweets were fetched from X.

tweets

object[]

Array of cached tweets.

xUsername

string

Normalized X username (lowercase, no @ prefix).

tweetCount

number

Number of tweets fetched and cached.

isOwnAccount

boolean

true if the user has set their X identity to this account.

fetchedAt

string

ISO 8601 timestamp when tweets were fetched from X.

tweets

object[]

Array of cached tweets.

Each tweet object contains:

id (string) - Tweet ID
text (string) - Tweet text content
authorUsername (string) - Author’s X username
createdAt (string) - ISO 8601 timestamp
media (object[], optional) - Media objects attached to the tweet

{
  "xUsername": "elonmusk",
  "tweetCount": 20,
  "isOwnAccount": false,
  "fetchedAt": "2026-02-24T10:30:00.000Z",
  "tweets": [
    {
      "id": "1893456789012345678",
      "text": "The future is now.",
      "authorUsername": "elonmusk",
      "createdAt": "2026-02-24T14:22:00.000Z"
    }
  ]
}

{ "error": "invalid_input", "message": "Invalid or missing username" }

Invalid or missing username. Provide a valid X username.

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

Missing or invalid API key.

Possible error codes:

no_subscription - No active subscription
no_cached_style - No cached style available and subscription required to fetch new data
subscription_inactive - Subscription is inactive or cancelled
insufficient_credits - Insufficient credits

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

Subscribe from the dashboard.

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

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

If a cached style exists but your subscription has lapsed, the cached data is returned with a 200 response instead of a 402 error.

If a cached style already exists for this username, it will be replaced with fresh data.

Next steps: List Styles to see all cached styles, Get Style to retrieve a specific style, or Analyze Performance to fetch engagement metrics for cached tweets.

Documentation Index

​Headers

​Body

​Response

Headers

Body

Response