Retweet - Xquik

10 credits per call · All plans from $0.00012/credit

curl -X POST https://xquik.com/api/v1/x/tweets/1895432178065391234/retweet \
  -H "x-api-key: xq_YOUR_KEY_HERE" \
  -H "Content-Type: application/json" \
  -d '{
    "account": "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.

Path parameters

string

required

The ID of the tweet to retweet.

Body

account

string

required

X username or account ID identifying which connected X account will retweet. The @ prefix is automatically stripped if included.

Response

Idempotent. Calling retweet on a tweet you have already retweeted returns 200 success. The credit is still charged because X confirmed the action is in place.

success

boolean

Always true on success.

{
  "success": true
}

{ "error": "invalid_input", "message": "Invalid tweet ID or account" }

Invalid tweet ID format or missing account field.

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

Missing or invalid API key.

{ "error": "no_subscription", "message": "No active subscription" }

An active subscription is required. Subscribe from the dashboard.

{ "error": "insufficient_credits", "message": "Insufficient credits" }

Insufficient credits for this operation. Top up your credit balance from the dashboard.

{ "error": "account_needs_reauth" }

The connected X account failed a recent login attempt and needs to be reconnected. Reconnect it from the dashboard.

{ "error": "account_restricted" }

The connected X account is locked, suspended, recovering, or temporarily restricted. Resolve the restriction on X before retrying.

{ "error": "x_content_too_long", "message": "..." }

X rejected the write. Possible codes: x_content_too_long, x_account_suspended, x_account_protected, x_target_not_found, x_account_feature_required, x_rejected. See error handling for details.

{ "error": "x_rate_limited", "message": "..." }

X throttled the write. Possible codes: x_rate_limited (short-term throttle) or x_daily_limit (daily cap hit). Back off and retry later. Distinct from Xquik tier-based 429.

{ "error": "x_transient_error", "message": "..." }

A transient write service issue occurred. Safe to retry with exponential backoff.

{ "error": "x_write_failed", "message": "Failed to retweet" }

The retweet could not be completed. The tweet may have been deleted, or the connected account may be rate-limited. Try again later.

Related: Unretweet to remove a retweet, Like Tweet to like a tweet, Unlike Tweet to remove a like, or Create Tweet to post an original tweet.

Documentation Index

​Headers

​Path parameters

​Body

​Response

Headers

Path parameters

Body

Response