Skip to main content
GET
Compare 2 Cached Tweet Writing Profiles with Xquik
Free - does not consume credits

Retrieve 2 Cached Tweet Writing Profiles

Call this endpoint to retrieve 2 cached writing profiles together. Supply 2 X usernames, 2 custom labels, or one of each. Xquik performs 2 account-scoped cache lookups. It does not contact X, refresh tweets, or calculate a writing-style score. The response preserves request order. style1 matches username1. style2 matches username2.

Select Comparable Tweet Style Keys

Both query values use the same keys as Get Style. Xquik lowercases each value before lookup. The query parameter names say username. They also accept saved custom labels. Do not send numeric database IDs. Use 2 different keys for a meaningful comparison. The API accepts the same key twice, but both response objects will contain the same profile.

Understand What Compare Styles Returns

This endpoint groups 2 stored sample sets into one response. It does not generate conclusions about voice, tone, vocabulary, readability, or sentiment. The 2 profiles can have different sample counts. They can also have different cache timestamps. Compare equivalent subsets when those differences matter.

Inspect Every Tweet Writing Sample

Both style1.tweets[] and style2.tweets[] use this public contract: Keep Tweet IDs as strings. JavaScript numbers cannot safely represent every X Tweet ID. Do not send generated custom-sample IDs to X tweet endpoints. They identify local writing examples only.

Compare Tweet Writing Without Inventing Signals

Voice describes a consistent brand personality. Tone can change with context. This API returns the source text needed for your own review. Use observable text features before assigning subjective labels: Review examples in context. A small or stale cache cannot prove a permanent brand voice. Avoid copying personal phrases without authorization.

Separate Writing Style from Twitter Analytics

Compare Styles returns no likes, replies, reposts, quotes, bookmarks, views, followers, or impressions. It cannot prove which writing style performs better. Use Analyze Performance for current tweet engagement. Compare equivalent periods and sample sizes before drawing an outcome conclusion.

Build a Reliable Tweet Style Comparison

  1. List cached profiles with the same Xquik credential.
  2. Select 2 returned profile keys.
  3. Review fetchedAt and tweetCount for both profiles.
  4. Refresh stale X profiles through Analyze when required.
  5. Call Compare Styles with both URL-encoded keys.
  6. Compare equivalent tweet subsets using observable features.
  7. Preserve both source keys with any derived conclusion.
The endpoint does not modify either cache. Repeating the same request returns the current stored profiles until another route changes them.

Handle Tweet Style Comparison Errors

A 404 response does not identify which key failed. Call Get Style for each key when you need to isolate the missing profile. The canonical contract documents no 402 response. Existing cache comparison does not require credits.

Query Parameters

string
required
First X username or saved custom style label. Xquik lowercases this value and returns its profile as style1.
string
required
Second X username or saved custom style label. Xquik lowercases this value and returns its profile as style2.

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

object
First cached profile.
string
Lowercase X username or custom label.
number
Stored tweet writing sample count.
boolean
Stored ownership classification.
string
ISO 8601 cache fetch or custom-save timestamp.
object[]
Cached or supplied tweet writing samples.
object
Second cached profile. It follows the same contract as style1.

400 Missing Parameters

One or both query values are missing. Send username1 and username2.

401 Unauthenticated

Authentication failed. Replace the missing or invalid credential.

404 Style Not Found

At least one cache key is missing for this Xquik account. List styles first.

429 Rate Limited

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

Does Compare Styles Calculate Tone or Brand Voice?

No. It returns 2 cached tweet sample sets. Your application performs any tone, voice, vocabulary, or sentence-pattern analysis.

Can I Compare an X Username with a Custom Style?

Yes. Send the analyzed username and the saved custom label as the 2 query values. Both profiles must belong to the authenticated Xquik account.

Can I Compare Twitter Analytics for Another Account?

Not with this endpoint. Compare Styles returns writing samples, not engagement metrics. Analyze Performance retrieves current metrics for cached tweets.

Why Does Compare Styles Return 404?

At least one lowercase key is missing from this account. List styles, verify both keys, then analyze or save the missing profile.
Related: Get Style isolates one profile. Delete Style removes a cached profile.