Guía de Integración API Todo-en-Uno de Datos de Twitter con Zyla API Hub

Tu equipo necesita datos de redes sociales al estilo Twitter en una aplicación de Python esta semana: metadatos de perfil, a quién sigue un usuario y sus respuestas recientes. Al final de esta guía, podrás consultar todo eso utilizando la API Todo-en-Uno de Datos de Twitter en Zyla API Hub, analizar las respuestas en Python, e incluso integrarlo en un agente de IA a través de MCP si estás automatizando flujos de trabajo.

Lo que puedes construir con la API Todo-en-Uno de Datos de Twitter

La API Todo-en-Uno de Datos de Twitter devuelve datos estructurados de redes sociales para ayudarte a:

Obtener información adicional sobre un perfil público (verificación, URL del avatar, etiquetas, rest_id).
Listar las cuentas que sigue un usuario.
Recuperar las respuestas recientes del usuario (incluyendo IDs de tweets, marcas de tiempo, conteos de participación y entidades).

Esta API está disponible en Zyla API Hub y puede ser llamada con una sola clave API. Se adapta a paneles de control, tuberías de alertas, trabajos ETL, enriquecimiento de CRM y herramientas de moderación que dependen del contexto de redes sociales.

Comenzando en Zyla API Hub

Para llamar a los endpoints, abre la página de la API en Zyla: API Todo-en-Uno de Datos de Twitter. Haz clic en Suscribirse o Comenzar Prueba Gratis cuando esté disponible, y copia tu clave API.

Autenticación: añade Authorization: Bearer YOUR_API_KEY a cada solicitud.
Facturación: suscripción + cuota (no pago por llamada).
Acceso: la primera API generalmente ofrece una prueba de 7 días o 50 solicitudes. No hay Plan Gratuito. Consulta la página de la API para las opciones de acceso y precios actuales.

Si aún no tienes una cuenta, crea una aquí: Registrarse. Recibirás una clave única que funciona en todas las APIs suscritas en Zyla API Hub.

Autenticación y URL base

Todos los ejemplos a continuación utilizan el encabezado de Autenticación y URLs reales de Hub. Reemplaza YOUR_API_KEY con tu clave real de Zyla.

Encabezado: Authorization: Bearer YOUR_API_KEY
Patrón base: https://zylalabs.com/api/{marketplace_id}/{api-slug}/{endpoint_id}/{path}

Endpoints que utilizarás

A continuación se presentan las rutas disponibles en esta lista. Cada una requiere el parámetro de consulta screenname. No incluyas parámetros adicionales ni cuerpos de solicitud.

Acerca del perfil

Método: GET
URL: https://zylalabs.com/api/3399/twitter-data-all-in-one-api/22582/about-profile
Descripción: Devuelve la información adicional sobre el perfil.
Parámetros de consulta requeridos:
- screenname (cadena): p. ej., 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

{"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 normalmente utilizarás:

status: cadena de estado de la cuenta.
profile y name: identificador y nombre para mostrar.
rest_id e id: identificadores de usuario.
blue_verified: booleano para verificación.
avatar: URL de la imagen de perfil.
about.account_based_in y about.username_changes.count: metadatos del perfil útiles para cumplimiento y enriquecimiento.

Siguiendo

Método: GET
URL: https://zylalabs.com/api/3399/twitter-data-all-in-one-api/3679/following
Descripción: Obtiene la lista de cuentas que el usuario está siguiendo.
Parámetros de consulta requeridos:
- screenname (cadena): p. ej., 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

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

Aspectos destacados de los campos que normalmente utilizarás:

following: arreglo de cuentas, cada una con user_id, screen_name, name, description.
followers_count, friends_count, statuses_count, media_count: señales rápidas de tamaño para clasificación y filtros.
more_users: booleano que indica si existen más seguimientos más allá de esta respuesta.

Respuestas del usuario

Método: GET
URL: https://zylalabs.com/api/3399/twitter-data-all-in-one-api/3682/user-replies
Descripción: La lista de respuestas del usuario.
Parámetros de consulta requeridos:
- screenname (cadena): p. ej., 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"

La respuesta devuelve un arreglo de línea de tiempo de respuestas con campos como tweet_id, created_at, text, language, conteos de participación (favoritos, retweets, respuestas, citas), metadatos del autor y entidades. Las marcas de tiempo utilizan una cadena al estilo de Twitter como “Thu Dec 12 13:15:59 +0000 2024” (incluido el desplazamiento UTC), que puedes analizar en un datetime.

Inicio rápido en Python: obtener información del perfil y analizar campos

Este ejemplo mínimo llama a la ruta Acerca del perfil, verifica el estado HTTP y extrae campos clave que probablemente mapearás en el modelo de usuario de tu aplicación.

Python

import requests

API_KEY = "YOUR_API_KEY"
BASE_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(BASE_URL, params=params, headers=headers, timeout=30)
resp.raise_for_status()
data = resp.json()

# Extracción mínima de campos
profile = {
"status": data.get("status"),
"screenname": data.get("profile"),
"name": data.get("name"),
"rest_id": data.get("rest_id"),
"id": data.get("id"),
"blue_verified": data.get("blue_verified"),
"avatar": data.get("avatar"),
"account_based_in": (data.get("about") or {}).get("account_based_in"),
"username_change_count": ((data.get("about") or {}).get("username_changes") or {}).get("count"),
}

print(profile)

Consejos prácticos que ahorran tiempo

Encabezado de autenticación solamente: Todas las rutas mostradas requieren Authorization: Bearer YOUR_API_KEY. No añadas otros parámetros de autenticación.
Parámetro requerido: Cada endpoint aquí requiere screenname. Usa el nombre de clave exacto: screenname.
Marcas de tiempo: created_at en las respuestas del usuario incluye un desplazamiento UTC; estandariza a UTC al almacenar.
Paginación: La ruta Siguiendo incluye more_users. Si es verdadero, planifica para recuperaciones posteriores. Consulta la página de la API para cualquier detalle de paginación cuando esté disponible.
Cacheo: Los metadatos del perfil (p. ej., avatar, verificación) son relativamente estáticos. Almacena en caché las respuestas de Acerca del perfil y actualiza en un horario para reducir llamadas.
Manejo de errores: Trata los errores no 2xx como recuperables o errores visibles para el usuario dependiendo de tu SLA. Registra el JSON en bruto para observabilidad.
Cuotas: Zyla utiliza suscripción + cuota. Monitorea tu uso y mantén las llamadas clave idempotentes. Consulta la página de la API para los límites actuales.

Ejemplo de extremo a extremo: recuperar seguimientos y construir un índice

Esto describe una tubería simple para enriquecer tu CRM con señales del gráfico de seguimiento social:

Busca la cuenta con Acerca del perfil (almacena rest_id, name, blue_verified, avatar).
Llama a Siguiendo para obtener las cuentas que siguen (almacena user_id, screen_name, description).
Si more_users es verdadero, programa recuperaciones posteriores (los detalles de implementación dependen de la página de la API cuando esté disponible).
Expón un filtro en tu aplicación: “Mostrar contactos seguidos por @elonmusk” o “Clasificar contactos por conteos de seguidores.”

Cuando necesites confirmar la presencia pública y el estatus de un contacto, combina Acerca del perfil (verificación y etiquetas) y Siguiendo (anclas del gráfico social), luego opcionalmente recupera Respuestas del usuario para analizar la recencia de la participación y los temas.

Llamando a la API desde un agente de IA a través de MCP

Si automatizas tareas de datos sociales utilizando Claude Code, Cursor, Windsurf, o cualquier cliente compatible con MCP, puedes dirigir las llamadas a través del endpoint MCP de Zyla:

Endpoint: MCP
Autenticación para MCP: añade apikey=YOUR_API_KEY en la URL de MCP como se muestra.
Tu agente puede entonces invocar las mismas rutas de listado (p. ej., Acerca del perfil, Siguiendo, Respuestas del usuario) especificando las URLs de Hub y el encabezado de Autorización dentro de la configuración de la herramienta MCP, dependiendo de la configuración de tu cliente.

Mantén las descripciones de tus herramientas precisas y pasa solo el parámetro documentado screenname al construir solicitudes.

Flujos de trabajo y patrones comunes

Enriquecimiento de perfil al registrarse: En el primer inicio de sesión con un campo de identificador, llama a Acerca del perfil, almacena rest_id, URL del avatar, bandera blue_verified y país.
Descubrimiento de influencers: Usa Siguiendo para mapear a quién sigue una cuenta semilla. Clasifica por followers_count para acortar la lista de objetivos.
Diagnósticos de participación: Usa Respuestas del usuario para verificar la actividad reciente y los temas antes de lanzar respuestas de alcance o contenido.
Monitoreo: Programa extracciones periódicas para un puñado de cuentas VIP; compara rest_id y avatar para cambios que desencadenen alertas.

Notas de seguridad, implementación y observabilidad

Claves: Mantén YOUR_API_KEY en administradores de secretos o variables de entorno. Nunca comprometas credenciales.
Timeouts: En solicitudes de Python, establece un tiempo de espera finito (p. ej., 30s) e implementa una política de reintento corta en errores transitorios.
Registro: Registra la URL de la solicitud (sin credenciales), estado HTTP y las claves de nivel superior del JSON para un rápido triaje.
Backoff: Si te acercas a la cuota, reduce la frecuencia de sondeo y almacena resultados como Acerca del perfil para evitar llamadas redundantes.

Apéndice: Ejemplos adicionales de endpoints

A continuación se presentan ejemplos de cURL que puedes copiar y pegar para cada ruta disponible en esta lista, utilizando solo los parámetros requeridos.

Acerca del perfil (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"

Siguiendo (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"

Respuestas del usuario (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"

¿Dónde explorar a continuación?

Página de la API con consola en vivo y detalles: API Todo-en-Uno de Datos de Twitter
Página de inicio de Zyla API Hub para más listados de Redes Sociales: zylalabs.com

Preguntas Frecuentes

1) ¿Cómo autentico mis solicitudes?
Incluye el encabezado Authorization: Bearer YOUR_API_KEY en cada llamada a las URLs de Hub mostradas arriba.

2) ¿Qué parámetros son requeridos para estos endpoints?
Cada ruta en esta guía requiere el parámetro de consulta screenname. Usa solo screenname; no añadas parámetros adicionales ni cuerpos de solicitud.

3) ¿Las respuestas incluyen marcas de tiempo y conteos de participación?
Sí. La ruta Respuestas del usuario incluye created_at y conteos como favoritos, retweets, respuestas y citas. La marca de tiempo sigue una cadena al estilo de Twitter con un desplazamiento UTC.

4) ¿Cuál es el modelo de facturación?
Zyla opera con suscripción + cuota (no pago por llamada). Para esta API, la primera API generalmente ofrece una prueba de 7 días o 50 solicitudes y no tiene Plan Gratuito. Consulta la página de la API para las opciones de acceso y precios actuales.

5) ¿Puedo usar esta API en un agente de IA?
Sí. Usa el endpoint MCP en MCP con tu clave API y haz que tu agente llame a las mismas URLs de Hub con el encabezado de Autorización.

¿Listo para lanzar? Crea tu cuenta, obtén una clave API y comienza a integrar la API Todo-en-Uno de Datos de Twitter en Zyla API Hub hoy: Registrarse.