JSON en vivo y sin clave: cómo usar la API de Hacker News

¿Cómo se usa la API de Hacker News?

Toda duda sobre cómo usar la API de Hacker News termina en uno de dos hosts gratuitos: hacker-news.firebaseio.com/v0/ sirve ítems en vivo, perfiles de usuario y listas ordenadas de historias, y hn.algolia.com/api/v1/ sirve la búsqueda de texto completo. Los dos devuelven JSON plano sobre HTTPS, los dos aceptan peticiones anónimas, y ninguno emite claves de API ni acepta un token. Recurra a Firebase cuando ya conozca el id de un ítem o quiera la portada actual, y recurra a Algolia cuando tenga una palabra clave y ningún id.

¿Qué devuelve la API de Firebase para un ítem?

La API de Firebase devuelve un objeto JSON plano por ítem desde /v0/item/<id>.json, e id es el único campo que llevan todos los ítems. El README de HackerNews/API enumera deleted, type, by, time, text, dead, parent, poll, kids, url, score, title, parts y descendants como campos opcionales, y type toma uno de los valores "job", "story", "comment", "poll" o "pollopt". Escriba su parser contra id más lo que encuentre, porque un comentario lleva parent y text donde una historia lleva url, score y descendants.

curl "https://hacker-news.firebaseio.com/v0/item/8863.json?print=pretty"

{
  "by": "dhouston",
  "descendants": 71,
  "id": 8863,
  "kids": [9224, 8917, 8884, 8887],
  "score": 104,
  "time": 1175714200,
  "title": "My YC app: Dropbox - Throw away your USB drive",
  "type": "story",
  "url": "http://www.getdropbox.com/u/2/screencast.html"
}

Esa es la respuesta en vivo para el ítem 8863 con el array kids recortado a cuatro ids; el real contiene 33. time es un timestamp Unix en segundos, descendants cuenta el árbol entero de comentarios y kids solo contiene las respuestas directas, así que recorrer un hilo completo significa descender de forma recursiva por kids con una petición cada vez.

¿Qué endpoints tiene la API de Hacker News?

La API de Firebase expone diez rutas, todas GET y todas terminadas en .json. Cada ruta de lista devuelve un array de ids de ítems y no los ítems en sí, así que leer una lista cuesta una petición más una petición por cada id que resuelva después.

Los tamaños documentados son topes, no longitudes fijas. Consultado el 10 de septiembre de 2026, /v0/topstories.json devolvió los 500 ids completos mientras /v0/askstories.json devolvió 28, y /v0/maxitem.json devolvió 49.649.544. Los ids son secuenciales desde el ítem 1, una historia titulada "Y Combinator" publicada por el usuario pg con un time de 1160418111, así que un crawler puede recorrer todo el corpus contando hacia arriba. Ese id secuencial es también lo que hace que las estadísticas de Hacker News que puede sacar de los mismos endpoints se puedan comprobar en lugar de ser de segunda mano.

¿Cómo se busca en Hacker News con la API de Algolia?

La búsqueda corre en un host aparte con dos rutas: /api/v1/search ordena por relevancia, luego por puntos, luego por número de comentarios, y /api/v1/search_by_date ordena los más nuevos primero. Las dos aceptan query para texto completo, tags para filtros de tipo, numericFilters para condiciones sobre created_at_i, points y num_comments, además de page y hitsPerPage para paginar. Filtre con tags antes de filtrar en su propio código, porque los valores válidos cubren story, comment, poll, pollopt, show_hn, ask_hn, front_page, author_:USERNAME y story_:ID.

curl "https://hn.algolia.com/api/v1/search?query=postgres&tags=story&hitsPerPage=1"
curl "https://hn.algolia.com/api/v1/search_by_date?tags=story&numericFilters=created_at_i>1788998400"
curl "https://hn.algolia.com/api/v1/search?tags=comment,story_18717168"
curl "https://hn.algolia.com/api/v1/search?tags=front_page"

{
  "hits": [
    {
      "objectID": "18717168",
      "title": "Bye Bye Mongo, Hello Postgres",
      "url": "https://www.theguardian.com/info/2018/nov/30/bye-bye-mongo-hello-postgres",
      "author": "philliphaydon",
      "points": 1562,
      "num_comments": 417,
      "created_at": "2018-12-19T17:08:53Z",
      "created_at_i": 1545239333,
      "story_id": 18717168,
      "_tags": ["story", "author_philliphaydon", "story_18717168"]
    }
  ],
  "nbHits": 14776,
  "page": 0,
  "nbPages": 1000,
  "hitsPerPage": 1,
  "processingTimeMS": 13
}

Los tags se combinan con AND por defecto y con OR dentro de paréntesis, así que author_pg,(story,poll) se lee como autor pg AND (story OR poll). Ese es todo el lenguaje de consulta, y es más estrecho que los operadores de búsqueda booleanos que escribiría para un buscador, así que la cobertura de palabras clave tiene que salir de varias consultas en lugar de una sola ingeniosa. hitsPerPage vale 20 por defecto.

¿Cuáles son los límites de uso de la API de Hacker News?

Las dos API publican respuestas distintas sobre sus rate limits (límites de peticiones por periodo). El README de HackerNews/API dice "There is currently no rate limit" para los endpoints de Firebase, y la documentación de hn.algolia.com/api dice que Algolia limita una sola IP a 10.000 peticiones por hora y bloquea las direcciones que lo superan. Ninguna cifra publicada cubre el lado de Firebase, así que trate ese margen como una cortesía y no como una garantía, y mantenga un polling razonable en ambos casos.

Calcule el presupuesto del lado de Algolia antes de escribir el bucle:

peticiones por hora = (3600 / intervalo de polling en segundos) x número de consultas guardadas

Treinta consultas guardadas con un intervalo de 60 segundos dan 3600 / 60 = 60 consultas por búsqueda y hora, y 60 x 30 = 1.800 peticiones por hora, que es el 18 por ciento de las 10.000 permitidas. Si añade un refresco de la portada en el lado de Firebase, el coste es 1 petición a /v0/topstories.json más 500 peticiones de ítems, o 501 peticiones por pasada. Quien haya calculado su presupuesto alrededor de los rate limits de la API de Reddit verá ambas cifras generosas en comparación.

¿Qué no puede hacer la API de Hacker News?

Las dos API son de solo lectura, así que ningún endpoint publica una historia, vota ni responde a un comentario, y ninguna ruta acepta credenciales que lo permitan. Algolia además limita la paginación: nbPages multiplicado por hitsPerPage dio exactamente 1.000 con cada tamaño de página probado el 10 de septiembre de 2026, y pedir la página 60 con 20 resultados por página devolvió un array hits vacío, lo que significa que una consulta llega a 1.000 resultados y no más. Divida una búsqueda amplia en rangos de fechas con numericFilters sobre created_at_i cuando necesite todo lo que queda detrás de ese muro.

Ninguna de las dos API le avisa. No hay webhook, ni email, ni vigilancia de palabras clave, ni deduplicación entre menciones repetidas, ni criterio sobre qué hilo merece una respuesta. Ese hueco es el trabajo que hace RedReplier: toma un sitio web y un conjunto de palabras clave, vigila Hacker News junto con Reddit, X, Bluesky y Facebook en un solo lugar, clasifica cada mención por intención de compra, explica con IA por qué se marcó y le envía un email con el intervalo de su plan. El mismo producto ofrece además acceso por API y un servidor MCP que funciona con Claude Code, Cursor y cualquier cliente MCP estándar, que es la diferencia entre la recopilación de datos de redes sociales en bruto y una cola de conversaciones que vale la pena responder.

Preguntas frecuentes

¿La API de Hacker News necesita una clave de API?

No. Ni hacker-news.firebaseio.com/v0/ ni hn.algolia.com/api/v1/ emiten claves, y ninguno acepta un token. Un GET simple sin autenticar devuelve JSON desde ambos hosts, por eso basta un solo comando curl para probar cualquier endpoint de esta página.

¿Existe un rate limit oficial de la API de Hacker News?

Algolia publica uno y Firebase no. La documentación de hn.algolia.com/api limita una sola IP a 10.000 peticiones por hora, y el README de HackerNews/API dice "There is currently no rate limit" para los endpoints de Firebase. No existe ninguna cifra documentada para Firebase, así que quien cite un número concreto de peticiones por segundo para ella está adivinando.

¿Cómo obtengo todos los comentarios de una historia de Hacker News?

Hay dos caminos. En Firebase, lea el array kids de la historia y descienda de forma recursiva a cada ítem hijo, lo que cuesta una petición por comentario. En Algolia, una sola petición a /api/v1/search?tags=comment,story_<ID> devuelve los comentarios como resultados de búsqueda, sujeta al tope de paginación de 1.000 resultados.

¿Qué diferencia hay entre la API de Firebase y la API de Algolia?

Firebase es el registro en vivo y Algolia es el índice sobre él. Firebase responde a "dame el ítem 8863" y "qué hay en la portada ahora mismo" con campos como score, kids y descendants. Algolia responde a "qué historias mencionan postgres" con campos como points, num_comments y created_at_i, y es la única de las dos que hace búsqueda de texto completo.

¿Puedo publicar o votar en Hacker News a través de la API?

No. Las dos API son de solo lectura, y ninguna documenta una ruta de escritura para enviar historias, publicar comentarios o votar. Cualquier cosa que publique en Hacker News en su nombre está manejando el sitio web, no la API.

¿Hasta cuándo se remontan los datos de la API de Hacker News?

Hasta el primer ítem del sitio. El ítem con id 1 es una historia titulada "Y Combinator" publicada por el usuario pg, con un time Unix de 1160418111, lo que la sitúa en octubre de 2006. Desde ahí los ids avanzan de forma secuencial hasta el valor que /v0/maxitem.json indica hoy.

¿Cómo obtengo la portada actual de Hacker News con la API?

El endpoint de Firebase /v0/topstories.json devuelve hasta 500 ids ordenados de la portada, y cada id necesita después una solicitud aparte a /v0/item/<id>.json para resolver título, puntuación y url. Algolia ofrece un atajo para la misma lista: /api/v1/search?tags=front_page devuelve la portada como resultados de búsqueda en una sola solicitud. Firebase conviene cuando se necesita el ranking en vivo con todos los campos, y Algolia cuando basta con una llamada.

¿Puedo filtrar los resultados de búsqueda de Hacker News por puntuación o número de comentarios?

La API de Algolia acepta numericFilters para condiciones sobre points y num_comments, además de created_at_i para rangos de fecha. Una consulta como numericFilters=points>500 limita /api/v1/search a historias con esa puntuación o más, y los filtros se combinan con una coma. Firebase incluye los mismos campos score y descendants en cada ítem, pero no tiene parámetro de filtro, así que filtrar ahí implica traer los ítems y revisar los campos por tu cuenta.

¿Cómo sigo las publicaciones nuevas de Hacker News en cuanto aparecen?

Consultar /v0/newstories.json en Firebase devuelve los ids más recientes, hasta 500 a la vez, y comparar cada consulta con la anterior revela los ids nuevos. Combinarlo con /v0/maxitem.json, que da el techo actual de todo el corpus, hace que un salto en ese número anuncie ítems nuevos antes incluso de listarlos. El README dice "There is currently no rate limit", lo que significa que consultar este endpoint con frecuencia no tiene coste documentado, pero el cálculo de presupuesto de Algolia de este artículo sigue aplicando en cuanto se mezclan búsquedas.

¿Puedo consultar todo lo que ha publicado un usuario concreto de Hacker News?

/v0/user/<id>.json en Firebase devuelve un perfil con el campo submitted, un array con todos los ids de ítems que ese usuario publicó, comentarios incluidos. Cada id se resuelve con /v0/item/<id>.json para obtener título, texto y puntuación, el mismo patrón de una solicitud por id que se usa para recorrer un hilo de comentarios. La etiqueta author_:USERNAME de Algolia también filtra resultados por autor, más rápido cuando solo hacen falta historias y no el historial completo.