Pular para o conteúdo principal
Esta página reúne informações sobre várias ferramentas e conceitos fundamentais para ajudar você a integrar os endpoints de busca de Posts ao seu sistema. Organizamos a página em algumas seções:

​
Ferramentas úteis

Antes de abordarmos alguns conceitos fundamentais, recomendamos que você se familiarize com as seguintes ferramentas: Postman
O Postman é uma excelente ferramenta para testar um endpoint, incluindo todos os parâmetros de caminho e de corpo, ajudando você a entender o que está disponível. Confira nosso guia de primeiros passos com o Postman para saber mais. Exemplos de código
Encontre exemplos de código para sua linguagem de programação preferida na nossa página no GitHub. Bibliotecas de terceiros
Use bibliotecas de terceiros desenvolvidas pela comunidade e compatíveis com endpoints v2.

​
Conceitos fundamentais

​
Autenticação

Todos os endpoints da X API v2 exigem requisições autenticadas. Você pode se autenticar com:
OAuth 1.0a pode ser desafiador de implementar. Se não estiver familiarizado, considere usar uma biblioteca ou OAuth 2.0 para as requisições. Para metrics privadas ou Posts, use o Contexto de Usuário do OAuth 1.0a ou OAuth 2.0 Authorization Code com PKCE.
Atenção
Se você estiver solicitando os seguintes fields, o Contexto de Usuário do OAuth 1.0a ou OAuth 2.0 Authorization Code é obrigatório:
  • tweet.fields.non_public_metrics
  • tweet.fields.promoted_metrics
  • tweet.fields.organic_metrics
  • media.fields.non_public_metrics
  • media.fields.promoted_metrics
  • media.fields.organic_metrics

​
Portal do desenvolvedor, Projetos e Apps

Para obter credenciais da X API v2, você precisa de:
  1. Uma conta de desenvolvedor aprovada.
  2. Um Projeto dentro da conta de desenvolvedor.
  3. Um App de desenvolvedor dentro desse Projeto, onde é possível encontrar as chaves e tokens.

​
Limites de requisições

As solicitações da X API estão sujeitas a limites de requisições para gerenciar o volume. Os limites se aplicam nos níveis de App e de usuário:
  • Nível de App: Limita o número de solicitações feitas por período por qualquer App.
  • Nível de usuário: Limita a frequência com que um usuário autenticado pode realizar consultas de Post em Apps de desenvolvedor.

​
Fields e expansions

A X API v2 permite selecionar campos de dados específicos usando fields e expansions:
  • Expansions: Permitem recuperar objetos adicionais relacionados. As expansions compatíveis incluem:
    • edit_history_tweet_ids
    • attachments.poll_ids
    • attachments.media_keys
    • author_id
    • entities.mentions.username
    • geo.place_id
    • in_reply_to_user_id
    • referenced_tweets.id
    • referenced_tweets.id.author_id
  • Fields: Especificam campos de dados dentro dos objetos para retornar informações adicionais. O Objeto Post, por padrão, inclui id, text e edit_history_tweet_ids. Outras opções, como tweet.created_at e tweet.entities, devem ser solicitadas explicitamente.
Para mais detalhes, consulte o guia de fields e expansions no dicionário de dados da X API v2.

​
Edições de Posts

Posts elegíveis podem ser editados até cinco vezes nos 30 minutos após a publicação. O endpoint de busca de Posts sempre retorna a versão mais recente do Post. Para casos de uso quase em tempo real, fique atento a essa janela de tempo. Para mais detalhes, consulte Fundamentos de edição de Posts.

​
Casos de borda

  • metrics promovidos: Solicitar metrics promovidos para Posts não promovidos retorna uma resposta vazia.
  • Texto truncado: O texto do Post é truncado em Retweets. Para obter o texto completo, expanda o Post referenciado.
⌘I