Guia rápido

Este guia mostra como recuperar listas de seguidores e de quem o usuário segue, além de gerenciar follows.

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

Uma conta de desenvolvedor com um App aprovado
O Bearer Token do seu App (para consultas)
User Access Token (para gerenciar follows)

Obter os seguidores de um usuário

Recupere a lista de usuários que seguem um usuário 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")

# Obter os seguidores de um usuário com paginação
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} - Followers: {user.public_metrics.followers_count}")

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

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

// Obter os seguidores de um usuário com paginação
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} - Followers: ${user.public_metrics?.followers_count}`);
  });
}

Resposta

Exemplo de resposta

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

Obter quem um usuário segue

Recupere a lista de usuários que um usuário específico segue:

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

# Obter os usuários que um usuário segue
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" });

// Obter os usuários que um usuário segue
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 um usuário

Siga um usuário em nome do usuário 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 um usuário
response = client.users.follow(
    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 });

// Seguir um usuário
const response = await client.users.follow("123456789", {
  targetUserId: "2244994945",
});
console.log(`Following: ${response.data?.following}`);

Resposta

{
  "data": {
    "following": true,
    "pending_follow": false
  }
}

Se a conta alvo for protegida, pending_follow será true até que a solicitação de follow seja aprovada.

Deixar de seguir um usuário

Deixe de seguir um usuário em nome do usuário 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)

# Deixar de seguir um usuário
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 });

// Deixar de seguir um usuário
const response = await client.users.unfollow("123456789", "2244994945");
console.log(`Following: ${response.data?.following}`);

Resposta

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

Parâmetros comuns

Parâmetro	Descrição
`max_results`	Resultados por página (1-1000, padrão 100)
`pagination_token`	Token para a próxima página
`user.fields`	Fields adicionais de usuário
`expansions`	Objetos relacionados a incluir

Próximos passos

Consulta de usuário

Consulte perfis de usuários

Blocks

Bloqueie e desbloqueie usuários

Mutes

Silencie e reative usuários

Referência da API

Documentação completa do endpoint

Getting Started

Products

Fundamentals

Partners & Customers

Resources

Guia rápido

Obter os seguidores de um usuário

Resposta

Obter quem um usuário segue

Seguir um usuário

Resposta

Deixar de seguir um usuário

Resposta

Parâmetros comuns

Próximos passos

Consulta de usuário

Blocks

Mutes

Referência da API

​Obter os seguidores de um usuário

​Resposta

​Obter quem um usuário segue

​Seguir um usuário

​Resposta

​Deixar de seguir um usuário

​Resposta

​Parâmetros comuns

​Próximos passos

Consulta de usuário

Blocks

Mutes

Referência da API

Obter os seguidores de um usuário

Resposta

Obter quem um usuário segue

Seguir um usuário

Resposta

Deixar de seguir um usuário

Resposta

Parâmetros comuns

Próximos passos