Você precisa extrair detalhes de perfil do Twitter (X) ao vivo, listas de seguidores e as últimas respostas de um usuário sem construir e manter um scraper. Ao final deste guia, você fará requisições autenticadas à API All-in-One de Dados do Twitter no Zyla API Hub para buscar um perfil, obter metadados "sobre", listar quem um usuário segue e ler suas respostas—pronto para integrar em seus fluxos de trabalho de mídia social esta semana.
O que esta API faz e quando usá-la
A API All-in-One de Dados do Twitter fornece endpoints estruturados para recuperar dados do Twitter (X) para uma conta pública: perfil principal, informações adicionais "sobre" o perfil, lista de seguidores e respostas do usuário. As equipes a utilizam para:
- Fluxos de integração que preenchem automaticamente biografias, avatares e nomes de usuários do Twitter.
- Enriquecimento de CRM/leads—armazenando status verificado e contexto de seguidores.
- Análise de criadores—monitorando novos seguidores e atividade de respostas.
- Moderação e monitoramento—analisando respostas recentes de um handle.
É entregue através do Zyla API Hub, que oferece uma única conta, uma chave de API e um modelo de assinatura e cota em mais de 10.000 APIs públicas. A API All-in-One de Dados do Twitter pertence à categoria de Mídia Social & Networking, portanto, se encaixa perfeitamente em pipelines de dados sociais.
Começando no Zyla API Hub
Abra a página da API All-in-One de Dados do Twitter no Zyla, clique em Assinar ou Começar Teste Gratuito e pegue sua chave de API. A primeira API em uma conta geralmente inclui um teste de 7 dias ou 50 requisições; verifique a página do item para opções de acesso e preços atuais. Todas as requisições usam o cabeçalho Authorization: Bearer YOUR_API_KEY—sem tokens extras necessários.
Comece aqui: Comece o teste de 7 dias na API All-in-One de Dados do Twitter.
Você também pode navegar pelo mercado mais amplo em Zyla API Hub para conectar várias APIs em sua pilha sob uma única chave.
Autenticação e padrão de requisição
Todos os endpoints são requisições GET simples com o parâmetro screenname quando necessário, e um token Bearer para autenticação:
- Cabeçalho: Authorization: Bearer YOUR_API_KEY
- Parâmetro: screenname (string), por exemplo, elonmusk
Copie os exemplos de curl neste guia como estão, substitua YOUR_API_KEY pela sua chave, e você receberá respostas JSON imediatamente.
Endpoints que você usará
1) Perfil
Busca um perfil principal pelo handle.
- Método: GET
- URL: https://zylalabs.com/api/3399/twitter-data-all-in-one-api/3673/profile
- Parâmetros: screenname (obrigatório)
Exemplo oficial:
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:
{
"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"
}O que você realmente usará:
- name, desc, avatar, header_image para exibição na interface.
- blue_verified para distintivos de verificação.
- rest_id e id como identificadores estáveis em seu banco de dados.
- created_at para lógica de idade da conta.
2) Sobre o perfil
Retorna metadados adicionais sobre um perfil (afiliações, verificação, contexto "sobre").
- Método: GET
- URL: https://zylalabs.com/api/3399/twitter-data-all-in-one-api/22582/about-profile
- Parâmetros: screenname (obrigatório)
Exemplo de requisição:
Exemplo de resposta:
Isso é útil quando você precisa de "blue_verified", distintivos de afiliação ou o bloco "sobre" para um contexto de usuário mais rico. Armazene rest_id/id ao lado do seu registro interno de usuário para evitar re-resolução pelo screenname mais tarde.
3) Seguindo
Retorna a lista de contas que um usuário segue.
- Método: GET
- URL: https://zylalabs.com/api/3399/twitter-data-all-in-one-api/3679/following
- Parâmetros: screenname (obrigatório)
Exemplo de requisição:
Exemplo de resposta:
Campos-chave: user_id e screen_name para mapear relacionamentos; followers_count/friends_count para pontuação rápida; more_users indica se mais resultados estão disponíveis a partir desta chamada. Ao armazenar em cache, prefira user_id como a chave estável.
4) Respostas do usuário
Obtém a lista de respostas do timeline de um usuário. Útil para gerenciamento de comunidade, monitoramento de influenciadores ou construção de recursos de "interações recentes".
- Método: GET
- URL: https://zylalabs.com/api/3399/twitter-data-all-in-one-api/3682/user-replies
- Parâmetros: screenname (obrigatório)
Exemplo de requisição:
Exemplo de resposta (truncada pela fonte):
{"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…Os campos comumente usados incluem tweet_id, created_at, text, retweets, replies e entities.user_mentions. O valor de created_at é uma string de timestamp; se você persistir, converta para seu formato de data e hora preferido ao gravar.
Uma requisição que você pode enviar agora
Abaixo está um exemplo mínimo em Python para chamar o endpoint Sobre o perfil e extrair alguns campos que você normalmente consumiria em aplicativos ou fluxos de trabalho:
import requests
API_KEY = "YOUR_API_KEY"
SCREENNAME = "elonmusk"
url = "https://zylalabs.com/api/3399/twitter-data-all-in-one-api/22582/about-profile"
params = {"screenname": SCREENNAME}
headers = {"Authorization": f"Bearer {API_KEY}"}
resp = requests.get(url, params=params, headers=headers, timeout=20)
resp.raise_for_status()
data = resp.json()
# Leia com segurança os campos selecionados
rest_id = data.get("rest_id")
name = data.get("name")
blue_verified = data.get("blue_verified")
avatar = data.get("avatar")
about = data.get("about", {}) or {}
account_based_in = about.get("account_based_in")
affiliate_username = about.get("affiliate_username")
print({
"rest_id": rest_id,
"name": name,
"blue_verified": blue_verified,
"avatar": avatar,
"account_based_in": account_based_in,
"affiliate_username": affiliate_username
})Notas:
- Sempre passe o cabeçalho Authorization exatamente como mostrado.
- Se você armazenar respostas em cache, armazene rest_id/id para identidade estável em renomeações.
- Para avatares e imagens de cabeçalho, considere uma política de atualização (por exemplo, diária) uma vez que URLs de mídia podem mudar.
Detalhes de implementação prática que economizam tempo
- Autenticação: Todos os endpoints requerem Authorization: Bearer YOUR_API_KEY. Não anexe tokens adicionais ou parâmetros de autenticação de consulta.
- Superfície de parâmetros: Apenas screenname é obrigatório onde mostrado. Não adicione parâmetros não documentados.
- Timestamps: campos created_at aparecem como strings no estilo Twitter (por exemplo, Thu Mar 12 02:45:15 +0000 2009). Normalize para ISO-8601 na ingestão se seu backend esperar isso.
- Identidade: Use id/rest_id para deduplicação entre endpoints (perfil, sobre-perfil, respostas).
- Paginação de seguindo: A resposta inclui more_users como um indicador booleano. A superfície de requisição exposta aqui não documenta parâmetros de paginação; projete sua sincronização de acordo.
- Cache: Considere TTLs curtos (por exemplo, minutos a horas) em perfil e sobre-perfil, e loops mais apertados para seguindo/respostas dependendo de suas necessidades de frescor.
- Tratamento de erros: Trate não-2xx como condições de re-tentativa ou alerta dependendo do seu fluxo de trabalho. Analise JSON defensivamente, uma vez que alguns objetos aninhados podem ser nulos ou arrays.
Casos de uso comuns
1) Login enriquecido com Twitter
No primeiro login, chame Perfil e Sobre o perfil para hidratar o registro do usuário com nome, desc, avatar, blue_verified e afiliações. Renderize um distintivo verificado com base em blue_verified.
2) Prova social em páginas de destino
Extraia followers_count e friends_count dos itens Seguindo para contas em destaque que você se importa. Combine com avatar/nome para pequenos cartões de perfil em cache com timestamps "a partir de".
3) Painéis de criadores
Exiba as últimas respostas do usuário de Respostas do usuário com contagens de retweets, respostas e citações. Some os totais ao longo de um dia ou semana e trace tendências.
4) Enriquecimento de CRM
Quando um prospecto fornecer um handle, chame Sobre o perfil para confirmar verificação e rótulos de afiliação. Armazene rest_id para futuras consultas, mesmo que eles mudem seu screenname.
Chamando a API de um agente de IA via MCP
Você pode direcionar requisições através do endpoint do Modelo de Contexto do Zyla (MCP) em Claude Code, Cursor, Windsurf, ou qualquer cliente compatível com MCP. Aponte seu agente/ferramenta para o endpoint MCP e inclua sua chave de API:
- Endpoint: https://mcp.zylalabs.com/mcp?apikey=YOUR_API_KEY
A partir daí, seu agente pode invocar os mesmos endpoints do Hub documentados acima. Isso é útil quando você deseja que seu ambiente de codificação ou agente autônomo busque dados de perfil do Twitter, listas de seguidores ou respostas em linha durante o desenvolvimento. Para mais informações sobre o transporte MCP, veja MCP.
Exemplo de fluxo de ponta a ponta
- Obtenha o registro de perfil primário:
- Aumente com informações "sobre" (verificação, distintivo de afiliação):
- Recupere quem o usuário está seguindo (para prova social ou gráficos de rede):
- Liste respostas recentes para análises de engajamento:
Persista rest_id/id entre chamadas para manter seu modelo de dados normalizado. Para frontends, armazene avatares e imagens de cabeçalho com um TTL razoável e um CDN ciente de ETag sempre que possível.
Lista de verificação de solução de problemas
- Erros 401/403: Certifique-se de que seu cabeçalho Authorization usa Bearer YOUR_API_KEY e que sua assinatura na página da API está ativa.
- Arrays vazios ou parciais: O usuário pode ter visibilidade limitada ou pode não haver dados recentes nessa categoria. Lide com estados vazios de forma elegante.
- Nullabilidade de campo: Algumas propriedades (por exemplo, business_account, affiliates) podem ser nulas ou arrays vazios. Escreva mapeadores seguros para nulos.
- Internacionalização: Campos de texto e descrição são Unicode; assegure-se de UTF-8 de ponta a ponta.
FAQ
Q1: Qual cabeçalho é necessário para autenticação?
Authorization: Bearer YOUR_API_KEY em cada requisição.
Q2: Qual é o conjunto mínimo de parâmetros?
Para os endpoints mostrados, passe screenname como um parâmetro de consulta obrigatório (por exemplo, screenname=elonmusk).
Q3: Posso paginar os resultados de Seguindo?
A resposta inclui more_users como um indicador booleano. Os parâmetros de requisição para paginação não estão documentados aqui; consulte a página da API para o comportamento atual.
Q4: Existem campos garantidos para todos os usuários?
Nem todos os campos são garantidos. Alguns podem ser nulos ou ausentes dependendo da conta. Sempre verifique a existência e trate nulos.
Q5: Como faço para chamá-lo de um assistente de codificação de IA?
Aponte seu cliente compatível com MCP para https://mcp.zylalabs.com/mcp?apikey=YOUR_API_KEY e invoque os mesmos endpoints do Hub. Veja o link MCP neste artigo para detalhes.
Pronto para integrar isso em sua pilha? Crie uma conta gratuita, obtenha sua chave e comece a construir com o teste de 7 dias a partir da página do item: Comece o teste de 7 dias na API All-in-One de Dados do Twitter. Se você estiver integrando vários serviços, lembre-se de que pode gerenciá-los todos sob uma única chave no Zyla API Hub.
