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.