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.

Getting Started

Products

Fundamentals

Partners & Customers

Resources

Faça sua primeira solicitação

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

Postman

Código de exemplo

Referência da API

Solução de problemas

Próximas etapas

Aprenda sobre autenticação

Explore endpoints

Use um SDK

Construa algo

​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

Postman

Código de exemplo

Referência da API

​Solução de problemas

​Próximas etapas

Aprenda sobre autenticação

Explore endpoints

Use um SDK

Construa algo

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

Solução de problemas

Próximas etapas