Você precisa entregar uma visualização de linha do tempo "semelhante a listas" esta semana—mostrar o perfil de um usuário, puxar um feed de respostas limpo e enriquecer com quem eles seguem. Ao final deste artigo, você saberá os endpoints exatos a serem chamados na API All-in-One de Dados do Twitter do Zyla para buscar um perfil de usuário, recuperar sua linha do tempo de respostas e enumerar quem eles seguem—o suficiente para renderizar um componente de linha do tempo compacto e amigável em seu aplicativo.
O que esta API entrega e quando usá-la
A API All-in-One de Dados do Twitter retorna dados estruturados para contas públicas do Twitter. Com os endpoints cobertos aqui, você pode:
- Resolver um perfil pelo nome de usuário, incluindo status, avatar, imagem de cabeçalho e contagens.
- Recuperar metadados detalhados de "sobre o perfil", como verificação, rótulo de afiliado e informações de origem.
- Listar as contas que um usuário segue para gerar feeds baseados em pessoas.
- Buscar a linha do tempo de respostas do usuário (um substituto prático para uma "linha do tempo de listas" quando você deseja conteúdo focado e conversacional).
Esses elementos são comumente usados para alimentar cartões de usuário, visualizações detalhadas e painéis de linha do tempo em dashboards, barras laterais de CRM, ferramentas de pesquisa e consoles de monitoramento interno.
Começando no Zyla API Hub
O Zyla API Hub centraliza mais de 10.000 APIs públicas por trás de uma conta, uma chave e um modelo de assinatura. Abra a página da API, inscreva-se e use sua chave nos endpoints listados.
- Abra o Zyla API Hub e encontre a página da API All-in-One de Dados do Twitter (link no CTA abaixo). O catálogo do Zyla é navegável em zylalabs.com.
- Clique em Inscrever-se (ou Começar Teste Grátis quando disponível) para gerar sua chave da API.
- Envie solicitações com Authorization: Bearer YOUR_API_KEY para as URLs do Hub abaixo.
A cobrança é por assinatura + cota (não por chamada). Para a primeira API, você pode esperar um teste de 7 dias ou 50 solicitações—verifique a página da API para opções de acesso e preços atuais. Não há Plano Gratuito.
Endpoints que você usará
Abaixo estão as URLs do Hub documentadas publicamente, métodos HTTP e os parâmetros necessários exatamente como fornecidos. Todas as solicitações usam o cabeçalho Authorization: Bearer YOUR_API_KEY. Não adicione parâmetros extras.
1) Perfil
- Método: GET
- URL: https://zylalabs.com/api/3399/twitter-data-all-in-one-api/3673/profile
- Parâmetro de consulta obrigatório: screenname (string)
- Propósito: Retorna dados principais do perfil (status, avatar, imagem de cabeçalho, contagens e metadados).
Exemplo oficial (copie verbatim):
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ê provavelmente usará imediatamente:
- status: status da conta no momento da busca.
- rest_id e id: identificadores internos que você pode armazenar para junções.
- avatar, header_image, name, desc, location: para renderizar cartões de perfil.
- friends, sub_count, statuses_count, media_count: estatísticas para emblemas/contadores.
- created_at: um timestamp semelhante ao RFC822 com offset UTC (+0000).
2) Sobre o perfil
- 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 (string)
- Propósito: Retorna metadados adicionais de verificação, afiliação e "sobre" para o perfil.
Este endpoint é útil quando você precisa de informações de verificação/emblema e detalhes de origem para complementar a resposta principal do perfil.
3) Seguindo
- Método: GET
- URL: https://zylalabs.com/api/3399/twitter-data-all-in-one-api/3679/following
- Parâmetro de consulta obrigatório: screenname (string)
- Propósito: Retorna a lista de contas que o usuário está seguindo, com contagens chave e informações de perfil.
Use isso para construir seções de "pessoas para seguir", ajustar sua linha do tempo para contas seguidas ou criar listas permitidas para filtrar um feed de respostas.
4) Respostas do usuário
- 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 (string)
- Propósito: Retorna uma lista das respostas do usuário (uma linha do tempo focada e rica em conversas).
Para desenvolvedores que buscam entregar uma experiência de "linha do tempo de listas" centrada em discussões seletivas em vez de um fluxo completo, uma linha do tempo de respostas é uma alternativa prática: um feed menor e mais relevante para embutir ao lado de análises, tickets de suporte ou registros de CRM.
Uma solicitação funcional que você pode executar agora
Aqui está a busca oficial do perfil que você pode colar em seu terminal. Ela usa o endpoint de Perfil e o cabeçalho de Autorização:
Exemplo em Python: renderizar um cartão de perfil compacto
Este trecho de Python chama o mesmo endpoint de Perfil, lê os campos que você realmente renderiza e imprime um resumo que você pode colocar em logs ou templates.
import os
import requests
API_KEY = os.getenv("ZYLALABS_API_KEY", "YOUR_API_KEY")
SCREENNAME = "elonmusk"
URL = "https://zylalabs.com/api/3399/twitter-data-all-in-one-api/3673/profile"
resp = requests.get(
URL,
params={"screenname": SCREENNAME},
headers={"Authorization": f"Bearer {API_KEY}"}
)
resp.raise_for_status()
data = resp.json()
card = {
"status": data.get("status"),
"id": data.get("id"),
"rest_id": data.get("rest_id"),
"name": data.get("name"),
"handle": data.get("profile"),
"avatar": data.get("avatar"),
"header_image": data.get("header_image"),
"desc": data.get("desc"),
"location": data.get("location"),
"counts": {
"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")
}
print("Cartão de perfil:")
for k, v in card.items():
print(f"- {k}: {v}")Entendendo as respostas que você irá analisar
Sobre o perfil
Quando você chama Sobre o perfil com um nome de usuário, você receberá metadados detalhados incluindo verificação, afiliados e a seção "sobre". Exemplo exato:
Campos que você usará:
- blue_verified: booleano para renderização de emblema.
- affiliates.label.badge.url e affiliates.label.description: mostrar um emblema de organização ao lado do nome.
- about.account_based_in, about.source: dicas contextuais sobre as origens do perfil.
Seguindo
O endpoint Seguindo retorna um array de objetos de usuário leves que o perfil segue. Exemplo exato:
Campos a serem observados:
- following: array de contas com contagens adequadas para chips/cartões.
- more_users: se verdadeiro, você deve planejar para paginação ou buscas subsequentes.
Respostas do usuário
O endpoint Respostas do usuário retorna uma linha do tempo centrada na conversa para o usuário. Exemplo exato (truncado conforme 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.
https:\/\/t.co\/B8boPofzKx","lang":"en","quotes":2,"replies":60,"retweets":10,"conv…Notas de implementação:
- created_at é um timestamp semelhante ao RFC822 com offset UTC (+0000). Normalize para UTC ou ISO 8601 em sua camada de serviço, se necessário.
- entities contêm objetos padrão de URL, menção e hashtag para autolink.
- retweeted e retweeted_tweet aparecem quando o item é um retweet; verifique tanto o texto quanto os objetos aninhados para renderizar de forma consistente.
Como compor uma "linha do tempo de listas" a partir desses elementos
Embora nenhum endpoint dedicado de "linha do tempo de listas" esteja documentado aqui, você pode montar um feed focado e semelhante a uma lista combinando o seguinte:
- Buscar Seguindo para construir um conjunto de contas de interesse para seu usuário.
- Buscar Respostas do usuário para destacar itens conversacionais desse usuário—frequentemente o sinal mais relevante para monitoramento.
- Juntar com Perfil/Sobre o perfil para emblemas e contexto (blue_verified, emblema de afiliado) para renderizar detalhes de confiança e origem inline.
Essa abordagem é prática para dashboards onde você deseja uma visualização compacta e centrada na discussão em vez de uma linha do tempo completa. Armazene em cache os resultados de perfil e seguindo por vários minutos para evitar buscas repetidas de metadados; mantenha a busca de respostas atualizada se você exibir atividade quase em tempo real.
Notas de produção que economizam tempo
- Auth: Cada solicitação deve incluir Authorization: Bearer YOUR_API_KEY.
- Tratamento de tempo: campos created_at incluem um offset +0000—trate como UTC. Converta uma vez no momento da busca e armazene como um datetime em seu DB.
- Paginamento: Se more_users aparecer em Seguindo, planeje buscas de acompanhamento. Se um endpoint de linha do tempo indicar truncamento em sua UI, adicione um "Carregar mais" mesmo que não esteja mostrado no trecho.
- Cache: Perfil e Sobre o perfil mudam com menos frequência. Armazene-os em cache separadamente de respostas ou outras linhas do tempo.
- Quotas: O Hub usa assinatura + cota. Para a primeira API, espere um teste de 7 dias ou 50 solicitações; não codifique limites—verifique a página do item.
Chame essas APIs de um agente de IA via MCP
Se você está conectando isso a um agente de codificação de IA (Claude Code, Cursor, Windsurf ou qualquer cliente compatível com MCP), aponte-o para o endpoint MCP e passe sua chave Zyla na URL:
https://mcp.zylalabs.com/mcp?apikey=YOUR_API_KEYUse a configuração MCP do seu agente para expor ferramentas HTTP e direcionar chamadas para as URLs do Hub neste artigo. Para referência, veja MCP. Isso permite que um agente leia perfis, busque respostas e itere sobre transformações sem que você escreva manualmente cada solicitação.
Referência de endpoint: URLs de solicitação exatas e parâmetros
- GET https://zylalabs.com/api/3399/twitter-data-all-in-one-api/3673/profile
- Params: screenname (string, obrigatório)
- GET https://zylalabs.com/api/3399/twitter-data-all-in-one-api/22582/about-profile
- Params: screenname (string, obrigatório)
- GET https://zylalabs.com/api/3399/twitter-data-all-in-one-api/3679/following
- Params: screenname (string, obrigatório)
- GET https://zylalabs.com/api/3399/twitter-data-all-in-one-api/3682/user-replies
- Params: screenname (string, obrigatório)
Juntando tudo: fluxo mínimo para um painel "semelhante a listas"
- No carregamento do perfil: chame Perfil (para avatar, contagens) e Sobre o perfil (para verificado e emblema de afiliado).
- Prefetch Seguindo e armazene em cache por intervalos curtos (por exemplo, 10–30 minutos) para alimentar chips de filtro ou listas de pessoas.
- Renderize Respostas do usuário em um painel de rolagem. Use entities para autolink menções e URLs. Se você detectar retweeted_tweet, exiba o texto aninhado e as contagens.
- Armazene rest_id/id para junções para que você não dependa de mudanças de nome de usuário.
Você pode sempre voltar ao catálogo do Zyla API Hub para adicionar mais capacidades a esta visualização mais tarde; uma conta e uma chave cobrem o mercado em zylalabs.com.
FAQ
Como eu me autentico?
Envie o cabeçalho Authorization: Bearer YOUR_API_KEY com cada solicitação para as URLs do Hub mostradas acima.
Qual formato de timestamp as respostas usam?
created_at é uma string semelhante ao RFC822 incluindo um offset UTC (por exemplo, Thu Dec 12 13:15:59 +0000 2024). Normalize para UTC ou ISO 8601 antes do armazenamento.
Há um endpoint dedicado de "linha do tempo de listas"?
Não nos endpoints listados aqui. Você pode aproximar uma visualização estilo listas combinando Seguindo com Respostas do usuário e enriquecendo com metadados de Perfil/Sobre o perfil.
Quais são as quotas e preços atuais?
O Zyla usa assinatura + cota (não por chamada). Para a primeira API, espere um teste de 7 dias ou 50 solicitações. Verifique a página da API para opções de acesso e preços atuais.
Posso chamar esses endpoints de um agente de IA?
Sim. Use o endpoint MCP https://mcp.zylalabs.com/mcp?apikey=YOUR_API_KEY em seu cliente compatível com MCP e direcione solicitações para as URLs do Hub a partir das chamadas de ferramentas do agente.
Comece o teste de 7 dias na API All-in-One de Dados do Twitter para obter sua chave e implementar sua integração de linha do tempo. Uma conta, uma chave, milhares de APIs no Zyla.
