Unfollow a User API | Twitter Unfollow Endpoint

Unfollow User removes a follow from your own authenticated X account. It requires a registered X session and returns ok:true when the unfollow is recorded. Pass the target's numeric user_id as a query parameter. This is a write action billed at $0.0008 per call, the same as a standard read.

curl -X POST "https://example.com/user/unfollow?user_id=44196397"

{  "ok": true}

{  "error": "bad_request",  "message": "Missing or malformed parameter. Fix the request before retrying."}

{  "error": "unauthorized",  "message": "The API key is missing, malformed, or revoked. Check the Authorization header."}

{  "error": "insufficient_credits",  "message": "Your balance is exhausted. Top up your credits to continue."}

{  "error": "forbidden",  "message": "The acting account is not authorized for this write action, or has no logged-in session."}

{  "error": "not_found",  "message": "The resource does not exist, for example a deleted tweet or a private account."}

{  "error": "rate_limited",  "message": "Too many requests. Back off and retry with exponential backoff."}

{  "error": "server_error",  "message": "Something failed on our side. Retry with backoff; if it persists, contact support."}

Pricing

Writes are billed at $0.0008 per call, the same as a standard read. A write that fails before reaching X is not billed.

When to use

Use it to unfollow accounts programmatically, for example pruning inactive accounts from who you follow.

Related endpoints

• Follow User: Follow a user on behalf of an authenticated account.
• User Followers: Page through the accounts that follow a user.
• User Following: Page through the accounts a user follows.

FAQ

What does Unfollow User take?

The target account's numeric user_id as a query parameter, plus a registered X session. It returns ok:true once the unfollow is recorded.

Is a session required to unfollow?

Yes. The action edits your own account's following graph, so a registered session is required or the call returns session_required.

What if I do not follow the account?

It returns ok:true since the resulting state is not following. The action is safe to repeat.