Tweet Writing Style API for Cached X Profile Samples

{
  "xUsername": "elonmusk",
  "tweetCount": 50,
  "isOwnAccount": true,
  "fetchedAt": "2025-01-15T12:00:00Z",
  "tweets": [
    {
      "id": "1234567890",
      "text": "Just launched our new feature!"
    }
  ]
}

{
  "xUsername": "elonmusk",
  "tweetCount": 50,
  "isOwnAccount": true,
  "fetchedAt": "2025-01-15T12:00:00Z",
  "tweets": [
    {
      "id": "1234567890",
      "text": "Just launched our new feature!"
    }
  ]
}

{
  "error": "invalid_input",
  "message": "Invalid input. Check the request body."
}

{
  "error": "unauthenticated",
  "message": "Authentication required. Provide a valid API key or bearer token."
}

{
  "error": "insufficient_credits",
  "message": "Insufficient credits. Top up or subscribe to continue."
}

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

POST

styles

Tweet Writing Style API for Cached X Profile Samples

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))

}

{
  "xUsername": "<string>",
  "tweetCount": 123,
  "isOwnAccount": true,
  "fetchedAt": "<string>",
  "tweets": [
    {
      "id": "<string>",
      "text": "<string>",
      "authorUsername": "<string>",
      "createdAt": "<string>"
    }
  ]
}

Cached response: free · Refresh: 1 credit per tweet returned

Build a Reusable Tweet Writing Profile

Send one X username to cache recent tweet writing samples. Xquik searches posts from that username and stores each returned Tweet ID, text, author, and time. This route manages cache creation and refreshes. It does not generate a tone label, vocabulary summary, sentence score, or engagement analysis. Use the returned samples for your approved writing review. Use Analyze Performance for current likes, replies, reposts, quotes, bookmarks, and views.

curl -X POST https://xquik.com/api/v1/styles \
  -H "x-api-key: xq_YOUR_KEY_HERE" \
  -H "Content-Type: application/json" \
  -d '{
    "username": "xquik"
  }' | 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: "xquik" }),
});

const result = await response.json();
if (!response.ok) {
  throw new Error(`${result.error}: ${result.message}`);
}
const cacheWasRefreshed = response.status === 201;

import requests

response = requests.post(
    "https://xquik.com/api/v1/styles",
    headers={"x-api-key": "xq_YOUR_KEY_HERE"},
    json={"username": "xquik"},
    timeout=30,
)
response.raise_for_status()
result = response.json()
cache_was_refreshed = response.status_code == 201

package main

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

func main() {
    body, err := json.Marshal(map[string]string{"username": "xquik"})
    if err != nil {
        panic(err)
    }

    req, err := http.NewRequest(
        http.MethodPost,
        "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 result map[string]interface{}
    if err := json.NewDecoder(resp.Body).Decode(&result); err != nil {
        panic(err)
    }
    if resp.StatusCode != http.StatusOK && resp.StatusCode != http.StatusCreated {
        panic(fmt.Sprintf("style request failed: %v", result))
    }
    cacheWasRefreshed := resp.StatusCode == http.StatusCreated
    fmt.Println(cacheWasRefreshed)
}

Understand Cached and Refreshed Responses

The HTTP status explains the cache action. Always inspect fetchedAt too.

Status	Cache condition	X request	Credit result
`200`	Profile is under 7 days old	No	Free cached response
`200`	Profile is older, but refresh cannot be funded	No	Existing stale cache returned
`201`	Profile is missing or older and refresh is funded	Yes	1 credit per returned Tweet
`402`	No cache exists and refresh cannot be funded	No	`no_cached_style` returned

A 200 response does not guarantee a recent refresh. Compare fetchedAt with your freshness policy before using the samples. The route has no force parameter. Repeating POST while the profile is fresh returns the same cache without another X request.

Send a Normalized X Username

Send a non-empty X username without @, spaces, or a profile URL. Xquik lowercases the value before lookup and storage.

{
  "username": "xquik"
}

The request body accepts one field only:

Field	Type	Required	Rule
`username`	string	Yes	Send the X handle without `@`.

Missing, empty, or non-string values return 400 invalid_input. Preserve the returned xUsername value for Get, Compare, Delete, and Performance requests.

Read the Cached Tweet Writing Samples

The profile response contains exact cached examples. It does not contain derived writing conclusions.

Profile field	Meaning	Integration use
`xUsername`	Lowercase analyzed X username	Use as the profile key.
`tweetCount`	Number of cached Tweet samples	Record the sample size and refresh cost.
`isOwnAccount`	Ownership classification stored during refresh	Separate owned and external profiles.
`fetchedAt`	ISO 8601 fetch time	Apply your cache freshness policy.
`tweets`	Cached tweet writing samples	Review the source text directly.

isOwnAccount compares the username with the saved X identity during a refresh. A cached 200 response does not recompute that flag.

Parse Every Cached Tweet

Each public tweets[] entry contains these fields:

Tweet field	Required	Meaning
`id`	Yes	Exact Tweet ID as a string
`text`	Yes	Cached tweet text
`authorUsername`	No	Tweet author’s X username
`createdAt`	No	ISO 8601 publication time

Keep Tweet IDs as strings. JavaScript numbers cannot safely represent every X Tweet ID. The public Style Profile contract does not include cached media objects. Use a Tweet or media endpoint when your workflow requires images, videos, or GIFs.

{
  "xUsername": "xquik",
  "tweetCount": 2,
  "isOwnAccount": true,
  "fetchedAt": "2026-08-02T12:00:00.000Z",
  "tweets": [
    {
      "id": "1950882898740914261",
      "text": "Export tweet replies to JSON or CSV.",
      "authorUsername": "xquik",
      "createdAt": "2026-08-02T11:30:00.000Z"
    }
  ]
}

Review Observable Tweet Writing Features

The response provides source text for your analysis. Start with observable features before assigning subjective voice or tone labels.

Writing feature	Sample calculation	Review question
Post length	Median `text.length`	Does the profile prefer short tweets?
Questions	Samples containing `?`	How often does the profile invite replies?
Links	Samples containing an HTTP URL	How often does it cite another page?
Hashtags	Count `#` tokens	Does it label topics explicitly?
Openings	Compare first sentences	Which hooks recur?
Vocabulary	Count repeated meaningful words	Which specific terms define the sample?
Cadence	Compare available `createdAt` values	How closely were samples published?

Do not infer future engagement from writing samples. Refresh public metrics through Analyze Performance when outcome comparisons are required.

Build a Safe Twitter Brand Voice Workflow

Set the X identity before refreshing.
Send one public X username to this endpoint.
Branch on HTTP 200 or 201.
Store xUsername, fetchedAt, and tweetCount.
Preserve every Tweet ID and text value.
Review observable patterns with a human editor.
Keep current product claims out of copied historical tweets.

Use cached examples as references. Never copy another person’s distinctive phrasing without authorization.

Analyze Another Public X Account

You can cache recent public tweets from another username. The resulting profile belongs only to the authenticated Xquik account. This route does not expose drafts, private posts, private analytics, followers, following, profile visits, or direct messages.

Budget a Style Refresh

Cached 200 responses are free. A 201 refresh costs 1 credit per Tweet returned and stored. Use tweetCount to reconcile the refresh. The endpoint does not accept a limit parameter, date range, pagination cursor, or requested sample count. When a stale cache exists without enough available credits, Xquik returns that cache with 200. It does not delete the existing writing samples.

Handle Style Cache Errors

Status	Error	Meaning	Recovery
`200`	None	Cached profile returned	Inspect `fetchedAt` before use.
`201`	None	Profile fetched and stored	Record `tweetCount` for billing.
`400`	`invalid_input`	Username is missing, empty, or not a string	Send one username string.
`401`	`unauthenticated`	Credential is missing or invalid	Replace the API key or bearer token.
`402`	`no_cached_style`	No cache exists and refresh cannot be funded	Top up or save approved examples.
`429`	`rate_limit_exceeded`	Request exceeded the rate limit	Wait for `Retry-After`, then retry once.

The response widget includes every status in the canonical OpenAPI contract.

Headers

Send x-api-key with an Xquik API key. OAuth clients can send a bearer token through the Authorization header instead.

string

required

Your Xquik API key. Generate one from the dashboard.

string

required

Must be application/json.

Body

string

required

Non-empty X username without @. Xquik lowercases the value.

Response

200 OK

Returns a cached profile. It can be fresh or an unfunded stale fallback.

201 Created

Returns a newly fetched and stored profile.

string

Lowercase analyzed X username.

number

Number of cached Tweet samples.

boolean

Stored ownership classification.

string

ISO 8601 cache fetch timestamp.

object[]

Cached tweet writing samples.

Show Tweet sample fields

string

Exact Tweet ID.

string

Cached tweet text.

string

Optional author username.

string

Optional ISO 8601 publication time.

400 Invalid Input

{ "error": "invalid_input", "message": "Invalid input. Check the request body." }

Username is missing, empty, or not a string. Send one username string.

401 Unauthenticated

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

Authentication failed. Replace the missing or invalid credential.

402 No Cached Style

{ "error": "no_cached_style", "message": "No cached style for @username. Share 5-10 example tweet texts, then save via PUT /api/v1/styles/username." }

No cache exists and the refresh cannot be funded. Top up through the billing page, or save approved tweet examples with Save Custom Style.

429 Rate Limited

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

Too many requests. Wait for Retry-After, then retry once.

How Do I Analyze a Twitter Writing Style?

Cache one public username, then review the returned tweet text. This endpoint supplies writing samples. Your application performs any voice or tone analysis.

Does Analyze Style Return Tone or Vocabulary Scores?

No. It returns Tweet IDs, text, authors, timestamps, and cache metadata. It does not return generated style labels or scores.

Why Did Analyze Style Return 200 Instead of 201?

The route reused an existing cache. Check fetchedAt. A 200 can also be a stale fallback when refresh funding is unavailable.

Can I Force a Twitter Style Refresh?

No force parameter exists. Fresh profiles return from cache. Delete and recreate a profile only when that destructive workflow is appropriate.

Can I Analyze Another Twitter Account?

Yes, for recent public tweets. The cached profile remains isolated to your authenticated Xquik account.

Next: Get Style reads samples without a refresh. Compare Styles retrieves 2 profiles.

{
  "xUsername": "elonmusk",
  "tweetCount": 50,
  "isOwnAccount": true,
  "fetchedAt": "2025-01-15T12:00:00Z",
  "tweets": [
    {
      "id": "1234567890",
      "text": "Just launched our new feature!"
    }
  ]
}

{
  "xUsername": "elonmusk",
  "tweetCount": 50,
  "isOwnAccount": true,
  "fetchedAt": "2025-01-15T12:00:00Z",
  "tweets": [
    {
      "id": "1234567890",
      "text": "Just launched our new feature!"
    }
  ]
}

{
  "error": "invalid_input",
  "message": "Invalid input. Check the request body."
}

{
  "error": "unauthenticated",
  "message": "Authentication required. Provide a valid API key or bearer token."
}

{
  "error": "insufficient_credits",
  "message": "Insufficient credits. Top up or subscribe to continue."
}

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

Tweet Writing Style API for Cached X Profile Samples

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))

}

{
  "xUsername": "<string>",
  "tweetCount": 123,
  "isOwnAccount": true,
  "fetchedAt": "<string>",
  "tweets": [
    {
      "id": "<string>",
      "text": "<string>",
      "authorUsername": "<string>",
      "createdAt": "<string>"
    }
  ]
}

​Build a Reusable Tweet Writing Profile

​Understand Cached and Refreshed Responses

​Send a Normalized X Username

​Read the Cached Tweet Writing Samples

​Parse Every Cached Tweet

​Review Observable Tweet Writing Features

​Build a Safe Twitter Brand Voice Workflow

​Analyze Another Public X Account

​Budget a Style Refresh

​Handle Style Cache Errors

​Headers

​Body

​Response

​200 OK

​201 Created

​400 Invalid Input

​401 Unauthenticated

​402 No Cached Style

​429 Rate Limited

​How Do I Analyze a Twitter Writing Style?

​Does Analyze Style Return Tone or Vocabulary Scores?

​Why Did Analyze Style Return 200 Instead of 201?

​Can I Force a Twitter Style Refresh?

​Can I Analyze Another Twitter Account?

Build a Reusable Tweet Writing Profile

Understand Cached and Refreshed Responses

Send a Normalized X Username

Read the Cached Tweet Writing Samples

Parse Every Cached Tweet

Review Observable Tweet Writing Features

Build a Safe Twitter Brand Voice Workflow

Analyze Another Public X Account

Budget a Style Refresh

Handle Style Cache Errors

Headers

Body

Response

200 OK

201 Created

400 Invalid Input

401 Unauthenticated

402 No Cached Style

429 Rate Limited

How Do I Analyze a Twitter Writing Style?

Does Analyze Style Return Tone or Vocabulary Scores?

Why Did Analyze Style Return 200 Instead of 201?

Can I Force a Twitter Style Refresh?

Can I Analyze Another Twitter Account?