Você precisa de contexto confiável e atualizado sobre perfis do Twitter, gráficos de seguidores e linhas do tempo de respostas para um recurso que será lançado esta semana. Ao final deste guia, você será capaz de buscar o perfil de um usuário, metadados adicionais do perfil, quem eles seguem e suas respostas recentes usando a API All-in-One de Dados do Twitter no Zyla API Hub, com exemplos de curl e Python que você pode copiar e colar em seu serviço hoje.
O que esta API entrega
A API All-in-One de Dados do Twitter fornece acesso programático a pontos de dados públicos do Twitter (X) que você normalmente precisa em recursos sociais:
- Perfil: atributos principais da conta (nome, avatar, contagens, created_at).
- Sobre o perfil: metadados adicionais, como verificação azul, informações de rótulo de afiliado e contexto de localização.
- Seguindo: a lista de contas que um usuário segue com contagens de seguidores/amigos/mídia.
- Respostas do usuário: a linha do tempo de respostas recentes do usuário com métricas de engajamento em nível de tweet e entidades.
Esses endpoints alimentam casos de uso comuns em Mídias Sociais, como verificação de influenciadores, automação de comunidades, triagem de suporte ao cliente e painéis de análise.
Começando no Zyla API Hub
Abra a página da API e inscreva-se para obter sua chave. O Zyla API Hub usa um modelo de assinatura + cota (não é pay-per-call). Para uma primeira API, você pode iniciar um teste de 7 dias ou 50 solicitações—verifique a lista para as opções de acesso atuais. Uma vez inscrito, você receberá uma chave de API que funciona em todo o marketplace.
Iniciar teste de 7 dias na API All-in-One de Dados do Twitter
Autenticação
Envie sua chave no cabeçalho de Autorização em cada solicitação:
- Authorization: Bearer YOUR_API_KEY
Endpoints que você pode implementar esta semana
Perfil
Retorna os atributos principais 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âmetro de consulta obrigatório: screenname
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"
{
"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"
}
Os campos-chave que você provavelmente usará imediatamente: name, desc, avatar, header_image, blue_verified, counts (friends, sub_count, statuses_count, media_count), created_at (string no formato de data do Twitter), e id/rest_id para referência cruzada. Use protected para sinalizar contas restritas na lógica da sua interface.
Sobre o perfil
Retorna metadados adicionais sobre o perfil, como estado de verificação, rótulo de afiliado e atributos “sobre” em nível de conta.
- Método: GET
- URL: https://zylalabs.com/api/3399/twitter-data-all-in-one-api/22582/about-profile
- Parâmetro de consulta obrigatório: screenname
Use blue_verified e affiliates.label para exibir verificação ou afiliações comerciais. O objeto about inclui metadados de alto sinal, como account_based_in e username_changes.count para verificações de fraude e fluxos de integração. Trate verified_since como uma string, a menos que você a converta explicitamente.
Seguindo
Retorna a lista de contas que o usuário está seguindo, incluindo contagens essenciais para cada conta seguida.
- Método: GET
- URL: https://zylalabs.com/api/3399/twitter-data-all-in-one-api/3679/following
- Parâmetro de consulta obrigatório: screenname
Para recursos de crescimento e gráficos, itere sobre following para calcular sobreposições, exibir interesses mútuos ou preencher “seguimentos sugeridos”. Verifique more_users para saber se há páginas adicionais a serem buscadas ao construir interfaces paginadas.
Respostas do usuário
Retorna a linha do tempo de respostas recentes do usuário, incluindo métricas de engajamento de tweets e retweets referenciados, quando disponíveis.
- Método: GET
- URL: https://zylalabs.com/api/3399/twitter-data-all-in-one-api/3682/user-replies
- Parâmetro de consulta obrigatório: screenname
{"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…
Use text, created_at, contadores de engajamento (retweets, replies, favorites, quotes) e entities.user_mentions para alimentar moderação, painéis de respostas da comunidade ou priorizar filas de resposta. Quando presentes, retweeted e retweeted_tweet fornecem contexto para RTs que você pode precisar renderizar.
Exemplo em Python: buscar e normalizar um perfil
Este trecho chama o endpoint de Perfil, extrai campos-chave e mostra como lidar com booleanos e contagens. Substitua YOUR_API_KEY pelo seu token.
import requests
API_KEY = "YOUR_API_KEY"
BASE_URL = "https://zylalabs.com/api/3399/twitter-data-all-in-one-api/3673/profile"
def fetch_profile(screenname: str) -> dict:
resp = requests.get(
BASE_URL,
headers={"Authorization": f"Bearer {API_KEY}"},
params={"screenname": screenname},
timeout=20,
)
resp.raise_for_status()
data = resp.json()
# Normalize the fields your UI needs
return {
"id": data.get("id") or data.get("rest_id"),
"name": data.get("name"),
"username": data.get("profile"),
"avatar": data.get("avatar"),
"header_image": data.get("header_image"),
"bio": data.get("desc"),
"verified": bool(data.get("blue_verified")),
"friends": data.get("friends"),
"subscribers": data.get("sub_count"),
"statuses": data.get("statuses_count"),
"media": data.get("media_count"),
"created_at": data.get("created_at"),
"location": data.get("location"),
"protected": data.get("protected"),
}
if __name__ == "__main__":
profile = fetch_profile("elonmusk")
print(f"{profile['name']} (@{profile['username']}) — verified={profile['verified']}")
print(f"Tweets: {profile['statuses']}, Followers-like metric (subscribers): {profile['subscribers']}")
print(f"Avatar: {profile['avatar']}")
Notas de implementação prática
- Cabeçalho de autenticação: sempre inclua Authorization: Bearer YOUR_API_KEY.
- Carimbos de data/hora: created_at é uma string no estilo Twitter (por exemplo, Thu Mar 12 02:45:15 +0000 2009). Analise com cautela se você precisar do epoch UTC.
- Contadores: as contagens são inteiros; trate campos ausentes como None para evitar bugs de coerção.
- Booleanos: blue_verified e protected são booleanos quando presentes; alguns campos podem ser nulos se desconhecidos.
- Paginando: onde um campo como more_users está presente (endpoint Following), use-o para decidir se mais dados estão disponíveis. Se você precisar de paginação mais profunda, verifique a página da API para opções.
- Cache: perfil e sobre-perfil mudam com menos frequência; armazene em cache por minutos a horas, dependendo do seu SLA. Respostas atualizam rapidamente; armazene em cache de forma conservadora se precisar de frescor.
- Tratamento de erros: planeje para tentativas de rede e erros de decodificação JSON; não assuma que cada campo está sempre populado.
- Modelo de assinatura: Zyla usa assinatura + cota. Para sua primeira API, você pode iniciar um teste de 7 dias ou 50 solicitações—verifique os termos atuais na página da API antes de testar carga.
Casos de uso comuns em Mídias Sociais que você pode construir agora
- Descoberta de influenciadores: use Perfil e Sobre o perfil para classificar candidatos por verificação, atividade (statuses_count, media_count) e palavras-chave da biografia.
- Saúde da comunidade: acompanhe Seguindo para analisar interesses e clusters de rede; calcule seguidores compartilhados em uma coorte para sugerir comunidades de nicho.
- Triagem de suporte: puxe Respostas do Usuário para detectar menções não resolvidas e threads de alta urgência; priorize por contagens de respostas e quotes.
- Enriquecimento para CRM: anexe avatar, nome e status de verificação de Perfil/Sobre o perfil aos registros de usuários para melhor contexto de suporte.
- Filas de moderação de conteúdo: analise entidades e linguagem de Respostas do Usuário para direcionar itens aos revisores certos.
Chame a partir de agentes de IA via MCP
Você também pode acessar os mesmos endpoints do hub a partir de agentes de codificação de IA que falam o Protocolo de Contexto do Modelo. Aponte seu cliente compatível com MCP (Claude Code, Cursor, Windsurf, etc.) para o endpoint MCP e passe sua chave como um parâmetro de consulta.
Uma vez configurado, seu agente pode chamar os URLs de Perfil, Sobre o perfil, Seguindo e Respostas do Usuário mostrados acima com o cabeçalho de Autorização. Isso é útil para automações como “resumir as últimas cinco respostas para @username” ou “verificar o status de verificação azul da conta.”
Referências e exemplos de endpoints
Sobre o perfil (recapitulação)
GET https://zylalabs.com/api/3399/twitter-data-all-in-one-api/22582/about-profile?screenname=elonmusk
Retorna metadados adicionais do perfil, incluindo verificação, rótulos de afiliados e contexto de localização.
Seguindo (recapitulação)
GET https://zylalabs.com/api/3399/twitter-data-all-in-one-api/3679/following?screenname=elonmusk
Retorna uma lista de contas seguidas, cada uma com contagens e URLs de imagens de perfil. Use more_users para direcionar a lógica de paginação na sua interface.
Respostas do usuário (recapitulação)
GET https://zylalabs.com/api/3399/twitter-data-all-in-one-api/3682/user-replies?screenname=elonmusk
Retorna uma linha do tempo de respostas com métricas de engajamento e entidades para processamento posterior.
FAQ
Como faço para autenticar solicitações?
Inclua Authorization: Bearer YOUR_API_KEY no cabeçalho de cada solicitação que você faz para os URLs do hub.
Qual parâmetro é necessário para buscar dados do usuário?
Todos os endpoints mostrados aqui requerem o parâmetro de consulta screenname (por exemplo, screenname=elonmusk).
Há paginação?
Onde disponível, a resposta incluirá dicas como more_users (como no endpoint Seguindo). Para detalhes de paginação mais profundos ou cursores adicionais, verifique a página da API.
Quais são as opções de acesso atuais?
A Zyla usa um modelo de assinatura + cota. Para sua primeira API, você pode iniciar um teste de 7 dias ou 50 solicitações; veja a lista da API para os termos atuais.
Posso usar isso a partir de um agente de IA?
Sim. Configure seu cliente compatível com MCP para chamar os endpoints do hub, usando o endpoint MCP mencionado acima e sua chave de API.
Pronto para integrar isso em sua pilha de Mídias Sociais? Inscreva-se, obtenha sua chave e implemente sua integração usando os exemplos acima. O teste começa na página do item: Iniciar teste de 7 dias na API All-in-One de Dados do Twitter.