Skip to main content
POST
/
styles
Analyze & cache style
curl --request POST \
  --url https://api.example.com/styles \
  --header 'Content-Type: <content-type>' \
  --header 'x-api-key: <x-api-key>' \
  --data '
{
  "username": "<string>"
}
'
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.
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.