Trabalhando com Dados do Twitter API Tudo-em-Um

Sua equipe precisa de dados de perfil e atividade no estilo Twitter confiáveis esta semana—sem dança OAuth, sem scraping, apenas endpoints limpos que você pode enviar. Ao final deste guia, você saberá como buscar metadados de perfil, listas de seguidores e respostas recentes para qualquer nome de usuário público usando a API Tudo-em-Um de Dados do Twitter no Zyla API Hub, com exemplos prontos para rodar em curl e Python que você pode inserir em seu serviço.

O que você pode construir com esta API

A API Tudo-em-Um de Dados do Twitter expõe sinais sociais chave que os desenvolvedores normalmente precisam:

• Capturas de perfil: status da conta, verificação, avatar, contagens básicas e metadados.
• Listas de seguidores: quem um usuário segue, incluindo bios e contagens para classificação rápida.
• Linhas do tempo de respostas: respostas/retweets recentes com contadores de engajamento e contexto do autor.

Casos de uso típicos incluem enriquecimento de cadastro social, páginas de autor em aplicativos de conteúdo, painéis de monitoramento de marca e pipelines de análise leves—tudo isso sem gerenciar a superfície da web em mudança da rede social subjacente.

Começando no Zyla API Hub

A API Tudo-em-Um de Dados do Twitter está disponível no Zyla API Hub, que fornece uma conta, uma chave de API e um modelo de assinatura + cota em mais de 10.000 APIs públicas. Para obter uma chave de API:

1. Abra a listagem e inscreva-se: Comece o teste de 7 dias na API Tudo-em-Um de Dados do Twitter.
2. Copie sua chave de API do painel.
3. Envie solicitações com o cabeçalho Authorization: Bearer YOUR_API_KEY.

O acesso é baseado em assinatura (não pago por chamada). Verifique a página da API para opções de acesso e preços atuais. A primeira integração pode começar com um teste de 7 dias a partir da página de listagem.

Visão geral dos endpoints

Abaixo estão os endpoints documentados com métodos, URLs de solicitação exatas e parâmetros necessários. Todos os endpoints requerem o cabeçalho Authorization com sua chave.

1) Perfil

Retorna uma captura geral do perfil para um nome de usuário específico.

• Método: GET
• URL: https://zylalabs.com/api/3399/twitter-data-all-in-one-api/3673/profile
• Parâmetros de consulta necessários: screenname

Exemplo oficial (copie e cole como está):

curl -s -X GET "https://zylalabs.com/api/3399/twitter-data-all-in-one-api/3673/profile?screenname=elonmusk" \
-H "Authorization: Bearer YOUR_API_KEY"

Resposta JSON oficial (exemplo):

{
"status": "active",
"profile": "MikeCiesla",
"rest_id": "23880336",
"blue_verified": true,
"affiliates": [],
"business_account": [],
"avatar": "https://pbs.twimg.com/profile_images/1699329166234247168/G1W8YKJy_normal.jpg",
"header_image": "https://pbs.twimg.com/profile_banners/23880336/1695301088",
"desc": "Web3 at Google Cloud",
"name": "MikeCiesla",
"protected": null,
"location": "🦘🇦🇺",
"friends": 969,
"sub_count": 219,
"statuses_count": 48,
"media_count": 2,
"pinned_tweet_ids_str": [],
"created_at": "Thu Mar 12 02:45:15 +0000 2009",
"id": "23880336"
}

Anotações que você provavelmente usará:

• status indica o estado da conta.
• rest_id e id são identificadores de string para o usuário.
• blue_verified é um booleano que você pode exibir diretamente.
• avatar e header_image são URLs de imagem prontas para exibição.
• friends normalmente mapeia para a contagem de seguidores; media_count e statuses_count são úteis para classificar a atividade.
• created_at é uma string de timestamp; trate-a como UTC.

2) Sobre o perfil

Retorna informações adicionais sobre um perfil, incluindo contexto de verificação e metadados da conta.

• Método: GET
• URL: https://zylalabs.com/api/3399/twitter-data-all-in-one-api/22582/about-profile
• Parâmetros de consulta necessários: screenname

Exemplo de solicitação (copie e cole como está):

Exemplo de resposta:

Destaques:

• affiliates.label contém um distintivo e um link descritivo que você pode mostrar ao lado do perfil.
• verified_since é uma string; se você precisar exibi-la, trate-a como está, a menos que você a transforme posteriormente.
• os campos about ajudam a explicar a origem da conta, a precisão da localização e o nome de usuário afiliado.

3) Seguindo

Retorna a lista de contas que um usuário está seguindo.

• Método: GET
• URL: https://zylalabs.com/api/3399/twitter-data-all-in-one-api/3679/following
• Parâmetros de consulta necessários: screenname

Exemplo de solicitação (copie e cole como está):

Exemplo de resposta:

Dicas de implementação:

• Use followers_count e friends_count para pontuar influência ou filtrar contas barulhentas.
• more_users indica se a paginação está disponível para resultados adicionais; verifique este booleano para decidir se você precisa solicitar mais páginas (se a API expuser paginação em seu plano, consulte a documentação da listagem para detalhes).

4) Respostas do usuário

Retorna uma linha do tempo focada nas respostas de um usuário (e pode incluir retweets), com contadores de engajamento e dados de tweets referenciados.

• Método: GET
• URL: https://zylalabs.com/api/3399/twitter-data-all-in-one-api/3682/user-replies
• Parâmetros de consulta necessários: screenname

Exemplo de solicitação (copie e cole como está):

Exemplo de resposta (truncado aqui como fornecido):

{"timeline":[{"tweet_id":"1867196702865674450","bookmarks":0,"created_at":"Thu Dec 12 13:15:59 +0000 2024","favorites":0,"text":"RT @cb_doge: Every citizen journalist who fought the legacy media narrative and spread the truth this election is the Person of the Year.…","lang":"en","in_reply_to_status_id_str":null,"views":null,"quotes":0,"replies":0,"retweets":10,"conversation_id":"1867196702865674450","media":[],"entities":{"user_mentions":[{"id_str":"1389913567671975937","name":"DogeDesigner","screen_name":"cb_doge"}],"urls":[],"hashtags":[],"symbols":[]},"author":{"rest_id":"44196397","name":"Elon Musk","screen_name":"elonmusk","followers_count":207267106,"favourites_count":99802,"avatar":"https:\/\/pbs.twimg.com\/profile_images\/1858316737780781056\/kPL61o0F_normal.jpg","blue_verified":true},"retweeted":{"id":"1867196122143563838"},"retweeted_tweet":{"tweet_id":"1867196122143563838","bookmarks":0,"created_at":"Thu Dec 12 13:13:41 +0000 2024","favorites":119,"text":"Every citizen journalist who fought the legacy media narrative and spread the truth this election is the Person of the Year. \n\n https:\/\/t.co\/B8boPofzKx","lang":"en","quotes":2,"replies":60,"retweets":10,"conv…

O que observar:

• os campos created_at são strings de timestamp; normalize para UTC no armazenamento se você agregar.
• entities fornecem menções/hashtags para NLP ou linkificação a jusante.
• retweeted e retweeted_tweet fornecem contexto para renderizar retweets distintamente de respostas.

Autenticação

Cada solicitação deve incluir o cabeçalho:

Authorization: Bearer YOUR_API_KEY

A chave da API é emitida na assinatura da listagem do Zyla API Hub. Não coloque a chave em parâmetros de consulta.

Código copiável que você pode enviar

curl (exemplo oficial de perfil)

Python: buscar “Sobre o perfil” e ler verificação e distintivo afiliado

import requests

API_KEY = "YOUR_API_KEY"
BASE_URL = "https://zylalabs.com/api/3399/twitter-data-all-in-one-api/22582/about-profile"

def get_about_profile(screenname: str):
url = f"{BASE_URL}?screenname={screenname}"
resp = requests.get(url, headers={"Authorization": f"Bearer {API_KEY}"}, timeout=20)
resp.raise_for_status()
return resp.json()

if __name__ == "__main__":
data = get_about_profile("elonmusk")

# Campos principais que você provavelmente precisa
status = data.get("status")
rest_id = data.get("rest_id")
name = data.get("name")
blue_verified = data.get("blue_verified")
avatar = data.get("avatar")

# URL do distintivo afiliado opcional, se presente
affiliates = data.get("affiliates") or {}
label = (affiliates.get("label") or {})
badge = (label.get("badge") or {})
badge_url = badge.get("url")

print("status:", status)
print("rest_id:", rest_id)
print("name:", name)
print("blue_verified:", blue_verified)
print("avatar:", avatar)
print("affiliate_badge_url:", badge_url)

Este exemplo chama o endpoint Sobre o perfil para um único nome de usuário, extrai os identificadores e as flags de verificação, e acessa com segurança a URL do distintivo afiliado aninhado, se presente.

Notas de implementação prática

• Timestamps: os valores created_at são strings de timestamp. Trate como UTC para armazenamento e converta para horário local na UI conforme necessário.
• IDs: rest_id e id são strings—armazenar como texto para evitar problemas de precisão.
• Cache: perfis mudam com pouca frequência; um TTL de minutos a horas é comum. Linhas do tempo e listas de seguidores podem precisar de TTLs mais curtos, dependendo da sua UI.
• Paginando: a resposta de Seguindo inclui more_users para sinalizar que páginas adicionais podem estar disponíveis. Se verdadeiro, consulte a documentação da listagem em seu plano para uso de paginação.
• Tratamento de erros: trate respostas não-2xx como erros transitórios ou de permissão e registre a URL da solicitação e os IDs de correlação que sua aplicação usa. Tente novamente de forma conservadora para evitar limitação.
• Quotas: o acesso é por assinatura + cota (não pago por chamada). Verifique seu plano na listagem para limites de solicitações. Ao estar em teste, mantenha as solicitações direcionadas (por exemplo, agrupe nomes de usuários do lado do cliente e deduplica).

Padrões do mundo real que você pode implementar rapidamente

• Enriquecimento de perfil no cadastro: chame Perfil e depois Sobre o perfil para exibir avatar, nome, distintivo de verificação e localização nas páginas de usuário.
• Barra lateral da página do autor: busque Seguindo e destaque as principais contas por followers_count com dicas usando descrição e profile_image.
• Módulo de feed de respostas: use Respostas do usuário para mostrar as últimas respostas/retweets de um usuário, exibindo contadores (respostas, retweets, quotes) e entidades para menções.
• Banners de verificação: leia blue_verified e affiliates.label.badge para renderizar condicionalmente rótulos de verificação ou negócios.

Como chamar esta API de agentes de IA via MCP

Se você orquestra ferramentas de desenvolvedor ou agentes de codificação de IA, pode direcionar chamadas através do endpoint MCP da Zyla. Clientes compatíveis com MCP (por exemplo, Claude Code, Cursor, Windsurf) podem acessar APIs do marketplace usando sua mesma chave. Comece com a documentação aqui: MCP.

Fluxo de alto nível:

• Forneça o endpoint MCP e sua chave de API Zyla para seu cliente MCP.
• Do agente, invoque os endpoints específicos da API Tudo-em-Um de Dados do Twitter com o parâmetro de consulta necessário screenname e o cabeçalho Authorization.
• Analise o JSON exatamente como mostrado nos exemplos acima; os mesmos campos são retornados, independentemente de você chamar diretamente ou via MCP.

Listas de verificação de campos endpoint por endpoint

Perfil

• Identidade: id, rest_id, name, profile
• Exibição: avatar, header_image, desc, location
• Verificação: blue_verified
• Atividade: statuses_count, media_count, friends, sub_count, pinned_tweet_ids_str
• Ciclo de vida: created_at, status

Sobre o perfil

• Identidade: id, rest_id, name, profile
• Verificação e contexto: blue_verified, affiliates.label.badge.url, verified_since
• Sobre: account_based_in, location_accurate, affiliate_username, source, username_changes.count
• Exibição: avatar

Seguindo

• Entradas de usuário: user_id, screen_name, name, description
• Exibição: profile_image
• Contadores: followers_count, friends_count, statuses_count, media_count
• Dica de paginação: more_users

Respostas do usuário

• Entradas de tweet: tweet_id, text, created_at, lang, conversation_id
• Engajamento: favorites, replies, retweets, quotes, bookmarks, views
• Entidades: user_mentions, urls, hashtags, symbols
• Array de mídia para anexos
• Contexto: author, retweeted, retweeted_tweet

Testando sua integração passo a passo

1) Verificação de sanidade da autenticação

Execute o curl oficial de Perfil (acima). Se você receber JSON de volta, seu cabeçalho Authorization é válido.

2) Validar mapeamento de campos

Mapeie avatar, name, blue_verified em sua UI primeiro; confirme a renderização de texto e a lógica de fallback para campos ausentes como header_image ou desc.

3) Adicionar lista de seguindo

Busque Seguindo e exiba uma lista curta ordenada por followers_count. Use profile_image para avatares inline.

4) Adicionar linha do tempo de respostas

Renderize created_at em horário local, mostre retweets de forma diferente se retweeted e retweeted_tweet estiverem presentes.

5) Cache e observe

Aplique TTLs apropriados para seu recurso. Comece com 10–30 minutos para perfis e 1–5 minutos para linhas do tempo se você esperar carregamentos frequentes de página.

Segurança e operações

• Mantenha YOUR_API_KEY na configuração do lado do servidor ou segredos gerenciados, nunca no JavaScript do cliente.
• Registre URLs de solicitações (sem tokens) e códigos HTTP de resposta para triagem rápida.
• Reduza em respostas não-2xx consecutivas para evitar atingir limites do plano.
• Construa uma fila mínima de mensagens não entregues para postagens que falham no enriquecimento para que você possa tentar novamente mais tarde.

FAQ

Q: Qual cabeçalho eu uso para autenticação?
A: Authorization: Bearer YOUR_API_KEY.

Q: Eu preciso de OAuth por usuário?
A: Não. Você chama os endpoints do marketplace diretamente com sua chave de API Zyla e um nome de usuário.

Q: Como eu lido com paginação em Seguindo?
A: Verifique o booleano more_users. Se verdadeiro, consulte a documentação da listagem em seu plano sobre como buscar páginas adicionais.

Q: Em que fuso horário estão os timestamps created_at?
A: Trate created_at como strings de timestamp UTC e converta do lado do cliente conforme necessário.

Q: Existe um plano gratuito?
A: Não há plano gratuito. A API usa um modelo de assinatura + cota. Um teste de 7 dias está disponível a partir da listagem; verifique a página para opções atuais.

Pronto para integrar isso ao seu aplicativo? Inscreva-se e obtenha sua chave na listagem: Comece o teste de 7 dias na API Tudo-em-Um de Dados do Twitter. Construa com uma única chave em todo o marketplace da Zyla e envie sua integração de dados sociais esta semana.