Follows

The Follows endpoints let you follow and unfollow users, and retrieve follower and following. Reference for the X API v2 standard tier covering follows.

The Follows endpoints let you follow and unfollow users, and retrieve follower and following lists for any user.

Overview

Follow

Follow a user on behalf of the authenticated user

Unfollow

Unfollow a user

Followers

Get a user’s followers

Following

Get who a user follows

---

Endpoints

Follows lookup

Method	Endpoint	Description
GET	/2/users/:id/followers	Get a user’s followers
GET	/2/users/:id/following	Get who a user follows

Manage follows

Method	Endpoint	Description
POST	/2/users/:id/following	Follow a user
DELETE	/2/users/:source_user_id/following/:target_user_id	Unfollow a user

---

Example: Get followers

curl "https://api.x.com/2/users/2244994945/followers?\
user.fields=username,verified,public_metrics" \
  -H "Authorization: Bearer $BEARER_TOKEN"

Example: Follow a user

curl -X POST "https://api.x.com/2/users/123456789/following" \
  -H "Authorization: Bearer $USER_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"target_user_id": "2244994945"}'

---

Getting started

Prerequisites

• An approved developer account
• A Project and App in the Developer Console
• Your App’s keys and tokens

Quickstart

Get started with follows

API Reference

Full endpoint documentation

Sample code

Working code examples