Inicio rápido

Esta guía te explica cómo bloquear y desbloquear usuarios y obtener tu lista de bloqueados.

Requisitos previosAntes de comenzar, necesitarás:

Una cuenta de desarrollador con una App aprobada
Un token de acceso de usuario (OAuth 1.0a u OAuth 2.0 PKCE)

Obtener usuarios bloqueados

Obtén tu ID de usuario

Necesitas el ID del usuario autenticado para recuperar tu lista de bloqueos. Puedes obtenerlo en el endpoint /2/users/me o usar el ID de tus tokens.

Solicita tu lista de bloqueos

cURL

curl "https://api.x.com/2/users/123456789/blocking?\
user.fields=username,verified,created_at&\
max_results=100" \
  -H "Authorization: Bearer $USER_ACCESS_TOKEN"

from xdk import Client

client = Client(bearer_token="YOUR_USER_ACCESS_TOKEN")

# Obtener usuarios bloqueados con paginación
for page in client.users.get_blocking(
    "123456789",
    user_fields=["username", "verified", "created_at"],
    max_results=100
):
    for user in page.data:
        print(f"{user.username} - Created: {user.created_at}")

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

const client = new Client({ accessToken: "YOUR_USER_ACCESS_TOKEN" });

// Obtener usuarios bloqueados con paginación
const paginator = client.users.getBlocking("123456789", {
  userFields: ["username", "verified", "created_at"],
  maxResults: 100,
});

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

Revisa la respuesta

{
  "data": [
    {
      "id": "17874544",
      "name": "Example User",
      "username": "example_user",
      "verified": false,
      "created_at": "2008-12-04T18:51:57.000Z"
    }
  ],
  "meta": {
    "result_count": 1,
    "next_token": "abc123"
  }
}

Bloquear a un usuario

Identificar al usuario de destino

Obtén el ID de usuario de la cuenta que quieres bloquear.

Enviar una solicitud de bloqueo

cURL

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

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)

# Bloquear a un usuario
response = client.users.block(
    source_user_id="123456789",
    target_user_id="9876543210"
)
print(f"Blocking: {response.data.blocking}")

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 });

// Bloquear a un usuario
const response = await client.users.block("123456789", {
  targetUserId: "9876543210",
});
console.log(`Blocking: ${response.data?.blocking}`);

Confirmar el bloqueo

{
  "data": {
    "blocking": true
  }
}

Desbloquear a un usuario

Enviar una solicitud de desbloqueo

cURL

curl -X DELETE "https://api.x.com/2/users/123456789/blocking/9876543210" \
  -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)

# Desbloquear a un usuario
response = client.users.unblock(
    source_user_id="123456789",
    target_user_id="9876543210"
)
print(f"Blocking: {response.data.blocking}")

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 });

// Desbloquear a un usuario
const response = await client.users.unblock("123456789", "9876543210");
console.log(`Blocking: ${response.data?.blocking}`);

Confirmar el desbloqueo

{
  "data": {
    "blocking": false
  }
}

Próximos pasos

Silenciamientos

Silencia usuarios en lugar de bloquearlos

Seguidos

Gestiona a quién sigues

Guía de integración

Conceptos clave y mejores prácticas

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 usuarios bloqueados

Bloquear a un usuario

Desbloquear a un usuario

Próximos pasos

Silenciamientos

Seguidos

Guía de integración

Referencia de la API

​Obtener usuarios bloqueados

​Bloquear a un usuario

​Desbloquear a un usuario

​Próximos pasos

Silenciamientos

Seguidos

Guía de integración

Referencia de la API

Obtener usuarios bloqueados

Bloquear a un usuario

Desbloquear a un usuario

Próximos pasos