Saltar al contenido principal
Esta guía te explica cómo bloquear y desbloquear usuarios y obtener tu lista de bloqueados.
Requisitos previosAntes de comenzar, necesitarás:

​
Obtener usuarios bloqueados

1

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.
2

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"
3

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

1

Identificar al usuario de destino

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

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

Confirmar el bloqueo

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

​
Desbloquear a un usuario

1

Enviar una solicitud de desbloqueo

cURL
curl -X DELETE "https://api.x.com/2/users/123456789/blocking/9876543210" \
  -H "Authorization: Bearer $USER_ACCESS_TOKEN"
2

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