Criando sua Conta de Desenvolvedor
A API do Twitter é uma ferramenta fornecida pelo próprio Twitter e permite o acesso em tempo real ao que está sendo produzido (tuitado) pelos usuários da rede social. Para acessá-la será necessário, primeiro, que você possua uma conta de desenvolvedor, para obtê-la é preciso que você realize uma solicitação clique aqui para seguir para página de solicitação.
Depois de conseguir seu acesso ao Portal de Desenvolvedor, você será apresentado a um painel como o abaixo.
Agora para ser capaz de se conectar a um endpoint da API, você precisará criar um projeto e um App
. Para isso, clique em Create New Project
e depois preencha as informações necessárias para a criação do projeto e de um App
dentro do projeto. Após preencher todo o formulário você será apresentado a uma tela com as chaves de autenticação da sua aplicação, essas são necessárias durante a conexão com a API.
Agora você tem todo o necessário para se conectar à API!
Conexão com a API
Para realizar a conexão com a API é possível utilizar diversas tecnologias distintas, mas usaremos Python juntamente com algumas de suas bibliotecas.
Primeiramente, sobre as bibliotecas que serão utilizadas, serão três: Python Requests, json e Python Decouple. A Python Requests será responsável por realizar as solicitações HTTP, a json ajudará a manipular as respostas obtidas para o formato .json e a biblioteca Python Decouple será usada para separar a autenticação do que está escrito no código.
Então, primeiramente, importaremos as bibliotecas necessárias.
from decouple import config
import requests
import json
Depois disso, é necessário que importemos o valor de autenticação para o código, para isso, criaremos, no mesmo diretório do nosso arquivo, um arquivo com o nome .env
e dentro dele adicionaremos a seguinte informação.
BEARERTOKEN=ValorDoSeuBearerToken
Após a criação do arquivo, já é possível utilizar o valor de autenticação do Bearer Token sem precisar colocar uma informação sigilosa junto ao código. Para isso, adicionaremos a seguinte linha de código no nosso arquivo .py
.
bearer_token = config('BEARERTOKEN')
Dentro da variável bearer_token
agora estará o valor de seu Bearer Token.
Agora, criaremos uma função que adiciona a autenticação no cabeçalho da solicitação HTTP que será realizada.
def set_autenticacao(objeto_para_auth):
"""
Método que acrescenta, no objeto da busca, um cabeçalho correspondente a autenticação do request.
"""
objeto_para_auth.headers["Authorization"] = f"Bearer {bearer_token}"
return objeto_para_auth
Após isso, já somos capazes de realizar o processo de solicitação para a API. Então, determinaremos os nossos parâmetros de busca e o endpoint da API que será utilizado.
search_url = "https://api.twitter.com/2/tweets/search/recent"
str_busca = f'to:{perfil} {chave_busca} lang:{lingua}'
query_params = {'query': str_aux,'tweet.fields': 'attachments,author_id,created_at,lang,public_metrics,source','max_results':limite_tweets}
No código superior, a variável search_url
recebe o endpoint que será usado (você pode ler um pouco mais sobre os endpoints disponíveis clicando aqui). Ademais, a variável str_busca recebe a string de busca que será aplicada, no caso do exemplo a busca será por tweets enviados para um perfil, contendo uma chave de busca e escritos em uma língua específica, outros filtros de busca podem ser vistos aqui. Já o query-params
, recebe a string de busca, os campos que estarão presentes nas respostas (veja mais opções clicando aqui) e o número de tweets retornados na busca.
Depois das definições, podemos realizar o request, para isso, usaremos os comandos abaixo.
"""
Abaixo realizamos o request que usa os parâmetros
search url para defnir o endpoint,
auth para determinar o nosso bearer token como autenticação baseado na função anterior
params que usa a string de parâmetros
"""
response = requests.get(search_url, auth=set_autenticacao, params=query_params)
# Testa se a resposta foi bem sucedida
if response.status_code != 200:
raise Exception(response.status_code, response.text)
# Converte a resposta para json
r = response.json()
# Imprime a resposta
print(json.dumps(r, indent=4, sort_keys=True))
Agora você pode ver seu os tweets obtidos baseados na sua busca!
O programa desenvolvido nesse tutorial está disponível no meu repositório do gitlab.
Top comments (0)