Skip to main content
GET
Get cached tweet style samples with the Xquik API
Free - does not consume credits

Retrieve one cached tweet writing profile

Call this endpoint to retrieve stored tweet samples for one writing profile. The request reads Xquik’s existing cache. It does not contact X or refresh tweets. Use an analyzed X username or a saved custom label as {id}. Xquik lowercases the path value before lookup. The route does not accept a numeric database ID. The lookup stays inside the authenticated Xquik account. Another customer can cache the same username without exposing their tweet style profile to you.

Choose the correct tweet style key

The {id} name comes from the shared API path contract. The GET handler uses it as a profile key, not a numeric record ID. Encode spaces and punctuation in custom labels. Do not include @ before an X username. Preserve the response’s xUsername value for later requests.

Read the cached tweet style response

The response contains stored tweet text and profile metadata. It does not return a generated tone summary, vocabulary list, hook score, or sentiment classification. tweetCount describes the cached writing sample. It is not the X profile’s lifetime post count. fetchedAt has two meanings. An analyzed profile records its last X fetch. A custom profile records when Xquik saved its supplied tweet examples. isOwnAccount is a stored snapshot. This GET request does not recompute it after an X identity change. Set the X identity before creating or refreshing an analyzed profile.

Parse every tweet writing sample

Each tweets[] entry follows the public style profile contract: Treat id as a string. X Tweet IDs can exceed JavaScript’s safe integer range. Do not cast them to number. Custom profiles generate local sample IDs. Do not use those IDs with X tweet lookup, reply, like, repost, or media endpoints.

Separate tweet style from Twitter analytics

This route retrieves writing samples. It does not fetch likes, replies, reposts, quotes, bookmarks, views, followers, or impressions. Use Analyze Performance when you need live engagement metrics for the cached tweets. Keep writing-style review separate from Twitter analytics for another account.

Review a saved tweet style

  1. Call List Styles with the same credential.
  2. Select one returned xUsername profile key.
  3. URL-encode that value and call this endpoint.
  4. Store xUsername, fetchedAt, and tweetCount with the samples.
  5. Review every tweets[].text value before composition.
  6. Refresh the profile through Analyze only when required.
Use cached samples as writing references. Never assume each sample is a current product claim, approved fact, or reusable announcement.

Handle tweet style retrieval errors

The canonical contract documents no 402 response for this cache read. A missing balance does not block retrieval of an existing style profile.

Path parameters

string
required
Lowercase X username or saved custom style label. Xquik lowercases this value before an account-scoped lookup. It is not a numeric database ID.

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.

Response

200 OK

string
Lowercase X username or custom style label.
number
Number of stored tweet writing samples.
boolean
Stored ownership classification for this profile.
string
ISO 8601 cache fetch or custom-save timestamp.
object[]
Stored tweet writing samples.

401 Unauthenticated

Authentication failed. Replace the missing or invalid credential.

404 Style not found

No matching cache key exists for this Xquik account. Call List Styles first. Analyze the X username when no profile exists.

429 Rate limited

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

How do I retrieve a cached tweet writing style?

List styles, copy one xUsername, then send it as {id}. This endpoint returns the saved tweet text without refreshing the X profile.

Can I retrieve another account’s Twitter writing style?

Yes, after your Xquik account analyzes that public username. You cannot read a style profile cached by another Xquik customer.

Does get style return Twitter analytics?

No. It returns tweet writing samples and cache metadata. Use Analyze Performance for current likes, replies, reposts, and views.

Why does get style return 404?

The credential cannot access a matching lowercase username or label. Call List Styles, check the exact key, then analyze or save the profile.
Related. List Styles inventories profile keys. Delete Style removes a cached profile.