Skip to main content

Follow / Unfollow

Follow / Unfollow

Follow or unfollow users from your connected X account. Username is resolved to user ID automatically. Each operation consumes 100 flat credits.

POST/v2/users/:username/followFollow a user by username.
ParameterTypeRequiredDefaultDescription
usernamestringrequired—The username to follow (path parameter)
BASH
curl -X POST https://xcrop.io/api/v2/users/VitalikButerin/follow \
  -H "Authorization: Bearer $XCROP_API_KEY"
ResponseJSON
{
  "success": true,
  "data": {
    "username": "VitalikButerin",
    "user_id": "295218901",
    "followed": true
  },
  "meta": { "latency_ms": 523 }
}
DELETE/v2/users/:username/followUnfollow a user by username.
BASH
curl -X DELETE https://xcrop.io/api/v2/users/VitalikButerin/follow \
  -H "Authorization: Bearer $XCROP_API_KEY"
ResponseJSON
{
  "success": true,
  "data": {
    "username": "VitalikButerin",
    "user_id": "295218901",
    "unfollowed": true
  },
  "meta": { "latency_ms": 467 }
}

More in Write API

Full documentation with search: xcrop.io/docs