Saltar al contenido principal
Esta guía te explica cómo recuperar las listas de seguidores y seguidos, y cómo gestionar los seguimientos.
Requisitos previosAntes de empezar, necesitarás:
  • Una cuenta de desarrollador con una App aprobada
  • El Bearer Token de tu App (para consultas)
  • El User Access Token (para gestionar seguimientos)

​
Obtener los seguidores de un usuario

Obtén la lista de usuarios que siguen a un usuario específico:
cURL
curl "https://api.x.com/2/users/2244994945/followers?\
user.fields=username,verified,public_metrics&\
max_results=100" \
  -H "Authorization: Bearer $BEARER_TOKEN"

​
Respuesta

{
  "data": [
    {
      "id": "1234567890",
      "name": "Developer",
      "username": "dev_user",
      "verified": false,
      "public_metrics": {
        "followers_count": 500,
        "following_count": 200,
        "tweet_count": 1500
      }
    }
  ],
  "meta": {
    "result_count": 1,
    "next_token": "abc123"
  }
}

​
Obtener a quién sigue un usuario

Recupera la lista de usuarios que sigue un usuario específico:
cURL
curl "https://api.x.com/2/users/2244994945/following?\
user.fields=username,verified&\
max_results=100" \
  -H "Authorization: Bearer $BEARER_TOKEN"

​
Seguir a un usuario

Sigue a un usuario en nombre del usuario autenticado:
cURL
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"}'

​
Respuesta

{
  "data": {
    "following": true,
    "pending_follow": false
  }
}
Si la cuenta de destino está protegida, pending_follow será true hasta que se apruebe la solicitud de seguimiento.

​
Dejar de seguir a un usuario

Deja de seguir a un usuario en nombre del usuario autenticado:
cURL
curl -X DELETE "https://api.x.com/2/users/123456789/following/2244994945" \
  -H "Authorization: Bearer $USER_ACCESS_TOKEN"

​
Respuesta

{
  "data": {
    "following": false
  }
}

​
Parámetros comunes

ParámetroDescripción
max_resultsResultados por página (1-1000; valor predeterminado: 100)
pagination_tokenToken de la siguiente página
user.fieldsCampos de usuario adicionales
expansionsObjetos relacionados que se incluirán

​
Próximos pasos

Búsqueda de usuarios

Consulta perfiles de usuario

Bloqueos

Bloquea y desbloquea usuarios

Silenciar

Silencia y deja de silenciar usuarios

Referencia de la API

Documentación completa del endpoint