Necesitas obtener detalles de perfil de Twitter (X) en vivo, listas de seguimiento y las últimas respuestas de un usuario sin construir y mantener un scraper. Al final de esta guía, harás solicitudes autenticadas a la API Todo-en-Uno de datos de Twitter en Zyla API Hub para obtener un perfil, obtener metadatos "acerca de", listar a quién sigue un usuario y leer sus respuestas, listo para integrarlo en tus flujos de trabajo de redes sociales esta semana.
Qué hace esta API y cuándo usarla
La API Todo-en-Uno de datos de Twitter proporciona puntos finales estructurados para recuperar datos de Twitter (X) para una cuenta pública: perfil central, información adicional "acerca de", lista de seguimiento y respuestas del usuario. Los equipos la utilizan para:
- Flujos de incorporación que completan automáticamente biografías, avatares y nombres de usuarios de Twitter.
- Enriquecimiento de CRM/leads: almacenamiento de estado verificado y contexto de seguidores.
- Analítica de creadores: seguimiento de nuevos seguidores y actividad de respuestas.
- Moderación y monitoreo: escaneo de respuestas recientes de un usuario.
Se entrega a través de Zyla API Hub, que ofrece una sola cuenta, una clave API y un modelo de suscripción y cuota a través de más de 10,000 APIs públicas. La API Todo-en-Uno de datos de Twitter pertenece a la categoría de Redes Sociales y Networking, por lo que se integra fácilmente en los flujos de datos sociales.
Comenzando en Zyla API Hub
Abre la página de la API Todo-en-Uno de datos de Twitter en Zyla, haz clic en Suscribirse o Comenzar Prueba Gratuita, y obtén tu clave API. La primera API en una cuenta típicamente incluye una prueba de 7 días o 50 solicitudes; consulta la página del artículo para las opciones de acceso y precios actuales. Todas las solicitudes utilizan el encabezado Authorization: Bearer YOUR_API_KEY—no se necesitan tokens adicionales.
Comienza aquí: Comienza prueba de 7 días en la API Todo-en-Uno de datos de Twitter.
También puedes explorar el mercado más amplio en Zyla API Hub para integrar múltiples APIs en tu stack bajo una sola clave.
Autenticación y patrón de solicitud
Todos los puntos finales son solicitudes GET simples con el parámetro screenname cuando es necesario, y un token Bearer para autenticación:
- Encabezado: Authorization: Bearer YOUR_API_KEY
- Parámetro: screenname (cadena), por ejemplo, elonmusk
Copia los ejemplos de curl en esta guía tal como están, reemplaza YOUR_API_KEY con tu clave, y recibirás respuestas JSON de inmediato.
Puntos finales que usarás
1) Perfil
Obtiene un perfil central por usuario.
- Método: GET
- URL: https://zylalabs.com/api/3399/twitter-data-all-in-one-api/3673/profile
- Parámetros: screenname (requerido)
Ejemplo oficial:
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:
{
"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"
}Lo que realmente usarás:
- name, desc, avatar, header_image para mostrar en la interfaz de usuario.
- blue_verified para insignias de verificación.
- rest_id e id como identificadores estables en tu base de datos.
- created_at para la lógica de antigüedad de la cuenta.
2) Acerca del perfil
Devuelve metadatos adicionales sobre un perfil (afiliaciones, verificación, contexto "acerca de").
- Método: GET
- URL: https://zylalabs.com/api/3399/twitter-data-all-in-one-api/22582/about-profile
- Parámetros: screenname (requerido)
Ejemplo de solicitud:
Ejemplo de respuesta:
Esto es útil cuando necesitas "blue_verified", insignias de afiliación o el bloque "acerca de" para un contexto de usuario más rico. Almacena rest_id/id junto a tu registro de usuario interno para evitar re-resoluciones por screenname más adelante.
3) Siguiendo
Devuelve la lista de cuentas que sigue un usuario.
- Método: GET
- URL: https://zylalabs.com/api/3399/twitter-data-all-in-one-api/3679/following
- Parámetros: screenname (requerido)
Ejemplo de solicitud:
Ejemplo de respuesta:
Campos clave: user_id y screen_name para mapear relaciones; followers_count/friends_count para puntuaciones rápidas; more_users indica si hay más resultados disponibles de esta llamada. Al almacenar en caché, favorece user_id como la clave estable.
4) Respuestas de usuario
Obtiene la lista de respuestas del timeline de un usuario. Útil para la gestión de comunidades, monitoreo de influencers o construir características de "interacciones recientes".
- Método: GET
- URL: https://zylalabs.com/api/3399/twitter-data-all-in-one-api/3682/user-replies
- Parámetros: screenname (requerido)
Ejemplo de solicitud:
Ejemplo de respuesta (truncada por la fuente):
{"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…Los campos comúnmente utilizados incluyen tweet_id, created_at, text, retweets, replies y entities.user_mentions. El valor de created_at es una cadena de marca de tiempo; si lo persistes, conviértelo a tu formato de fecha y hora preferido al escribir.
Una solicitud que puedes enviar ahora
A continuación se muestra un ejemplo mínimo en Python para llamar al punto final Acerca del perfil y extraer algunos campos que normalmente consumirías en aplicaciones o flujos de trabajo:
import requests
API_KEY = "YOUR_API_KEY"
SCREENNAME = "elonmusk"
url = "https://zylalabs.com/api/3399/twitter-data-all-in-one-api/22582/about-profile"
params = {"screenname": SCREENNAME}
headers = {"Authorization": f"Bearer {API_KEY}"}
resp = requests.get(url, params=params, headers=headers, timeout=20)
resp.raise_for_status()
data = resp.json()
# Leer campos seleccionados de manera segura
rest_id = data.get("rest_id")
name = data.get("name")
blue_verified = data.get("blue_verified")
avatar = data.get("avatar")
about = data.get("about", {}) or {}
account_based_in = about.get("account_based_in")
affiliate_username = about.get("affiliate_username")
print({
"rest_id": rest_id,
"name": name,
"blue_verified": blue_verified,
"avatar": avatar,
"account_based_in": account_based_in,
"affiliate_username": affiliate_username
})Notas:
- Siempre pasa el encabezado de autorización exactamente como se muestra.
- Si almacenas respuestas en caché, guarda rest_id/id para una identidad estable a través de cambios de nombre.
- Para avatares e imágenes de encabezado, considera una política de actualización (por ejemplo, diaria) ya que las URL de medios pueden cambiar.
Detalles de implementación práctica que ahorran tiempo
- Autenticación: Todos los puntos finales requieren Authorization: Bearer YOUR_API_KEY. No agregues tokens adicionales o parámetros de autenticación de consulta.
- Superficie de parámetros: Solo screenname es requerido donde se muestra. No agregues parámetros no documentados.
- Marcas de tiempo: los campos created_at aparecen como cadenas al estilo de Twitter (por ejemplo, Thu Mar 12 02:45:15 +0000 2009). Normaliza a ISO-8601 al ingerir si tu backend lo espera.
- Identidad: Usa id/rest_id para deduplicación a través de puntos finales (perfil, acerca del perfil, respuestas).
- Paginación de seguimiento: La respuesta incluye more_users como un indicador booleano. La superficie de solicitud expuesta aquí no documenta parámetros de paginación; diseña tu sincronización en consecuencia.
- Almacenamiento en caché: Considera TTL cortos (por ejemplo, minutos a horas) en perfil y acerca del perfil, y bucles más ajustados para seguimiento/respuestas dependiendo de tus necesidades de frescura.
- Manejo de errores: Trata los errores no 2xx como condiciones recuperables o de alerta dependiendo de tu flujo de trabajo. Analiza JSON de manera defensiva ya que algunos objetos anidados pueden ser nulos o arreglos.
Casos de uso comunes
1) Inicio de sesión enriquecido con Twitter
En el primer inicio de sesión, llama a Perfil y Acerca del perfil para hidratar el registro del usuario con nombre, desc, avatar, blue_verified y afiliaciones. Renderiza una insignia verificada basada en blue_verified.
2) Prueba social en páginas de destino
Obtén followers_count y friends_count de los elementos de Siguiendo para cuentas destacadas que te interesan. Combina con avatar/nombre para pequeñas tarjetas de perfil en caché con marcas de tiempo "a partir de".
3) Tableros de creadores
Muestra las últimas respuestas del usuario de Respuestas de usuario con conteos para retweets, replies y quotes. Suma totales durante un día o semana y traza tendencias.
4) Enriquecimiento de CRM
Cuando un prospecto proporciona un usuario, llama a Acerca del perfil para confirmar verificación y etiquetas de afiliación. Almacena rest_id para futuras búsquedas incluso si cambian su screenname.
Llamando a la API desde un agente de IA a través de MCP
Puedes enrutar solicitudes a través del punto final del Protocolo de Contexto de Modelo (MCP) de Zyla en Claude Code, Cursor, Windsurf o cualquier cliente compatible con MCP. Dirige tu agente/herramienta al punto final de MCP e incluye tu clave API:
- Punto final: https://mcp.zylalabs.com/mcp?apikey=YOUR_API_KEY
Desde allí, tu agente puede invocar los mismos puntos finales de Hub documentados arriba. Esto es útil cuando deseas que tu entorno de codificación o agente autónomo obtenga datos de perfil de Twitter, listas de seguimiento o respuestas en línea durante el desarrollo. Para más información sobre el transporte MCP, consulta MCP.
Ejemplo de flujo de extremo a extremo
- Obtén el registro de perfil primario:
- Aumenta con información "acerca de" (verificación, insignia de afiliación):
- Recupera a quién está siguiendo el usuario (para prueba social o gráficos de red):
- Lista respuestas recientes para análisis de compromiso:
Persiste rest_id/id a través de llamadas para mantener tu modelo de datos normalizado. Para frontends, almacena en caché avatares e imágenes de encabezado con un TTL razonable y un CDN consciente de ETag cuando sea posible.
Lista de verificación de solución de problemas
- Errores 401/403: Asegúrate de que tu encabezado de autorización use Bearer YOUR_API_KEY y que tu suscripción en la página de la API esté activa.
- Arreglos vacíos o parciales: El usuario puede tener visibilidad limitada o puede que no haya datos recientes en esa categoría. Maneja estados vacíos de manera elegante.
- Nullabilidad de campos: Algunas propiedades (por ejemplo, business_account, affiliates) pueden ser nulas o arreglos vacíos. Escribe mapeadores seguros para nulos.
- Internacionalización: Los campos de texto y descripción son Unicode; asegúrate de que sea UTF-8 de extremo a extremo.
FAQ
Q1: ¿Qué encabezado es requerido para la autenticación?
Authorization: Bearer YOUR_API_KEY en cada solicitud.
Q2: ¿Cuál es el conjunto mínimo de parámetros?
Para los puntos finales mostrados, pasa screenname como un parámetro de consulta requerido (por ejemplo, screenname=elonmusk).
Q3: ¿Puedo paginar los resultados de Siguiendo?
La respuesta incluye more_users como un indicador booleano. Los parámetros de solicitud para paginación no están documentados aquí; consulta la página de la API para el comportamiento actual.
Q4: ¿Hay campos garantizados en todos los usuarios?
No todos los campos están garantizados. Algunos pueden ser nulos o ausentes dependiendo de la cuenta. Siempre verifica la existencia y maneja los nulos.
Q5: ¿Cómo lo llamo desde un asistente de codificación de IA?
Dirige tu cliente compatible con MCP a https://mcp.zylalabs.com/mcp?apikey=YOUR_API_KEY e invoca los mismos puntos finales de Hub. Consulta el enlace MCP en este artículo para más detalles.
¿Listo para integrar esto en tu stack? Crea una cuenta gratuita, obtén tu clave y comienza a construir con la prueba de 7 días desde la página del artículo: Comienza prueba de 7 días en la API Todo-en-Uno de datos de Twitter. Si estás integrando múltiples servicios, recuerda que puedes gestionarlos todos bajo una sola clave en Zyla API Hub.
