Analyze & cache style

POST

styles

curl --request POST \
  --url https://xquik.com/api/v1/styles \
  --header 'Content-Type: <content-type>' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "username": "<string>"
}
'

import requests

url = "https://xquik.com/api/v1/styles"

payload = { "username": "<string>" }
headers = {
    "x-api-key": "<api-key>",
    "Content-Type": "<content-type>"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'x-api-key': '<api-key>', 'Content-Type': '<content-type>'},
  body: JSON.stringify({username: '<string>'})
};

fetch('https://xquik.com/api/v1/styles', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://xquik.com/api/v1/styles"

	payload := strings.NewReader("{\n  \"username\": \"<string>\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("x-api-key", "<api-key>")
	req.Header.Add("Content-Type", "<content-type>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

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

const response = await fetch("https://xquik.com/api/v1/styles", {
  method: "POST",
  headers: {
    "x-api-key": "xq_YOUR_KEY_HERE",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    username: "elonmusk",
  }),
});
const data = await response.json();

import requests

response = requests.post(
    "https://xquik.com/api/v1/styles",
    headers={"x-api-key": "xq_YOUR_KEY_HERE"},
    json={"username": "elonmusk"},
)
data = response.json()

package main

import (
    "bytes"
    "encoding/json"
    "fmt"
    "net/http"
)

func main() {
    body, _ := json.Marshal(map[string]interface{}{
        "username": "elonmusk",
    })

    req, err := http.NewRequest("POST", "https://xquik.com/api/v1/styles", bytes.NewReader(body))
    if err != nil {
        panic(err)
    }
    req.Header.Set("x-api-key", "xq_YOUR_KEY_HERE")
    req.Header.Set("Content-Type", "application/json")

    resp, err := http.DefaultClient.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    var data map[string]interface{}
    if err := json.NewDecoder(resp.Body).Decode(&data); err != nil {
        panic(err)
    }
    fmt.Println(data)
}

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.

Last modified on May 5, 2026

List stylesRetrieve all cached tweet style profiles for your account

Analyze & cache style

curl --request POST \
  --url https://xquik.com/api/v1/styles \
  --header 'Content-Type: <content-type>' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "username": "<string>"
}
'

import requests

url = "https://xquik.com/api/v1/styles"

payload = { "username": "<string>" }
headers = {
    "x-api-key": "<api-key>",
    "Content-Type": "<content-type>"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'x-api-key': '<api-key>', 'Content-Type': '<content-type>'},
  body: JSON.stringify({username: '<string>'})
};

fetch('https://xquik.com/api/v1/styles', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://xquik.com/api/v1/styles"

	payload := strings.NewReader("{\n  \"username\": \"<string>\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("x-api-key", "<api-key>")
	req.Header.Add("Content-Type", "<content-type>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

​Headers

​Body

​Response

Headers

Body

Response