Follow User

Follow a user, $0.0005 per call.

Back to API Reference

/Users Endpoints

TwexAPI REST

POST/twitter/user/follow

Authorization

AuthorizationBearer token · headerrequired

Global API Bearer Token for TwexAPI. Included as: Authorization: Bearer <YOUR_TWEXAPI_KEY>.

Request Body

requiredapplication/json

usernamestringrequired

The username of the user to follow or unfollow.

cookiestringrequired

The user's own authorized Twitter session credentials or auth_token (BYOC — Bring Your Own Cookie). Stateless proxy execution with zero credential retention. See [Authentication Security](/authentication#write-operations--byoc-bring-your-own-cookie) and [How to get Cookie](https://youtube-promotion.pages.dev/how-to-get-twitter-cookie).

Responses

200A confirmation of the action's success.

codeinteger

HTTP status code

default: 200

msgstring

Response message

default: "success"

dataUserModel | any

User information

Show properties

Any of:

UserModel

idstringrequired

User ID

namestringrequired

Display name

screen_namestringrequired

Twitter username

created_atstring | any

Account creation date

Show properties

Any of:

string

string

any

any

created_at_datetimestring | any

Account creation datetime in ISO format

Show properties

Any of:

string

string

any

any

can_dmboolean | any

Whether the user can be direct messaged

default: false

Show properties

Any of:

boolean

boolean

any

any

can_media_tagboolean | any

Whether the user can be tagged in media

default: false

Show properties

Any of:

boolean

boolean

any

any

default_profileboolean | any

Whether the user has a default profile

default: false

Show properties

Any of:

boolean

boolean

any

any

default_profile_imageboolean | any

Whether the user has a default profile image

default: false

Show properties

Any of:

boolean

boolean

any

any

descriptionstring | any

User's bio description

default: ""

Show properties

Any of:

string

string

any

any

description_urlsstring[]

List of URLs found in the user's description

default: []

urlsurlModel[] | any

List of URLs found in the user's profile

Show properties

Any of:

urlModel[]

Array of urlModel

urlstringrequired

URL

expanded_urlstring | any

Expanded URL

Show properties

Any of:

string

string

any

any

display_urlstring | any

Display URL

Show properties

Any of:

string

string

any

any

any

any

fast_followers_countinteger | any

Count of fast followers

default: 0

Show properties

Any of:

integer

integer

any

any

favourites_countinteger | any

Number of tweets the user has liked

default: 0

Show properties

Any of:

integer

integer

any

any

followers_countinteger | any

Number of followers

default: 0

Show properties

Any of:

integer

integer

any

any

following_countinteger | any

Number of users this user is following

default: 0

Show properties

Any of:

integer

integer

any

any

has_custom_timelinesboolean | any

Whether the user has custom timelines

default: false

Show properties

Any of:

boolean

boolean

any

any

is_blue_verifiedboolean | any

Blue verification status

default: false

Show properties

Any of:

boolean

boolean

any

any

verified_typestring | any

Verification badge type when not blue-only: blue, business, government, etc.

Show properties

Any of:

string

string

any

any

is_verifiedboolean | any

True if the account has any verification badge (blue, business, government, or legacy verified)

default: false

Show properties

Any of:

boolean

boolean

any

any

profile_image_shapestring | any

Profile image shape (Circle or Square; Square often indicates business/government)

Show properties

Any of:

string

string

any

any

is_translatorboolean | any

Whether the user is a translator

default: false

Show properties

Any of:

boolean

boolean

any

any

listed_countinteger | any

Number of public lists the user is a member of

default: 0

Show properties

Any of:

integer

integer

any

any

locationstring | any

User's location

default: ""

Show properties

Any of:

string

string

any

any

media_countinteger | any

Number of media tweets posted by the user

default: 0

Show properties

Any of:

integer

integer

any

any

normal_followers_countinteger | any

Count of normal followers

default: 0

Show properties

Any of:

integer

integer

any

any

pinned_tweet_idsstring[]

List of pinned tweet IDs

default: []

possibly_sensitiveboolean | any

Whether the user's profile may contain sensitive content

default: false

Show properties

Any of:

boolean

boolean

any

any

profile_banner_urlstring | any

URL of the user's profile banner

Show properties

Any of:

string

string

any

any

profile_image_urlstring | any

URL of the user's profile image

Show properties

Any of:

string

string

any

any

protectedboolean | any

Whether the user's tweets are protected

default: false

Show properties

Any of:

boolean

boolean

any

any

statuses_countinteger | any

Number of tweets posted by the user

default: 0

Show properties

Any of:

integer

integer

any

any

any

any

422Validation Error

detailValidationError[]

Show properties

Array of ValidationError

locstring | integer[]required

Show properties

Array of string | integer

Any of:

string

string

integer

integer

msgstringrequired

typestringrequired

inputany

ctxobject

⚡Interactive Console / Try APIPOST/twitter/user/follow

Live Console

🌐Target Server:https://api.twexapi.io

● Production Ready

✍️

Write Operation Credentials Guide (TwexAPI Key + Twitter Cookie)

1. TwexAPI Platform Key (Bearer Token): Enter under "API Authorization" below for request billing & authentication.

2. Twitter Account Cookie: For write operations (tweet, like, follow, etc.), provide the target Twitter account's Cookie (e.g. auth_token=...; ct0=...) in the cookie field of Request Body below.

🔑API Authorization

Remember keySync to code samples

TwexAPI Platform Key Bearer TokenRequired

Global API key used across all TwexAPI endpoints. Get it from the console.

📝Request Bodyapplication/json

usernamestring

RequiredThe username of the user to follow or unfollow.

cookiestringTwitter Account Cookie / Auth Token

RequiredThe user's own authorized Twitter session credentials or auth_token (BYOC — Bring Your Own Cookie). Stateless proxy execution with zero credential retention. See [Authentication Security](/authentication#write-operations--byoc-bring-your-own-cookie) and [How to get Cookie](https://youtube-promotion.pages.dev/how-to-get-twitter-cookie).

💡 Quick send:⌘ / Ctrl+Enter

📡

No Response Yet

Configure parameters in the Request tab and click Send Request below.

Request

curl -X POST "https://api.twexapi.io/twitter/user/follow" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "username": "string",
  "cookie": "ct0=abc123... or 2c4a4e1832096aa694c739b83c83b6d96d43eba7"
}'

const response = await fetch("https://api.twexapi.io/twitter/user/follow", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_TOKEN",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
  "username": "string",
  "cookie": "ct0=abc123... or 2c4a4e1832096aa694c739b83c83b6d96d43eba7"
})
});

import requests

response = requests.post(
    "https://api.twexapi.io/twitter/user/follow",
    headers={
        "Authorization": "Bearer YOUR_TOKEN",
        "Content-Type": "application/json"
    },
    json={
  "username": "string",
  "cookie": "ct0=abc123... or 2c4a4e1832096aa694c739b83c83b6d96d43eba7"
},
)

Response

{
  "code": 200,
  "msg": "success",
  "data": {
    "id": "1717001045992251392",
    "name": "Cryptoklepto",
    "screen_name": "CK_Cryptoklepto",
    "created_at": "Mon Oct 28 02:32:47 +0000 2024",
    "created_at_datetime": "2024-10-28T02:32:47.000Z",
    "can_dm": false,
    "can_media_tag": false,
    "default_profile": false,
    "default_profile_image": false,
    "description": "",
    "description_urls": [],
    "urls": [
      {
        "url": "https://www.google.com",
        "expanded_url": "https://www.google.com",
        "display_url": "www.google.com"
      }
    ],
    "fast_followers_count": 0,
    "favourites_count": 0,
    "followers_count": 0,
    "following_count": 0,
    "has_custom_timelines": false,
    "is_blue_verified": false,
    "verified_type": "government",
    "is_verified": false,
    "profile_image_shape": "Circle",
    "is_translator": false,
    "listed_count": 0,
    "location": "New York, USA",
    "media_count": 0,
    "normal_followers_count": 0,
    "pinned_tweet_ids": [],
    "possibly_sensitive": false,
    "profile_banner_url": "string",
    "profile_image_url": "string",
    "protected": false,
    "statuses_count": 0
  }
}

{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string",
      "input": null,
      "ctx": {}
    }
  ]
}