API Todo-en-Uno de Datos de Twitter en Zyla API Hub: Primera Solicitud con curl y JSON

Necesitas implementar una integración de redes sociales esta semana que obtenga detalles confiables del perfil de Twitter/X, a quién sigue un usuario y las respuestas recientes del usuario. Al final de esta guía, realizarás una primera solicitud funcional a la API Todo-en-Uno de Datos de Twitter en Zyla API Hub con curl, inspeccionarás una carga útil JSON real y tendrás un pequeño fragmento de Python que podrás incluir en tu servicio.

Lo que esta API ofrece y por qué los desarrolladores la utilizan

La API Todo-en-Uno de Datos de Twitter expone datos de redes sociales que puedes integrar en paneles de control, enriquecimiento de CRM, colas de moderación, scripts de investigación y trabajos de análisis. Proporciona:

Información “acerca de” el perfil: estado verificado, avatar, afiliaciones y metadatos de la cuenta.
Lista de seguidores: a quién sigue un usuario, con estadísticas básicas del perfil por cuenta.
Respuestas del usuario: las respuestas recientes del usuario, con contadores a nivel de tweet y contexto del autor.

Todo está disponible detrás de una única suscripción a Zyla API Hub y el encabezado de autorización: Bearer YOUR_API_KEY, por lo que evitas manejar múltiples proveedores o claves. Navega por la lista del mercado aquí: API Todo-en-Uno de Datos de Twitter. También puedes explorar otras APIs de redes sociales en Zyla API Hub cuando estés listo para ampliar la cobertura.

Comenzando en Zyla API Hub

Para llamar a cualquier endpoint, necesitas una clave API de Zyla API Hub:

Abre la página de la API: API Todo-en-Uno de Datos de Twitter.
Haz clic en Suscribirse (o Iniciar Prueba Gratuita cuando esté disponible), luego genera tu clave API.
Autentica con el encabezado Authorization: Bearer YOUR_API_KEY en cada solicitud.

La facturación es suscripción + cuota (no pago por llamada). Para esta API, espera una prueba de 7 días o 50 solicitudes para el primer acceso. No hay Plan Gratuito. Siempre verifica la página de la API para las opciones de acceso y precios actuales.

Autenticación y convenciones de solicitud

Base: Las solicitudes van a las URL de los endpoints del Hub listadas a continuación (todas comienzan con https://zylalabs.com/api/... ).
Auth: Incluye Authorization: Bearer YOUR_API_KEY.
Parámetros: Usa solo los parámetros documentados para cada endpoint; no agregues extras.
Respuestas: JSON. Las marcas de tiempo utilizan el formato estándar de Twitter/X con desplazamientos de zona horaria cuando están presentes.

Endpoint 1: Acerca del perfil

Devuelve la información adicional sobre un perfil. Útil para la búsqueda de usuarios, enriquecimiento de cuentas o mostrar el estado verificado y las afiliaciones comerciales.

Método: GET
URL: https://zylalabs.com/api/3399/twitter-data-all-in-one-api/22582/about-profile
Parámetros requeridos: 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 (respuesta de muestra)

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

Aspectos destacados de los campos que comúnmente usarás:

status: estado de la API para la búsqueda.
profile e id/rest_id: identificadores estables para almacenar en tu base de datos.
blue_verified: booleano para la visualización de la insignia y heurísticas de confianza.
avatar y name: renderizar tarjetas de usuario y tablas de clasificación.
affiliates.label: muestra una relación comercial, incluyendo una insignia y una URL de salida.
about.account_based_in y source: metadatos para análisis regionales o de origen de tienda.

Ejemplo de Python: obtener Acerca del perfil y leer campos clave

Este fragmento llama al mismo endpoint y analiza algunos campos que probablemente mostrarás. Ajusta el manejo de errores a tus estándares de producción.

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: Siguiendo

Obtén la lista de cuentas que un usuario está siguiendo, incluyendo conteos que ayudan con la puntuación, segmentación y herramientas de descubrimiento.

Método: GET
URL: https://zylalabs.com/api/3399/twitter-data-all-in-one-api/3679/following
Parámetros requeridos: 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 (respuesta de muestra)

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

Lo que hay que tener en cuenta:

following: arreglo de cuentas con user_id, screen_name, name y estadísticas ligeras (followers_count, friends_count, statuses_count, media_count).
more_users: bandera boolean que indica si puede haber resultados adicionales más allá de este conjunto. La lista aquí no define parámetros de paginación; verifica la página de la API para cualquier actualización si necesitas una navegación más profunda.

Endpoint 3: Respuestas del usuario

Recupera la lista de respuestas de un usuario (incluyendo retweets que la línea de tiempo puede representar). Esto es útil para monitorear el compromiso, construir feeds de actividad o entrenar clasificadores ligeros.

Método: GET
URL: https://zylalabs.com/api/3399/twitter-data-all-in-one-api/3682/user-replies
Parámetros requeridos: 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 (extracto de respuesta de muestra)

{"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 clave para conectar:

tweet_id y conversation_id: correlacionar hilos y deduplicar.
created_at: marca de tiempo (UTC +0000 en este ejemplo); convierte a tu zona horaria preferida en tu interfaz de usuario.
text y lang: contenido y lenguaje para moderación o indexación.
favorites, replies, retweets, quotes: contadores de compromiso.
author: objeto de usuario compacto con rest_id, screen_name, avatar y blue_verified.
retweeted y retweeted_tweet: si están presentes, representan relaciones de retweet.

Notas de implementación práctica (ahórrate una hora)

Cacheo: Los datos “acerca de” del perfil cambian con menos frecuencia que las líneas de tiempo. Almacena en caché las respuestas de Acerca del perfil durante minutos a horas; actualiza las listas de seguidores y respuestas más a menudo si tu interfaz de usuario es sensible al tiempo real.
Identificadores: Almacena tanto id/rest_id como screen_name. Los nombres de usuario pueden cambiar; los ID numéricos son anclas más estables.
Marcas de tiempo: los valores created_at incluyen información de zona horaria en la cadena. Normaliza a UTC en tu backend para simplificar las consultas y ordenamientos.
Consumo de tasa: Dado que el acceso es suscripción + cuota (no pago por llamada), centraliza las llamadas para evitar búsquedas duplicadas en los servicios.
Paginación: Si more_users es verdadero en las respuestas de Siguiendo, planifica patrones de búsqueda iterativos. Los parámetros para una paginación más profunda no están definidos en la lista mostrada aquí; monitorea la página de la API para actualizaciones antes de implementar la lógica de navegación por páginas.
Manejo de errores: Trata las respuestas no 2xx como transitorias cuando sea apropiado y vuelve a intentar con retroceso exponencial. Siempre registra la URL solicitada y el screenname para replicar problemas rápidamente.

Llama a esta API desde un agente de IA a través de MCP

Si estás utilizando un cliente compatible con MCP (como Claude Code, Cursor o Windsurf), puedes enrutar llamadas a través del servicio MCP de Zyla. Apunta tu herramienta a:

MCP

Proporciona tu clave API de Zyla (parámetro de consulta apikey en el endpoint MCP). Tu agente puede entonces invocar la API Todo-en-Uno de Datos de Twitter a través de llamadas de herramienta sin incrustar lógica HTTP en bruto. Mantén el mismo patrón Authorization: Bearer YOUR_API_KEY al configurar las llamadas de tu herramienta.

Casos de uso comunes en el mundo real

CRM y enriquecimiento: Usa Acerca del perfil para verificar la afiliación comercial y el estado de la insignia antes de asignar niveles de leads.
Descubrimiento de audiencia: Obtén Seguidores para mapear intereses e identificar posibles socios o influencers seguidos por tu cuenta objetivo.
Paneles de compromiso: Combina Respuestas de usuario con avatares y nombres de perfil para poblar widgets de feed en vivo.
Colas de moderación: Filtra por lang y contadores de compromiso para priorizar interacciones de alta visibilidad para revisión.
Scripts de investigación: Captura Seguidores o respuestas recientes cada noche a un lago de datos y analiza el cambio a lo largo del tiempo.

De principio a fin: tu primera solicitud y próximos pasos

Comienza con la búsqueda de Acerca del perfil para validar tu clave y conectar encabezados. Luego expande a Seguidores y Respuestas de usuario según las necesidades de tu producto. Terminarás más rápido si construyes una pequeña CLI interna o script que:

Acepte un screenname y el endpoint (about-profile, following, user-replies).
Llame a la URL con Authorization: Bearer YOUR_API_KEY y registre JSON en disco.
Imprima los pocos campos que consume tu servicio (por ejemplo, id, blue_verified, counts).

Cuando estés listo, suscríbete en la página de la API: API Todo-en-Uno de Datos de Twitter. Explora más integraciones de redes sociales en diversas categorías en Zyla API Hub.

FAQ

¿Cómo me autentico?
Incluye el encabezado HTTP Authorization: Bearer YOUR_API_KEY en cada solicitud a las URL del Hub.

¿Hay un plan gratuito?
No hay Plan Gratuito. Para esta API, espera una prueba de 7 días o 50 solicitudes cuando te suscribas por primera vez. Verifica la página de la API para las opciones de acceso y precios actuales.

¿Necesito más parámetros que screenname?
Para los endpoints mostrados aquí, el único parámetro requerido es screenname con un valor como elonmusk. No agregues parámetros adicionales.

¿Cómo manejo la paginación para Seguidores?
La respuesta incluye more_users para indicar si pueden existir más resultados. Los parámetros de paginación no están definidos en la lista mostrada aquí; consulta la página de la API para actualizaciones antes de implementar búsquedas adicionales.

¿Puedo llamar a esto a través de un agente de codificación de IA?
Sí. Usa el endpoint MCP de Zyla y tu clave API de Zyla para habilitar herramientas compatibles con MCP para llamar a la API Todo-en-Uno de Datos de Twitter como una herramienta.

¿Listo para implementar? Crea tu cuenta de Zyla, suscríbete a la API y obtén tu clave ahora: Registrarse.