Guia rápido de consulta de usuário

Este guia mostra como consultar usuários pelo ID ou pelo username.

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

Uma conta de desenvolvedor com um App aprovado
O Bearer Token do seu App

Consultar por ID

Um único usuário

cURL

curl "https://api.x.com/2/users/2244994945?\
user.fields=created_at,description,verified,public_metrics" \
  -H "Authorization: Bearer $BEARER_TOKEN"

from xdk import Client

client = Client(bearer_token="YOUR_BEARER_TOKEN")

# Obter usuário por ID
response = client.users.get(
    "2244994945",
    user_fields=["created_at", "description", "verified", "public_metrics"]
)

print(f"Name: {response.data.name}")
print(f"Username: {response.data.username}")
print(f"Followers: {response.data.public_metrics.followers_count}")

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

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

// Obter usuário por ID
const response = await client.users.get("2244994945", {
  userFields: ["created_at", "description", "verified", "public_metrics"],
});

console.log(`Name: ${response.data?.name}`);
console.log(`Username: ${response.data?.username}`);
console.log(`Followers: ${response.data?.public_metrics?.followers_count}`);

Resposta

Exemplo de resposta

{
  "data": {
    "id": "2244994945",
    "name": "X Developers",
    "username": "XDevelopers",
    "created_at": "2013-12-14T04:35:55.000Z",
    "description": "The voice of the X developer community",
    "verified": true,
    "public_metrics": {
      "followers_count": 583423,
      "following_count": 2048,
      "tweet_count": 14052,
      "listed_count": 1672
    }
  }
}

Vários usuários

Consulte até 100 usuários de uma vez:

cURL

curl "https://api.x.com/2/users?\
ids=2244994945,783214,6253282&\
user.fields=username,verified" \
  -H "Authorization: Bearer $BEARER_TOKEN"

from xdk import Client

client = Client(bearer_token="YOUR_BEARER_TOKEN")

# Obter vários usuários por ID
response = client.users.get_users(
    ids=["2244994945", "783214", "6253282"],
    user_fields=["username", "verified"]
)

for user in response.data:
    print(f"{user.username} - Verified: {user.verified}")

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

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

// Obter vários usuários por ID
const response = await client.users.getUsers({
  ids: ["2244994945", "783214", "6253282"],
  userFields: ["username", "verified"],
});

response.data?.forEach((user) => {
  console.log(`${user.username} - Verified: ${user.verified}`);
});

Consultar por username

Um único usuário

cURL

curl "https://api.x.com/2/users/by/username/XDevelopers?\
user.fields=created_at,description,verified" \
  -H "Authorization: Bearer $BEARER_TOKEN"

from xdk import Client

client = Client(bearer_token="YOUR_BEARER_TOKEN")

# Obter usuário por username
response = client.users.get_by_username(
    "XDevelopers",
    user_fields=["created_at", "description", "verified"]
)

print(f"ID: {response.data.id}")
print(f"Name: {response.data.name}")

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

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

// Obter usuário por username
const response = await client.users.getByUsername("XDevelopers", {
  userFields: ["created_at", "description", "verified"],
});

console.log(`ID: ${response.data?.id}`);
console.log(`Name: ${response.data?.name}`);

Vários usuários

cURL

curl "https://api.x.com/2/users/by?\
usernames=XDevelopers,X,elonmusk&\
user.fields=created_at,verified" \
  -H "Authorization: Bearer $BEARER_TOKEN"

from xdk import Client

client = Client(bearer_token="YOUR_BEARER_TOKEN")

# Obter vários usuários por username
response = client.users.get_users_by_usernames(
    usernames=["XDevelopers", "X", "elonmusk"],
    user_fields=["created_at", "verified"]
)

for user in response.data:
    print(f"{user.username} - {user.created_at}")

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

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

// Obter vários usuários por username
const response = await client.users.getUsersByUsernames({
  usernames: ["XDevelopers", "X", "elonmusk"],
  userFields: ["created_at", "verified"],
});

response.data?.forEach((user) => {
  console.log(`${user.username} - ${user.created_at}`);
});

Fields disponíveis

Field	Descrição
`created_at`	Data de criação da conta
`description`	Bio do usuário
`profile_image_url`	URL do avatar
`verified`	Status de verificação
`public_metrics`	Contagens de seguidores/seguindo
`location`	Localização definida pelo usuário
`url`	Site do usuário
`protected`	Status de conta protegida
`pinned_tweet_id`	ID do Post fixado

Tratamento de erros

Usuário não encontrado

{
  "errors": [
    {
      "resource_type": "user",
      "title": "Not Found Error",
      "detail": "Could not find user with username: [nonexistent_user]."
    }
  ]
}

Usuário protegido

Os dados de usuários protegidos ainda são retornados, mas você não conseguirá acessar os Posts deles a menos que os siga.

Próximos passos

Usuário autenticado

Obtenha o usuário atual

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 de consulta de usuário

Consultar por ID

Um único usuário

Resposta

Vários usuários

Consultar por username

Um único usuário

Vários usuários

Fields disponíveis

Tratamento de erros

Usuário não encontrado

Usuário protegido

Próximos passos

Usuário autenticado

Guia de integração

Referência da API

​Consultar por ID

​Um único usuário

​Resposta

​Vários usuários

​Consultar por username

​Um único usuário

​Vários usuários

​Fields disponíveis

​Tratamento de erros

​Usuário não encontrado

​Usuário protegido

​Próximos passos

Usuário autenticado

Guia de integração

Referência da API

Consultar por ID

Um único usuário

Resposta

Vários usuários

Consultar por username

Um único usuário

Vários usuários

Fields disponíveis

Tratamento de erros

Usuário não encontrado

Usuário protegido

Próximos passos