Twitter API

API de Twitter: búsqueda de usuarios, cronologías y paginación

Integra los endpoints Twitter / X de API Hop con autenticación Bearer, selección de campos de usuarios y tweets, paginación por cursor y gestión de errores de validación.

Resuelve un nombre de usuario a ID, obtén su cronología y pasa el siguiente token para otra página. Las llamadas correctas devuelven JSON directamente; estos endpoints no requieren consulta de Jobs.

Obtener una clave API Explorar el catálogo de API

Para una tarea concreta

Implementa las tres operaciones GET compatibles y procesa sus resultados.

Resuelve una cuenta por nombre y selecciona los campos de perfil a devolver.

Actualiza una cuenta conocida por ID sin volver a buscar el nombre.

Obtén páginas de cronología con límite de tamaño y token de paginación.

Unidad de facturación

Cómo se mide el uso

USD por solicitud.

Límites operativos

Los campos devueltos dependen de los parámetros documentados y la respuesta del proveedor.
max_results debe ser un entero de 1 a 100. Una página puede contener menos resultados.
Conserva ID de usuarios y tweets como cadenas para evitar pérdida de precisión numérica.

Guías de integración

Elige el siguiente paso

Planifica actualizaciones y almacenamiento Limita las solicitudes, elimina publicaciones duplicadas y registra los tiempos de recuperación en tu aplicación. Catálogo de API de datos Revisa productos de datos, operaciones y precios por solicitud actuales.

Cobertura actual del catálogo

API disponibles y unidades de facturación

Compara ID API, operaciones, proveedores y precios. Comprueba la fecha del catálogo y la unidad de facturación de cada operación antes de estimar costes.

API de datos

Twitter User Data

twitter-user-data Documentación

Disponible

Obtén perfiles públicos de usuarios de Twitter / X y sus cronologías.

Proveedor: Twitter / X Data
Unidad de facturación: solicitud
Formatos API y endpoints: Consulta las operaciones siguientes para ver los endpoints.
Capacidades publicadas: Búsqueda de usuario, Cronología del usuario

Operaciones publicadas

GET /v1/twitter/users Obtener usuario por nombre de usuario
GET /v1/twitter/users/{id} Obtener usuario por ID
GET /v1/twitter/users/{id}/tweets Obtener tuits del usuario

Precio de API Hop

Solicitud: $0.0020 /solicitud

Obtener usuario por nombre de usuario

GET /v1/twitter/users

Precio de API Hop

Solicitud: $0.0020 /solicitud

Obtener usuario por ID

GET /v1/twitter/users/{id}

Precio de API Hop

Solicitud: $0.0020 /solicitud

Obtener tuits del usuario

GET /v1/twitter/users/{id}/tweets

Precio de API Hop

Solicitud: $0.0020 /solicitud

Abrir el catálogo API completo

Ejemplo de solicitud

Empieza por la operación documentada

curl "https://api.apihop.ai/v1/twitter/users?username=OpenAI&user.fields=description,public_metrics" \
  -H "Authorization: Bearer <API_KEY>"

const response = await fetch("https://api.apihop.ai/v1/twitter/users?username=OpenAI&user.fields=description,public_metrics", {
  headers: { Authorization: "Bearer <API_KEY>" }
});
const data = await response.json();
console.log(data);

import requests

url = "https://api.apihop.ai/v1/twitter/users?username=OpenAI&user.fields=description,public_metrics"
headers = {"Authorization": "Bearer <API_KEY>"}
response = requests.get(url, headers=headers, timeout=60)
response.raise_for_status()
print(response.json())

Usa la URL base API de la documentación de tu cuenta y sustituye los marcadores. Envía tu clave API en el encabezado Authorization, nunca en una URL o archivo del repositorio.

Endpoints

Tres operaciones para cuentas y cronologías

Buscar por nombre de usuario GET /v1/twitter/users?username=<USERNAME>

Lee el data.id devuelto como cadena para solicitudes posteriores.

Buscar por ID de usuario GET /v1/twitter/users/<USER_ID>

Obtén una cuenta conocida y selecciona opcionalmente sus campos de perfil.

Cronología del usuario GET /v1/twitter/users/<USER_ID>/tweets

Configura max_results y pasa pagination_token para las siguientes páginas.

Parámetros de consulta

Selecciona campos y pagina una cronología

Consulta de cuenta: username es obligatorio en /v1/twitter/users. Ambos endpoints aceptan una lista user.fields separada por comas, como description,public_metrics.
Tamaño de página: max_results acepta enteros de 1 a 100. Es el límite superior de la página, no garantiza ese número de publicaciones.
Campos de cronología: Usa tweet.fields=created_at,public_metrics para fechas y métricas. Solicita expansions=author_id con user.fields para datos disponibles del autor. Usa exclude=replies,retweets para excluir esos tipos de publicación.
Página siguiente: Pasa meta.next_token de la respuesta como pagination_token en la siguiente solicitud. No interpretes el token y codifícalo para URL. Detente si no hay otro token, alcanzas el presupuesto de páginas o se repite un token.

Procesamiento de respuestas

Lee resultados JSON directamente

Las consultas devuelven la cuenta en data. Las cronologías contienen un array data y meta.result_count, con meta.next_token si hay otro cursor. Las ampliaciones del autor pueden aparecer en includes.users.

{
  "data": [],
  "meta": {
    "result_count": 0
  }
}

Respuesta ilustrativa de cronología vacía, no un resultado en vivo. Pueden faltar campos opcionales y cursores. Una página vacía no prueba que la cuenta nunca haya publicado.

Errores de validación

Corrige parámetros inválidos antes de reintentar

La falta de username o un max_results fuera de rango devuelve HTTP 400 con success: false, error.code: 10001, error.message y requestId. Revisa el mensaje y corrige la solicitud, no la repitas sin cambios.

Seguimiento de solicitudes

Guarda un ID de solicitud, no una credencial

Conserva el encabezado X-Request-Id para soporte y seguimiento. Comprueba el estado HTTP antes de leer un resultado correcto y excluye claves API y datos de perfil innecesarios de los registros.