Faça sua primeira solicitação

Este guia orienta você a fazer sua primeira solicitação à X API. Você precisará de uma conta de desenvolvedor com credenciais de app antes de começar.

Início rápido com cURL

A maneira mais rápida de testar a API é com cURL. Vamos consultar um usuário:

curl "https://api.x.com/2/users/by/username/xdevelopers" \
  -H "Authorization: Bearer $BEARER_TOKEN"

Substitua $BEARER_TOKEN pelo seu Bearer Token real. Você receberá uma resposta como esta:

{
  "data": {
    "id": "2244994945",
    "name": "X Developers",
    "username": "xdevelopers"
  }
}

Guia passo a passo

Obtenha seu Bearer Token

No Developer Console, navegue até o seu app e copie o Bearer Token.

Escolha um endpoint

Comece com um destes endpoints amigáveis para iniciantes:

Endpoint	O que faz
User lookup	Obtenha o perfil de usuário por username ou ID
Post lookup	Obtenha um post por ID
Recent search	Pesquise posts dos últimos 7 dias

Faça a solicitação

Use cURL, Postman ou seu cliente HTTP preferido:

# Look up a user by username
curl "https://api.x.com/2/users/by/username/xdevelopers" \
  -H "Authorization: Bearer $BEARER_TOKEN"

Faça o parse da resposta

As respostas são em JSON. Os dados principais ficam no campo data:

{
  "data": {
    "id": "2244994945",
    "name": "X Developers",
    "username": "xdevelopers"
  }
}

Solicite mais dados com fields

Por padrão, os endpoints retornam campos mínimos. Use o parâmetro fields para solicitar dados adicionais:

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

Resposta:

{
  "data": {
    "id": "2244994945",
    "name": "X Developers",
    "username": "xdevelopers",
    "created_at": "2013-12-14T04:35:55.000Z",
    "description": "The voice of the X Developer Platform",
    "public_metrics": {
      "followers_count": 570842,
      "following_count": 2048,
      "tweet_count": 14052,
      "listed_count": 1672
    }
  }
}

Saiba mais sobre fields →

Mais exemplos

Consultar um post
Pesquisar posts recentes
Obter posts de um usuário

curl "https://api.x.com/2/tweets/1460323737035677698?tweet.fields=created_at,public_metrics" \
  -H "Authorization: Bearer $BEARER_TOKEN"

curl "https://api.x.com/2/tweets/search/recent?query=from:xdevelopers&tweet.fields=created_at" \
  -H "Authorization: Bearer $BEARER_TOKEN"

curl "https://api.x.com/2/users/2244994945/tweets?max_results=5" \
  -H "Authorization: Bearer $BEARER_TOKEN"

Usando código em vez de cURL

Python
JavaScript
SDKs oficiais

import requests

bearer_token = "YOUR_BEARER_TOKEN"
url = "https://api.x.com/2/users/by/username/xdevelopers"

headers = {"Authorization": f"Bearer {bearer_token}"}
response = requests.get(url, headers=headers)

print(response.json())

const bearerToken = "YOUR_BEARER_TOKEN";
const url = "https://api.x.com/2/users/by/username/xdevelopers";

fetch(url, {
  headers: { Authorization: `Bearer ${bearerToken}` }
})
  .then(res => res.json())
  .then(data => console.log(data));

Ferramentas para testes

Postman

Teste visual da API com a nossa coleção.

Código de exemplo

Exemplos em múltiplas linguagens.

Referência da API

Documentação completa de endpoints.

Solução de problemas

401 Unauthorized

Verifique se o seu Bearer Token está correto
Garanta que o token não foi regenerado
Verifique o formato do cabeçalho Authorization: Bearer YOUR_TOKEN

403 Forbidden

Seu app pode não ter acesso a este endpoint
Alguns endpoints exigem autenticação user-context (OAuth 1.0a ou 2.0)
Verifique as permissões do seu app no Developer Console

429 Too Many Requests

Você atingiu um limite de taxa
Verifique o cabeçalho x-rate-limit-reset para saber quando tentar novamente
Implemente exponential backoff no seu código

Referência completa de erros →

Próximas etapas

Aprenda sobre autenticação

Entenda o OAuth para solicitações user-context.

Explore endpoints

Descubra o que você pode construir.

Use um SDK

Desenvolvimento mais rápido com bibliotecas oficiais.

Construa algo

Ideias para o que criar.

​Início rápido com cURL

​Guia passo a passo

​Solicite mais dados com fields

​Mais exemplos

​Usando código em vez de cURL

​Ferramentas para testes