Faça sua primeira solicitação

Este guia mostra como 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, acesse seu app e copie o Bearer Token.

Escolha um endpoint

Comece com um destes endpoints fáceis para iniciantes:

Endpoint	O que faz
User lookup	Obtenha o perfil do usuário por nome de usuário 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 o cliente HTTP de sua preferência:

# Consultar um usuário por nome de usuário
curl "https://api.x.com/2/users/by/username/xdevelopers" \
  -H "Authorization: Bearer $BEARER_TOKEN"

Leia a 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 várias linguagens.

Referência da API

Documentação completa dos endpoints.

Solução de problemas

401 Unauthorized

Verifique se o Bearer Token está correto
Garanta que o token não foi regenerado
Confirme o formato do header Authorization: Bearer YOUR_TOKEN

403 Forbidden

Seu app pode não ter acesso a este endpoint
Alguns endpoints exigem autenticação com contexto de usuário (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 header x-rate-limit-reset para saber quando tentar novamente
Implemente exponential backoff no seu código

Referência completa de erros →

Próximas etapas

Aprender autenticação

Entenda o OAuth para solicitações com contexto de usuário.

Explorar endpoints

Descubra o que você pode criar.

Usar um SDK

Desenvolva mais rápido com as bibliotecas oficiais.

Criar algo

Ideias para você desenvolver.

​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