O que é a API do Twitter?
A API do Twitter é uma interface pela qual um site ou aplicativo pode interagir com o Twitter. Ela permite acesso aos principais recursos da plataforma, como publicar tweets, retweetar e encontrar tweets que contenham uma palavra específica através de um site. Isso se torna possível graças aos chamados endpoints – endereços que correspondem a um tipo específico de informação fornecida. Tweets, respostas, mensagens diretas, anúncios e ferramentas de publicação são fáceis de obter com a ajuda da API do Twitter.
Como obter a chave de API do Twitter — tutorial
Para conectar o Twitter ao seu site, você precisará, obviamente, de uma conta. Se ainda não tiver, crie uma chave de API do Twitter.
Passo 1: Crie uma conta de desenvolvedor no Twitter
Primeiro, vá para a seção de desenvolvedores.
Etapa 2: Solicite uma conta de desenvolvedor
Cadastre-se com sua conta na plataforma Twitter para desenvolvedores.
Primeiro, você precisará enviar informações sobre o seu aplicativo futuro que usará dados do Twitter.
Passo 3: Escolha o motivo para usar a chave de API do Twitter
Pode incluir a criação de uma API de bot do Twitter, ensino, realização de pesquisas acadêmicas e muito mais.
Etapa 4: Preencha os campos obrigatórios
Selecione o país onde você mora e escreva o nome para o qual a equipe do Twitter deve ligar para você. Pressione Próximo.
Passo 5: Responda a perguntas detalhadas sobre o seu app.
Existem várias perguntas com campos de pelo menos 100 caracteres. Você precisará preencher os dados específicos do projeto em que usará o Twitter.
Além disso, você pode optar pela opção que não analisa os dados do Twitter de qualquer forma.
Etapa 6: Verifique as informações.
Se tudo estiver certo, clique em “Parece bom!”
Passo 7: Leia os Termos do Desenvolvedor
Revise e aceite-os clicando em ‘Enviar inscrição’. Observação: você precisa ter um e-mail verificado antes de enviar a inscrição no Twitter.
Pendências costumam levar quase um dia; alguns desenvolvedores afirmam ter aguardado meses. De qualquer forma, se você decidiu criar um app baseado no Twitter, não espere até o último momento.
Verifique tudo com cuidado! O Twitter analisa tudo com muito cuidado, e se o seu caso de uso parecer suspeito, a aplicação será rejeitada. Você não poderá recorrer dessa decisão.
Assim que você estiver elegível para acesso de desenvolvedor, avance para a segunda etapa – criar uma chave de API.
Etapa 8: Clique na aba “Apps”.
Em seguida, vá para a seção de chaves da API do consumidor. Copie sua chave de API (que você irá colar em um campo ACCESS_TOKEN no seu código) e o segredo da API (que será uma propriedade ACCESS_SECRET).
Copie o token de acesso e o segredo do token de acesso. Você os encontrará após rolar até a seção Token de Acesso e Segredo do Token de Acesso. Clique em Criar.
Passo 9: Parabéns!
Por fim, você tem sua chave de API do Twitter e o token de acesso. Agora, escolha que conteúdo do Twitter você gostaria de exibir no site; deve ser interativo ou estático.
Credenciais da API do Twitter
Para resumir, você precisará obter tokens de acesso de usuário com a ajuda de uma autenticação de três etapas: Credenciais de Cliente, Credenciais Temporárias, Credenciais de Token.
Exemplos da API do Twitter
Existem dois tipos principais de APIs: a API de Streaming e as APIs REST. A primeira é usada para publicar tweets em tempo real em um site, enquanto as APIs REST apresentam conteúdos específicos (apenas tweets históricos, comentários ou apenas seguidores). Vamos começar olhando com mais detalhes a API de Streaming.
API de streaming do Twitter
A API de streaming não permite que as pessoas façam nada com o conteúdo: ela apenas exibe os tweets necessários do Twitter em tempo real. Ao se desconectar do aplicativo, você inevitavelmente se desassocia de sua API. Ao estabelecer a conexão com o Twitter, você começará a receber um fluxo de diferentes tipos de dados: tweets, sinais de keep-alive (que mantêm a conexão ativa) e mensagens do sistema. A API de feed do Twitter é um dos exemplos típicos de API de streaming.
API de feed do Twitter
Ao usar esta API em seu app, você obterá uma linha do tempo do feed do Twitter, um fluxo organizado de tweets. Em seguida, você pode usar um filtro de statuses, ou uma API PowerTrack (somente para a categoria Enterprise) que os filtra.
APIs REST do Twitter
REST significa Representational State Transfer. Ao contrário da API de streaming, ele funciona em um modelo de requisição-resposta: o cliente solicita dados únicos e formatados e o servidor os devolve. A REST API é sem estado, enquanto a streaming API é com estado. Além disso, as REST APIs utilizam os métodos GET e POST. Existem muitos exemplos de REST APIs do Twitter, dependendo da função que executam, por exemplo: API de Usuário, API de feeds do Twitter, API de seguidores do Twitter. Vamos explorar muitos deles com mais detalhes a seguir.
API de busca do Twitter
Você pode pesquisar tweets e exibi-los no seu site, usando vários parâmetros. São geocode, idioma, tipo de resultado (recentes ou mais populares), contagem (número de tweets por página) e muito mais.
API de Usuário
Desenvolvedores web costumam usar a API de Usuário para obter, por exemplo, a lista de seguidores e amigos de um usuário específico. Também é possível ver a linha do tempo dos tweets mais recentes de alguém.
Cadastro da API do Twitter
Use o botão Entrar ou Entrar com o Twitter, que permitirá aos usuários aproveitar os benefícios de suas contas em seu site. Primeiro, você precisará obter um token de requisição, depois redirecionar o usuário para o Twitter e converter o token de requisição em um token de acesso.
API de Tweets do Twitter.
Permite criar, restaurar e excluir tweets e curtidas de posts de forma programática. Por meio da API de Publicação, você poderá exibir e excluir tweets. A API de Tweets do Twitter também permite obter tweets pela API do Twitter.
Trends API
Tendências do Twitter no site são atualizadas a cada cinco minutos. Você pode obter tendências globais, bem como locais. Para apresentar informações dos países de seu interesse, encontre um place id — um identificador de 32 bits fornecido pelo projeto Yahoo! GeoPlanet.
API de anúncios do Twitter
Esta API facilita a gestão de campanhas de anúncios no Twitter de forma programática. Os desenvolvedores do Twitter oferecem a oportunidade de analisar a eficiência de suas campanhas publicitárias na plataforma com a ajuda da API Twitter Analytics.
Status da API do Twitter
Os desenvolvedores podem precisar dele para obter o status de publicações (retweets e curtidas, por exemplo).
API de Geolocalização do Twitter
Permite obter informações sobre um lugar específico e localizar lugares próximos a uma determinada localização. A API de Geolocalização facilita a busca por lugares vinculados a status ou tendências. A solicitação retorna a lista de todos os lugares válidos.
Limites e preços da API do Twitter
Na maioria dos casos, a API do Twitter não é gratuita para desenvolvedores. Existem limites para a utilização de dados do Twitter em projetos.
Você encontrará os seguintes limites ao usar os dados do Twitter com uma assinatura padrão:
| Endpoint | Família de recursos | Janela de Limite de POST | Limite de POST por usuário | Limite de posts por app |
| POST statuses/update | criar conteúdo | 3 horas | 300 | 300 |
| POST statuses/retweet/:id | criar conteúdo | 3 horas | 300 | 300 |
| POST favorites/create | Favoritos | 24 horas | 1000 | 1000 |
| POST friendships/create | amizades | 24 horas | 400 | 1000 |
| POST direct_messages/events/new | Mensagens diretas | 24 horas | 1000 | 15000 |
Para saber mais, leia a referência do Twitter sobre limitação de taxa. Lá também há informações sobre os endpoints GET.
Basicamente, existem três níveis de acesso aos dados que correspondem aos estágios de crescimento do seu projeto: Standard, Premium e Enterprise. A maioria dos recursos do Twitter é gratuita, mas para melhor funcionalidade e acesso você precisará mudar para Premium ou Enterprise nível de assinatura.
A seguir, você encontrará uma tabela com as principais APIs do Twitter e a disponibilidade dos seus níveis de assinatura.
| Padrão (grátis) | Premium ($149/mês – $2.499/mês) | Enterprise (US$ 2.499 e mais) | |
| Publicar e interagir com a API | ✅ | ||
| API de Pesquisa de Tweets: 7 dias | ✅ | ||
| API de Tweets de Pesquisa: 30 dias | ✅ | ✅ | |
| APIs de Contas e Usuários | ✅ | ✅ | ✅ |
| APIs de Anúncios | ✅ | ||
| Ferramentas do site | ✅ |
Saiba mais sobre os níveis de assinatura e preços do Twitter na consulta.
Alterações da API do Twitter
Para entender como funciona a chave de API do Twitter, é essencial conhecer o histórico de alterações.
2016 mudança: A API de Busca adicionou suporte a alguns operadores geográficos, como place, place_country e profile_region.
2017 alteração: A PowerTrack API histórica e a Replay API foram alteradas. Elas passaram a suportar filtragem de Quote Tweet. Além disso, os Metadados de Enquetes ficaram disponíveis por meio das APIs empresariais do Twitter.
2018 mudança: Foi lançada uma nova versão da Usage API. Como resultado, os desenvolvedores do Twitter adicionaram a capacidade de visualizar e editar seus apps do Twitter existentes por meio do painel de apps do Twitter no developer.twitter.com, conforme estiverem logados em sua conta do Twitter.
2019 mudança: o formato histórico do PowerTrack mudou; três valores ficaram disponíveis: “name”, “description” e “location” para tweets históricos em lote. Além disso, foi lançada uma nova API de Atividades da Conta. A partir disso, os desenvolvedores passaram a ver se uma conta que menciona o usuário que você acompanha está bloqueada.
<strong>2020</strong> <strong>mudança</strong>: para tornar o Token de Acesso e o Segredo do Token de Acesso mais seguros, os desenvolvedores do Twitter não permitem vê-los no Painel após a primeira geração.
Documentação da API do Twitter
Antes de começar, confira a documentação definitiva Documentação. Você ficará familiarizado com todos os métodos que devem ser usados em todos os tipos de APIs. Além disso, o Twitter está ansioso para interagir com desenvolvedores. O Laboratório de Desenvolvedores do Twitter é excelente se você quiser moldar o futuro do aplicativo.
Perguntas Frequentes
E se eu tiver um erro: “Twitter API bad authentication data”?
O código deste erro é 215. Corresponde ao HTTP 400. O método requer autenticação, que não foi apresentada ou era inválida.
O que significa “Erro do servidor – aplicação não enviada”?
Esse erro ocorre se você não verifiou sua conta do Twitter. Acesse a aba Configurações no seu perfil, localize o campo de e-mail e siga as instruções.
E se minha aplicação do Twitter não for aprovada?
Infelizmente não é possível contestar essa decisão. Assim, você não poderá, por exemplo, criar outra solicitação ou app.
Onde posso encontrar todos os códigos de erro da API do Twitter?
Você pode encontrar uma tabela com todos os erros que ocorrem ao trabalhar com a API Padrão na página de Códigos de Resposta do Twitter.
Limite de taxa da API do Twitter excedido. O que isso significa e o que devo fazer?
Desenvolvedores de terceiros podem usar a API do Twitter em seus aplicativos, mas existem certos limites para isso. Por exemplo, você não pode fazer mais de 100 chamadas por hora. Após exceder o limite, você verá esta mensagem. Aguarde até o final de uma hora ou faça upgrade para o próximo plano de assinatura (Premium ou Enterprise).
Conclusão
Conseguir uma chave de API do Twitter não é um processo longo nem complicado. Embora possa ser um pouco desafiador para iniciantes: familiarize-se com a documentação, preços e limites.
Você pode começar a publicar tweets em questão de segundos usando apps prontos, como Twitter Feed da Elfsight. Não é necessária chave de API do Twitter nem habilidades de codificação.
