Trabajando con la API Todo-en-Uno de Datos de Twitter

Tu equipo necesita datos de perfil y actividad al estilo Twitter confiables esta semana—sin OAuth, sin scraping, solo puntos finales limpios que puedes enviar. Al final de esta guía, sabrás cómo obtener metadatos de perfil, listas de seguidores y respuestas recientes para cualquier nombre de pantalla público utilizando la API Todo-en-Uno de Datos de Twitter en Zyla API Hub, con ejemplos de curl y Python listos para usar que puedes integrar en tu servicio.

Lo que puedes construir con esta API

La API Todo-en-Uno de Datos de Twitter expone señales sociales clave que los desarrolladores suelen necesitar:

• Instantáneas de perfil: estado de la cuenta, verificación, avatar, conteos básicos y metadatos.
• Listas de seguidores: a quién sigue un usuario, incluyendo biografías y conteos para un ranking rápido.
• Cronologías de respuestas: respuestas/retweets recientes con contadores de participación y contexto del autor.

Los casos de uso típicos incluyen enriquecimiento de registro social, páginas de autores en aplicaciones de contenido, paneles de monitoreo de marcas y tuberías de análisis ligeras—todo sin gestionar la superficie web cambiante de la red social subyacente.

Comenzando en Zyla API Hub

La API Todo-en-Uno de Datos de Twitter está disponible en Zyla API Hub, que proporciona una cuenta, una clave de API y un modelo de suscripción + cuota a través de más de 10,000 APIs públicas. Para obtener una clave de API:

1. Abre la lista y suscríbete: Comienza prueba de 7 días en la API Todo-en-Uno de Datos de Twitter.
2. Copia tu clave de API desde el panel de control.
3. Envía solicitudes con el encabezado Authorization: Bearer YOUR_API_KEY.

El acceso es basado en suscripción (no pago por llamada). Consulta la página de la API para las opciones de acceso y precios actuales. La primera integración puede comenzar con una prueba de 7 días desde la página de listado.

Resumen de puntos finales

A continuación se presentan los puntos finales documentados con métodos, URLs de solicitud exactas y parámetros requeridos. Todos los puntos finales requieren el encabezado Authorization con tu clave.

1) Perfil

Devuelve una instantánea general del perfil para un nombre de pantalla dado.

• Método: GET
• URL: https://zylalabs.com/api/3399/twitter-data-all-in-one-api/3673/profile
• Parámetros de consulta requeridos: screenname

Ejemplo oficial (copia-pega tal cual):

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"

Respuesta JSON oficial (muestra):

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

Notas que probablemente usarás:

• status indica el estado de la cuenta.
• rest_id e id son identificadores de cadena para el usuario.
• blue_verified es un booleano que puedes mostrar directamente.
• avatar y header_image son URLs de imágenes listas para mostrar.
• friends típicamente se mapea al conteo de seguidores; media_count y statuses_count son útiles para clasificar la actividad.
• created_at es una cadena de marca de tiempo; trátala como UTC.

2) Acerca del perfil

Devuelve información adicional sobre un perfil, incluyendo contexto de verificación y metadatos de la cuenta.

• Método: GET
• URL: https://zylalabs.com/api/3399/twitter-data-all-in-one-api/22582/about-profile
• Parámetros de consulta requeridos: screenname

Ejemplo de solicitud (copia-pega tal cual):

Ejemplo de respuesta:

Aspectos destacados:

• affiliates.label contiene una insignia y un enlace descriptivo que puedes mostrar junto al perfil.
• verified_since es una cadena; si necesitas mostrarla, maneja tal cual a menos que la transformes más adelante.
• Los campos about ayudan a explicar el origen de la cuenta, la precisión de la ubicación y el nombre de usuario afiliado.

3) Siguiendo

Devuelve la lista de cuentas que un usuario está siguiendo.

• Método: GET
• URL: https://zylalabs.com/api/3399/twitter-data-all-in-one-api/3679/following
• Parámetros de consulta requeridos: screenname

Ejemplo de solicitud (copia-pega tal cual):

Ejemplo de respuesta:

Consejos de implementación:

• Usa followers_count y friends_count para puntuar influencia o filtrar cuentas ruidosas.
• more_users indica si hay paginación disponible para resultados adicionales; verifica este booleano para decidir si necesitas solicitar más páginas (si la API expone paginación en tu plan, consulta la documentación de listado para más detalles).

4) Respuestas de usuario

Devuelve una cronología centrada en las respuestas de un usuario (y puede incluir retweets), con contadores de participación y datos de tweets referenciados.

• Método: GET
• URL: https://zylalabs.com/api/3399/twitter-data-all-in-one-api/3682/user-replies
• Parámetros de consulta requeridos: screenname

Ejemplo de solicitud (copia-pega tal cual):

Ejemplo de respuesta (truncada aquí como se proporciona):

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

Qué observar:

• Los campos created_at son cadenas de marca de tiempo; normaliza a UTC en almacenamiento si agregas.
• entities proporcionan menciones/hashtags para NLP o linkificación posteriores.
• retweeted y retweeted_tweet te dan contexto para renderizar retweets de manera distinta a las respuestas.

Autenticación

Cada solicitud debe incluir el encabezado:

Authorization: Bearer YOUR_API_KEY

La clave de API se emite por suscripción desde la lista de Zyla API Hub. No pongas la clave en parámetros de consulta.

Código que puedes copiar y pegar

curl (ejemplo oficial de perfil)

Python: obtener “Acerca del perfil” y leer verificación e insignia de afiliado

import requests

API_KEY = "YOUR_API_KEY"
BASE_URL = "https://zylalabs.com/api/3399/twitter-data-all-in-one-api/22582/about-profile"

def get_about_profile(screenname: str):
url = f"{BASE_URL}?screenname={screenname}"
resp = requests.get(url, headers={"Authorization": f"Bearer {API_KEY}"}, timeout=20)
resp.raise_for_status()
return resp.json()

if __name__ == "__main__":
data = get_about_profile("elonmusk")

# Campos principales que probablemente necesites
status = data.get("status")
rest_id = data.get("rest_id")
name = data.get("name")
blue_verified = data.get("blue_verified")
avatar = data.get("avatar")

# URL de insignia de afiliado opcional si está presente
affiliates = data.get("affiliates") or {}
label = (affiliates.get("label") or {})
badge = (label.get("badge") or {})
badge_url = badge.get("url")

print("status:", status)
print("rest_id:", rest_id)
print("name:", name)
print("blue_verified:", blue_verified)
print("avatar:", avatar)
print("affiliate_badge_url:", badge_url)

Este ejemplo llama al punto final Acerca del perfil para un solo nombre de pantalla, extrae los identificadores y las banderas de verificación, y accede de manera segura a la URL de la insignia de afiliado anidada si está presente.

Notas de implementación práctica

• Marcas de tiempo: los valores created_at son cadenas de marca de tiempo. Trátalas como UTC para almacenamiento y conviértelas a la hora local en la interfaz de usuario según sea necesario.
• IDs: rest_id e id son cadenas—almacénalas como texto para evitar problemas de precisión.
• Cacheo: los perfiles cambian con poca frecuencia; un TTL de minutos a horas es común. Las cronologías y listas de seguidores pueden necesitar TTL más cortos dependiendo de tu interfaz de usuario.
• Paginación: la respuesta de Following incluye more_users para señalar que pueden estar disponibles más páginas. Si es verdadero, consulta la documentación de listado en tu plan para el uso de paginación.
• Manejo de errores: trata las respuestas no 2xx como errores transitorios o de permiso y registra la URL de solicitud y los IDs de correlación que usa tu aplicación. Reintenta de manera conservadora para evitar limitaciones.
• Cuotas: el acceso es por suscripción + cuota (no pago por llamada). Consulta tu plan en la lista para los límites de solicitudes. Cuando estés en prueba, mantén las solicitudes dirigidas (por ejemplo, agrupa nombres de pantalla del lado del cliente y elimina duplicados).

Patrones del mundo real que puedes implementar rápidamente

• Enriquecimiento de perfil al registrarse: llama a Perfil y luego a Acerca del perfil para mostrar avatar, nombre, insignia de verificación y ubicación en las páginas de usuario.
• Barra lateral de página de autor: obtiene Following y resalta las cuentas principales por followers_count con tooltips usando descripción y profile_image.
• Módulo de feed de respuestas: usa Respuestas de usuario para mostrar las últimas respuestas/retweets de un usuario, mostrando contadores (respuestas, retweets, citas) y entidades para menciones.
• Banners de verificación: lee blue_verified y affiliates.label.badge para renderizar condicionalmente etiquetas de verificación o negocio.

Cómo llamar a esta API desde agentes de IA a través de MCP

Si orquestas herramientas para desarrolladores o agentes de codificación de IA, puedes enrutar llamadas a través del punto final MCP de Zyla. Los clientes compatibles con MCP (por ejemplo, Claude Code, Cursor, Windsurf) pueden acceder a las APIs del mercado usando tu misma clave. Comienza con la documentación aquí: MCP.

Flujo de alto nivel:

• Proporciona el punto final MCP y tu clave de API de Zyla a tu cliente MCP.
• Desde el agente, invoca los puntos finales específicos de la API Todo-en-Uno de Datos de Twitter con el parámetro de consulta requerido screenname y el encabezado Authorization.
• Analiza el JSON exactamente como se muestra en los ejemplos anteriores; los mismos campos se devuelven ya sea que llames directamente o a través de MCP.

Listas de verificación de campos punto final por punto final

Perfil

• Identidad: id, rest_id, name, profile
• Visualización: avatar, header_image, desc, location
• Verificación: blue_verified
• Actividad: statuses_count, media_count, friends, sub_count, pinned_tweet_ids_str
• Ciclo de vida: created_at, status

Acerca del perfil

• Identidad: id, rest_id, name, profile
• Verificación y contexto: blue_verified, affiliates.label.badge.url, verified_since
• Acerca de: account_based_in, location_accurate, affiliate_username, source, username_changes.count
• Visualización: avatar

Siguiendo

• Entradas de usuario: user_id, screen_name, name, description
• Visualización: profile_image
• Contadores: followers_count, friends_count, statuses_count, media_count
• Sugerencia de paginación: more_users

Respuestas de usuario

• Entradas de tweet: tweet_id, text, created_at, lang, conversation_id
• Participación: favorites, replies, retweets, quotes, bookmarks, views
• Entidades: user_mentions, urls, hashtags, symbols
• Array de medios para adjuntos
• Contexto: author, retweeted, retweeted_tweet

Probando tu integración paso a paso

1) Verificación de autenticación

Ejecuta el curl oficial de Perfil (arriba). Si obtienes JSON de vuelta, tu encabezado de autorización es válido.

2) Validar mapeo de campos

Mapea avatar, name, blue_verified en tu interfaz de usuario primero; confirma la representación de texto y la lógica de respaldo para campos faltantes como header_image o desc.

3) Agregar lista de seguidores

Obtén Following y muestra una lista corta ordenada por followers_count. Usa profile_image para avatares en línea.

4) Agregar cronología de respuestas

Representa created_at en hora local, muestra retweets de manera diferente si retweeted y retweeted_tweet están presentes.

5) Cachear y observar

Aplica TTLs apropiados para tu función. Comienza con 10–30 minutos para perfiles y 1–5 minutos para cronologías si esperas cargas de página frecuentes.

Seguridad y operaciones

• Mantén YOUR_API_KEY en la configuración del lado del servidor o secretos gestionados, nunca en JavaScript del cliente.
• Registra las URLs de solicitud (sin tokens) y los códigos HTTP de respuesta para una rápida evaluación.
• Desacelera en respuestas no 2xx consecutivas para evitar alcanzar los límites del plan.
• Construye una cola mínima de cartas muertas para publicaciones que fallan en el enriquecimiento para que puedas reintentar más tarde.

FAQ

Q: ¿Qué encabezado debo usar para la autenticación?
A: Authorization: Bearer YOUR_API_KEY.

Q: ¿Necesito OAuth por usuario?
A: No. Llamas a los puntos finales del mercado directamente con tu clave de API de Zyla y un nombre de pantalla.

Q: ¿Cómo manejo la paginación en Following?
A: Verifica el booleano more_users. Si es verdadero, consulta la documentación de listado en tu plan sobre cómo obtener páginas adicionales.

Q: ¿En qué zona horaria están las marcas de tiempo created_at?
A: Trata created_at como cadenas de marca de tiempo UTC y conviértelas del lado del cliente según sea necesario.

Q: ¿Hay un plan gratuito?
A: No hay plan gratuito. La API utiliza un modelo de suscripción + cuota. Una prueba de 7 días está disponible desde la lista; consulta la página para las opciones actuales.

¿Listo para integrar esto en tu aplicación? Suscríbete y obtén tu clave en la lista: Comienza prueba de 7 días en la API Todo-en-Uno de Datos de Twitter. Construye con una sola clave a través del mercado de Zyla y envía tu integración de datos sociales esta semana.