Inicio rápido

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"

from xdk import Client

client = Client(bearer_token="YOUR_BEARER_TOKEN")

# Obtener los seguidores de un usuario con paginación
for page in client.users.get_followers(
    "2244994945",
    user_fields=["username", "verified", "public_metrics"],
    max_results=100
):
    for user in page.data:
        print(f"{user.username} - Seguidores: {user.public_metrics.followers_count}")

import { Client } from "@xdevplatform/xdk";

const client = new Client({ bearerToken: "YOUR_BEARER_TOKEN" });

// Obtener los seguidores de un usuario con paginación
const paginator = client.users.getFollowers("2244994945", {
  userFields: ["username", "verified", "public_metrics"],
  maxResults: 100,
});

for await (const page of paginator) {
  page.data?.forEach((user) => {
    console.log(`${user.username} - Seguidores: ${user.public_metrics?.followers_count}`);
  });
}

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"

from xdk import Client

client = Client(bearer_token="YOUR_BEARER_TOKEN")

# Obtener los usuarios que sigue un usuario
for page in client.users.get_following(
    "2244994945",
    user_fields=["username", "verified"],
    max_results=100
):
    for user in page.data:
        print(f"{user.username} - Verified: {user.verified}")

import { Client } from "@xdevplatform/xdk";

const client = new Client({ bearerToken: "YOUR_BEARER_TOKEN" });

// Obtener los usuarios que sigue un usuario
const paginator = client.users.getFollowing("2244994945", {
  userFields: ["username", "verified"],
  maxResults: 100,
});

for await (const page of paginator) {
  page.data?.forEach((user) => {
    console.log(`${user.username} - Verified: ${user.verified}`);
  });
}

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"}'

from xdk import Client
from xdk.oauth1_auth import OAuth1

oauth1 = OAuth1(
    api_key="YOUR_API_KEY",
    api_secret="YOUR_API_SECRET",
    access_token="YOUR_ACCESS_TOKEN",
    access_token_secret="YOUR_ACCESS_TOKEN_SECRET"
)

client = Client(auth=oauth1)

# Seguir a un usuario
response = client.users.follow(
    source_user_id="123456789",
    target_user_id="2244994945"
)
print(f"Siguiendo: {response.data.following}")

import { Client, OAuth1 } from "@xdevplatform/xdk";

const oauth1 = new OAuth1({
  apiKey: "YOUR_API_KEY",
  apiSecret: "YOUR_API_SECRET",
  accessToken: "YOUR_ACCESS_TOKEN",
  accessTokenSecret: "YOUR_ACCESS_TOKEN_SECRET",
});

const client = new Client({ oauth1 });

// Seguir a un usuario
const response = await client.users.follow("123456789", {
  targetUserId: "2244994945",
});
console.log(`Siguiendo: ${response.data?.following}`);

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"

from xdk import Client
from xdk.oauth1_auth import OAuth1

oauth1 = OAuth1(
    api_key="YOUR_API_KEY",
    api_secret="YOUR_API_SECRET",
    access_token="YOUR_ACCESS_TOKEN",
    access_token_secret="YOUR_ACCESS_TOKEN_SECRET"
)

client = Client(auth=oauth1)

# Dejar de seguir a un usuario
response = client.users.unfollow(
    source_user_id="123456789",
    target_user_id="2244994945"
)
print(f"Following: {response.data.following}")

import { Client, OAuth1 } from "@xdevplatform/xdk";

const oauth1 = new OAuth1({
  apiKey: "YOUR_API_KEY",
  apiSecret: "YOUR_API_SECRET",
  accessToken: "YOUR_ACCESS_TOKEN",
  accessTokenSecret: "YOUR_ACCESS_TOKEN_SECRET",
});

const client = new Client({ oauth1 });

// Dejar de seguir a un usuario
const response = await client.users.unfollow("123456789", "2244994945");
console.log(`Following: ${response.data?.following}`);

Respuesta

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

Parámetros comunes

Parámetro	Descripción
`max_results`	Resultados por página (1-1000; valor predeterminado: 100)
`pagination_token`	Token de la siguiente página
`user.fields`	Campos de usuario adicionales
`expansions`	Objetos 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

Descripción general

Publicaciones

Usuarios

Mensajes directos

Me gusta

Listas

Spaces

Comunidades

Notas de la comunidad

Tendencias

Noticias

Contenido multimedia

Actividad en X

Uso

Conexiones de streaming

Cumplimiento

Enterprise v2

Flujos de Me gusta

GNIP 2.0

Inicio rápido

Obtener los seguidores de un usuario

Respuesta

Obtener a quién sigue un usuario

Seguir a un usuario

Respuesta

Dejar de seguir a un usuario

Respuesta

Parámetros comunes

Próximos pasos

Búsqueda de usuarios

Bloqueos

Silenciar

Referencia de la API