API de Dados do Twitter All-in-One no Zyla API Hub: Primeiro Pedido com curl e JSON

Você precisa implementar uma integração de mídia social esta semana que puxe detalhes confiáveis do perfil do Twitter/X, quem um usuário segue e as respostas recentes do usuário. Ao final deste guia, você fará um primeiro pedido funcional à API de Dados do Twitter All-in-One no Zyla API Hub com curl, inspecionará um payload JSON real e terá um pequeno trecho de Python que você pode inserir em seu serviço.

O que esta API entrega e por que os desenvolvedores a usam

A API de Dados do Twitter All-in-One expõe dados de mídia social que você pode integrar em painéis, enriquecimento de CRM, filas de moderação, scripts de pesquisa e trabalhos de análise. Ela fornece:

Informações “sobre” o perfil: status verificado, avatar, afiliações e metadados da conta.
Lista de seguidores: quem um usuário segue, com estatísticas básicas de perfil por conta.
Respostas do usuário: as respostas recentes do usuário, com contadores de tweet e contexto do autor.

Tudo está disponível por trás de uma única assinatura do Zyla API Hub e do cabeçalho de Autorização: Bearer YOUR_API_KEY, para que você evite lidar com vários provedores ou chaves. Navegue pela listagem do marketplace aqui: API de Dados do Twitter All-in-One. Você também pode explorar outras APIs de mídia social no Zyla API Hub quando estiver pronto para expandir a cobertura.

Começando no Zyla API Hub

Para chamar qualquer endpoint, você precisa de uma chave de API do Zyla API Hub:

Abra a página da API: API de Dados do Twitter All-in-One.
Clique em Inscrever-se (ou Começar Teste Grátis quando disponível), em seguida, gere sua chave de API.
Autentique-se com o cabeçalho Autorização: Bearer YOUR_API_KEY em cada solicitação.

A cobrança é por assinatura + cota (não por chamada). Para esta API, espere um teste de 7 dias ou 50 solicitações para o primeiro acesso. Não há Plano Gratuito. Sempre verifique a página da API para opções de acesso e preços atuais.

Autenticação e convenções de solicitação

Base: As solicitações vão para os URLs de endpoint do Hub listados abaixo (todos começam com https://zylalabs.com/api/... ).
Auth: Inclua Autorização: Bearer YOUR_API_KEY.
Parâmetros: Use apenas parâmetros documentados para cada endpoint; não adicione extras.
Respostas: JSON. Os timestamps usam o formato padrão do Twitter/X com offsets de fuso horário quando presentes.

Endpoint 1: Sobre o perfil

Retorna informações adicionais sobre um perfil. Útil para pesquisa de usuários, enriquecimento de contas ou exibição de estado verificado e afiliações comerciais.

Método: GET
URL: https://zylalabs.com/api/3399/twitter-data-all-in-one-api/22582/about-profile
Parâmetros obrigatórios: screenname=elonmusk

cURL

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

JSON (resposta de exemplo)

{"status":"active","profile":"elonmusk","rest_id":"44196397","blue_verified":true,"affiliates":{"label":{"badge":{"url":"https:\/\/pbs.twimg.com\/profile_images\/1955359038532653056\/OSHY3ewP_bigger.jpg"},"description":"X","url":{"url":"https:\/\/twitter.com\/X","urlType":"DeepLink"},"userLabelDisplayType":"Badge","userLabelType":"BusinessLabel"}},"business_account":null,"verified_since":"-156836000000000","avatar":"https:\/\/pbs.twimg.com\/profile_images\/2008546467615580160\/57KcqsTA_normal.jpg","name":"Elon Musk","protected":false,"about":{"account_based_in":"United States","location_accurate":false,"learn_more_url":"https:\/\/help.twitter.com\/managing-your-account\/about-twitter-verified-accounts","affiliate_username":"X","source":"United States App Store","username_changes":{"count":"0"}},"id":"44196397"}

Destaques de campo que você usará comumente:

status: status da API para a pesquisa.
profile e id/rest_id: identificadores estáveis para armazenar em seu DB.
blue_verified: booleano para exibição de badge e heurísticas de confiança.
avatar e name: renderizar cartões de usuário e placares.
affiliates.label: mostra uma relação comercial, incluindo um badge e uma URL de saída.
about.account_based_in e source: metadados para análises regionais ou de origem de loja.

Exemplo em Python: buscar Sobre o perfil e ler campos-chave

Este trecho chama o mesmo endpoint e analisa alguns campos que você provavelmente exibirá. Ajuste o tratamento de erros para seus padrões de produção.

import os
import requests

API_KEY = os.getenv("ZYLA_API_KEY", "YOUR_API_KEY")
url = "https://zylalabs.com/api/3399/twitter-data-all-in-one-api/22582/about-profile"
params = {"screenname": "elonmusk"}
headers = {"Authorization": f"Bearer {API_KEY}"}

resp = requests.get(url, headers=headers, params=params, timeout=20)
resp.raise_for_status()
data = resp.json()

user = {
"screenname": data.get("profile"),
"id": data.get("id"),
"name": data.get("name"),
"blue_verified": data.get("blue_verified"),
"avatar": data.get("avatar"),
"country": (data.get("about") or {}).get("account_based_in"),
}
print(user)

Endpoint 2: Seguindo

Obtenha a lista de contas que um usuário está seguindo, incluindo contagens que ajudam com pontuação, segmentação e ferramentas de descoberta.

Método: GET
URL: https://zylalabs.com/api/3399/twitter-data-all-in-one-api/3679/following
Parâmetros obrigatórios: screenname=elonmusk

cURL

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

JSON (resposta de exemplo)

{"following":[{"user_id":"1671483632551186433","screen_name":"TechMine_Mw","description":"Malawi’s premier SAAS firm 🌐 | Leaders in digital transformation, website development, design, and marketing 🖥️🎨 | Shaping Malawi’s tech future 🇲🇼","profile_image":"https:\/\/pbs.twimg.com\/profile_images\/1847661011731431425\/FNhbpOqP_normal.jpg","statuses_count":5,"followers_count":6,"friends_count":10,"media_count":3,"name":"TechMine INC."},{"user_id":"44196397","screen_name":"elonmusk","description":"","profile_image":"https:\/\/pbs.twimg.com\/profile_images\/1874558173962481664\/8HSTqIlD_normal.jpg","statuses_count":65409,"followers_count":210941749,"friends_count":926,"media_count":3038,"name":"Elon Musk"}],"status":"ok","more_users":false}

O que observar:

following: array de contas com user_id, screen_name, name e estatísticas leves (followers_count, friends_count, statuses_count, media_count).
more_users: flag booleano que indica se pode haver resultados adicionais além deste conjunto. A listagem aqui não define parâmetros de paginação; verifique a página da API para quaisquer atualizações se você precisar de uma travessia mais profunda.

Endpoint 3: Respostas do usuário

Recupere a lista de respostas de um usuário (incluindo retweets que a linha do tempo pode representar). Isso é útil para monitorar engajamento, construir feeds de atividade ou treinar classificadores leves.

Método: GET
URL: https://zylalabs.com/api/3399/twitter-data-all-in-one-api/3682/user-replies
Parâmetros obrigatórios: screenname=elonmusk

cURL

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

JSON (excerto da resposta de exemplo)

{"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…

Campos-chave para conectar:

tweet_id e conversation_id: correlacionar threads e deduplicar.
created_at: timestamp (UTC +0000 neste exemplo); converta para seu fuso horário preferido em sua UI.
text e lang: conteúdo e idioma para moderação ou indexação.
favorites, replies, retweets, quotes: contadores de engajamento.
author: objeto de usuário compacto com rest_id, screen_name, avatar e blue_verified.
retweeted e retweeted_tweet: se presentes, representam relações de retweet.

Notas de implementação prática (salve uma hora)

Cache: Os dados “sobre” do perfil mudam com menos frequência do que as linhas do tempo. Armazene em cache as respostas do perfil Sobre por minutos a horas; atualize listas de seguidores e respostas com mais frequência se sua UI for sensível ao tempo real.
Identificadores: Armazene tanto id/rest_id quanto screen_name. Nomes de usuários podem mudar; IDs numéricos são âncoras mais estáveis.
Timestamps: os valores created_at incluem informações de fuso horário na string. Normalize para UTC em seu backend para simplificar consultas e ordenações.
Consumo de taxa: Como o acesso é por assinatura + cota (não por chamada), centralize chamadas para evitar buscas duplicadas entre serviços.
Paginamento: Se more_users for verdadeiro nas respostas de Seguindo, planeje padrões de busca iterativos. Os parâmetros para paginação mais profunda não estão definidos na listagem mostrada aqui—monitore a página da API para atualizações antes de implementar a lógica de navegação por páginas.
Tratamento de erros: Trate respostas não-2xx como transitórias onde apropriado e tente novamente com backoff exponencial. Sempre registre a URL solicitada e o screenname para replicar problemas rapidamente.

Chame esta API de um agente de IA via MCP

Se você estiver usando um cliente compatível com MCP (como Claude Code, Cursor ou Windsurf), pode direcionar chamadas através do serviço MCP da Zyla. Aponte sua ferramenta para:

MCP

Forneça sua chave de API Zyla (parâmetro de consulta apikey no endpoint MCP). Seu agente pode então invocar a API de Dados do Twitter All-in-One via chamadas de ferramenta sem embutir lógica HTTP bruta. Mantenha o mesmo padrão de Autorização: Bearer YOUR_API_KEY ao configurar as chamadas de sua ferramenta.

Casos de uso comuns no mundo real

CRM e enriquecimento: Use o perfil Sobre para verificar afiliação comercial e status de badge antes de atribuir níveis de leads.
Descoberta de audiência: Puxe Seguindo para mapear interesses e identificar parceiros ou influenciadores potenciais seguidos pela sua conta-alvo.
Painéis de engajamento: Combine Respostas de Usuário com avatares e nomes de perfil para preencher widgets de feed ao vivo.
Filas de moderação: Filtre por lang e contadores de engajamento para priorizar interações de alta visibilidade para revisão.
Scripts de pesquisa: Capture Seguindo ou respostas recentes à noite para um data lake e analise a mudança ao longo do tempo.

De ponta a ponta: seu primeiro pedido e próximos passos

Comece com a pesquisa do perfil Sobre para validar sua chave e conectar os cabeçalhos. Em seguida, expanda para Seguindo e Respostas de Usuário com base nas necessidades do seu produto. Você terminará mais rápido se construir um pequeno CLI interno ou script que:

Aceita um screenname e o endpoint (about-profile, following, user-replies).
Chama a URL com Autorização: Bearer YOUR_API_KEY e registra JSON no disco.
Imprime os poucos campos que seu serviço consome (por exemplo, id, blue_verified, contagens).

Quando estiver pronto, inscreva-se na página da API: API de Dados do Twitter All-in-One. Explore mais integrações de mídia social em várias categorias no Zyla API Hub.

FAQ

Como faço para autenticar?
Inclua o cabeçalho HTTP Autorização: Bearer YOUR_API_KEY em cada solicitação para os URLs do Hub.

Há um plano gratuito?
Não há Plano Gratuito. Para esta API, espere um teste de 7 dias ou 50 solicitações quando você se inscrever pela primeira vez. Verifique a página da API para opções de acesso e preços atuais.

Preciso de mais parâmetros além de screenname?
Para os endpoints mostrados aqui, o único parâmetro obrigatório é screenname com um valor como elonmusk. Não adicione parâmetros extras.

Como faço para lidar com paginação para Seguindo?
A resposta inclui more_users para indicar se mais resultados podem existir. Os parâmetros de paginação não estão definidos na listagem mostrada aqui; consulte a página da API para atualizações antes de implementar buscas adicionais.

Posso chamar isso via um agente de codificação de IA?
Sim. Use o endpoint MCP da Zyla e sua chave de API Zyla para permitir que ferramentas compatíveis com MCP chamem a API de Dados do Twitter All-in-One como uma ferramenta.

Pronto para implementar? Crie sua conta Zyla, inscreva-se na API e obtenha sua chave agora: Registrar.