Consejo: las 100 solicitudes gratuitas, sin tarjeta ni caducidad, permiten probar estos patrones y medir el consumo real antes de elegir un plan.
Configuración de los ejemplos
Los ejemplos de Python utilizanrequests (python -m pip install requests) y se ejecutan en tu backend. Sustituye la clave y los IDs de ejemplo. search_results representa una lista de publicaciones de una solicitud anterior.
Principio 1: Las publicaciones ya incluyen datos del usuario
Todos los endpoints de publicaciones, como/search-tweets, /user-tweets, /list-tweets, /comments, /quotes y /mentions, incluyen el perfil completo del autor dentro de cada objeto.
user contiene los mismos datos que una consulta a /info: ID, nombres, biografía, seguidores, cuentas seguidas, publicaciones, verificación, ubicación, creación, imagen y más.
Aplicación práctica: si buscas publicaciones sobre un tema para crear una lista de autores, no necesitas llamar a /info por cada uno. Extrae los datos de la respuesta:
Principio 2: Utiliza endpoints por lotes
Las variantes por lotes de las consultas habituales reducen considerablemente las llamadas./info-batch en lugar de repetir /info
Obtén hasta 100 perfiles a la vez:
/tweet-info-bulk en lugar de repetir /tweet-info
Si tienes IDs procedentes de un archivo, exportación o marcadores, consulta sus métricas actuales y autores en lotes de hasta 100:
Principio 3: Utiliza /list-tweets para varias cuentas
Agrupa cuentas en una lista de X y consulta su actividad reciente combinada con una llamada, en lugar de consultar cada cuenta.
Principio 4: Utiliza /info para resolver perfiles
/info acepta nombre, ID o enlace de perfil y devuelve el perfil completo con el ID permanente. Es una opción flexible para normalizar entradas mixtas.
Si necesitas perfiles completos, llama una vez por cuenta a /info, en lugar de convertir con /username-to-id o /link-to-id y después consultar el perfil:
id sin otra solicitud. Consulta Conversión de IDs.
Principio 5: Elimina duplicados en la base de datos
El mismo usuario aparecerá en búsquedas, seguidores, menciones y cronologías. Utiliza su ID permanente como clave y actualiza registros existentes en lugar de insertar duplicados.Principio 6: No vuelvas a consultar datos que ya tienes
En flujos de varios pasos, transmite los datos de un paso al siguiente. Geografía de audiencias. Primero obtienes seguidores y después consultas/about para cada uno. Ya tienes su perfil completo: no vuelvas a llamar a /info. Solo necesitas /about para el país, que no está en el perfil estándar. Consulta Geografía de la audiencia.
Verificación de campañas. Si /check-comment devuelve commented: true, incluye el comentario completo. Extrae su texto de esa respuesta para evaluar la calidad; no lo busques de nuevo con /search-tweets o /comments.
Lista de usuarios desde una búsqueda. Si ya obtuviste 500 usuarios únicos de los objetos user, filtra localmente cuáles tienen más de 10.000 seguidores. No realices 500 llamadas a /info.
Referencia rápida: elegir el endpoint
Estimar el presupuesto de solicitudes
Calcula el volumen antes de empezar:
Un flujo combinado puede consumir 50 + 10.000 + 1 + 8.640 + 5.000 = unas 23.700 solicitudes. A 20 por segundo, el mínimo teórico de procesamiento ronda los 20 minutos. Sin embargo, la supervisión abarca un día completo; la paginación secuencial, latencia y reintentos añaden tiempo. Consulta Precios para estimar el coste.
Próximos pasos
- Límites de solicitudes: errores 429 y rendimiento.
- Paginación: cursores para grandes volúmenes.
- Precios: coste por solicitud y presupuesto.
- Referencia de la API: especificaciones de lotes y demás endpoints.