Guia rápido

Este guia mostra como recuperar sua lista de bloqueios, bem como bloquear e desbloquear usuários.

Os endpoints de bloquear e desbloquear usuários só estão disponíveis no plano Enterprise. Você pode preencher o formulário de interesse Enterprise aqui.

Pré-requisitosAntes de começar, você precisará de:

Uma conta de desenvolvedor com um App aprovado
User Access Token (OAuth 1.0a ou OAuth 2.0 PKCE)

Obter usuários bloqueados

Obtenha seu user ID

Você precisa do ID do usuário autenticado para recuperar sua lista de bloqueios. É possível obtê-lo pelo endpoint /2/users/me ou usar o ID dos seus tokens.

Solicite sua lista de bloqueios

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

# Obter usuários bloqueados com paginação
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" });

// Obter usuários bloqueados com paginação
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}`);
  });
}

Revise a resposta

{
  "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 um usuário (somente Enterprise)

Identifique o usuário alvo

Obtenha o user ID da conta que você deseja bloquear.

Envie uma requisição de bloqueio

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 um usuário
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 um usuário
const response = await client.users.block("123456789", {
  targetUserId: "9876543210",
});
console.log(`Blocking: ${response.data?.blocking}`);

Confirme o bloqueio

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

Desbloquear um usuário (somente Enterprise)

Envie uma requisição de desbloqueio

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 um usuário
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 um usuário
const response = await client.users.unblock("123456789", "9876543210");
console.log(`Blocking: ${response.data?.blocking}`);

Confirme o desbloqueio

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

Próximos passos

Mutes

Silencie usuários em vez de bloqueá-los

Follows

Gerencie follows

Guia de integração

Conceitos-chave e melhores práticas

Referência da API

Documentação completa do endpoint

Getting Started

Products

Fundamentals

Partners & Customers

Resources

Guia rápido

Obter usuários bloqueados

Bloquear um usuário (somente Enterprise)

Desbloquear um usuário (somente Enterprise)

Próximos passos

Mutes

Follows

Guia de integração

Referência da API

​Obter usuários bloqueados

​Bloquear um usuário (somente Enterprise)

​Desbloquear um usuário (somente Enterprise)

​Próximos passos

Mutes

Follows

Guia de integração

Referência da API

Obter usuários bloqueados

Bloquear um usuário (somente Enterprise)

Desbloquear um usuário (somente Enterprise)

Próximos passos