HonestHook

Free API key (1,000/mo)Sign in

Inicio · API · Inicio rápido

De cero a datos reales, en esta página.

Tres pasos, sin tarjeta, sin llamada, nada que instalar. El comando de abajo viene con tu clave ya sustituida — copia, pega, listo.

  1. Consigue una clave

    Gratis, sin tarjeta y sin llamada comercial. Una clave por dirección — guardamos el correo para asociarle la clave y para avisarte si algo se rompe. Mira privacidad.

  2. Después pega un comando

    curl "https://honesthook.com/api/v1/trends/ai-agents?limit=3" \
  -H "Authorization: Bearer hk_live_…"

    El comando de arriba es el que vas a recibir, con tu clave ya sustituida. Nada que rellenar a mano.

  3. Qué deberías ver

    {
  "niche": "ai-agents",
  "from": "2026-08-31T13:08:21Z",
  "to":   "2026-09-07T13:08:21Z",
  "credits_charged": 1,
  "paid_from": "free",
  "free_used": 1,
  "free_total": 1000,
  "credits_balance": 0,
  "points": 3,
  "truncated": true,
  "items": [
    {
      "title": "44% on ARC-AGI-1 in 67 cents",
      "url": "https://mvakde.github.io/blog/44-on-arc-1/",
      "platform": "lobsters",
      "best_position": 1,
      "movement": 0,
      "series": [
        { "window": "2026-09-07T13:00:00Z", "position": 1, "points": 13 }
      ]
    }
  ]
}

    A real response from this endpoint, trimmed to one item. truncated: true here is the limit=3 doing its job, not a failure — drop the parameter and you get the whole window.

Si no funciona

Todo fallo lleva un código error estable en el cuerpo. Ramifica sobre el código, nunca sobre la prosa — la prosa puede cambiar, el código no.

VesSignificaQué hacer
401 chave_invalidaNo se reconoció la clave, o fue desactivada.Cópiala de nuevo — una clave cortada por un salto de línea es la causa habitual. Las claves tienen 56 caracteres y empiezan por hk_live_. Si estás seguro de que es correcta, escríbenos.
401 chave_ausenteNo llegó ninguna cabecera Authorization.Comprueba que la variable de shell se expandió de verdad — una vacía se ve exactamente así. movers informa una cabecera ausente como chave_invalida; la comprobación corre en la base de datos, donde una clave ausente se ve igual que una equivocada.
402 sem_creditosLa franquicia mensual está agotada.No reintentes. 402 no es un límite de frecuencia — esperar solo ayuda el día 1, cuando la franquicia se renueva. Antes de eso, compra créditos — se suman a esta clave y no caducan. Si prefieres no pagar todavía, pídenos una recarga. Un bucle de retroceso aquí nunca puede tener éxito.
400 intervalo_invalidofrom o to no está en ISO 8601.Usa 2026-09-05T00:00:00Z, con la zona. Omite las dos y obtienes los últimos 7 días.
200, items: []No es un error — y es el que más te cuesta. Nada valida el nombre del nicho, así que una errata vuelve como un éxito vacío. En trends gasta igualmente una llamada.Resuelve el nombre en /api/v1/nichos antes de leer una lista vacía como un hallazgo. Es la forma de fallo que este proyecto se sigue pillando a sí mismo: ningún error, y una respuesta que parece plausible.
503 endpoint_indisponivelEse endpoint está apagado en la base de datos.No se cobró nada. La página de estado publica la última captura por fuente, incluidas las que están rotas.
409 ja_tem_chaveEsa dirección ya tiene una clave activa.Usa la clave que ya tienes. Si la perdiste, escríbenos y la rotamos a mano — guardamos solo un hash, así que podemos reemplazarla pero nunca consultarla.

La lista completa, incluidos los códigos que esta página no cubre, está en la documentación de la API.

Qué leer después

/trends responde qué estaba en el ranking. /movers responde qué ganó tracción desde ayer — una pregunta que solo le puedes hacer a un archivo que guardó el ayer. Las dos están en la documentación, con lo que los datos todavía no sostienen dicho sin rodeos.

Documentación de la API · Estado del archivo · Volver a la portada · Términos · Privacidad · contato@honesthook.com