Follow user - Xquik

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

Action-specific rate limit: The follow endpoint is limited to 20 requests per minute and 400 requests per day per account. This is separate from the general write tier (30 per 60s). Exceeding either limit returns 429 Too Many Requests.

curl -X POST https://xquik.com/api/v1/x/users/44196397/follow \
  -H "x-api-key: xq_YOUR_KEY_HERE" \
  -H "Content-Type: application/json" \
  -d '{
    "account": "myxaccount"
  }' | 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 X user ID of the account to follow.

Body

account

string

required

X username or account ID of your connected account to act as.

Response

success

boolean

Always true on success.

{
  "success": true
}

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

The user ID or account field is missing or malformed.

{ "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_duplicate_action, x_account_suspended, x_account_protected, x_target_not_found, x_account_feature_required, x_rejected. See error handling for details.

{ "error": "rate_limit_exceeded", "retryAfter": 60 }

The request hit an Xquik tier or follow-action limit, or X throttled the write. Possible codes: rate_limit_exceeded, x_rate_limited, or x_daily_limit. Respect the Retry-After header when present.

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

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

{ "error": "x_write_failed", "message": "Failed to complete the action" }

The write action failed. Retry after a short delay.

Related: Unfollow User to reverse this action, or Get User to look up user details before following.

Documentation Index

​Headers

​Path parameters

​Body

​Response

Headers

Path parameters

Body

Response