Node.JS

Consumir API de DuckDuckGo con Node.JS

El buscador DuckDuckGo, aparte de todas las ventajas que tiene en comparación con Google y otros buscadores, proporciona una API que si bien no sirve para buscar como en el buscador, funciona para obtener respuestas inmediatas y buscar definiciones.

Hoy veremos cómo consumir esta API basada en JSON utilizando JavaScript del lado del servidor: Node.JS. Un ejemplo de lo que la API devuelve es lo siguiente (al buscar JavaScript):

Ejemplo de respuesta de API JSON de DuckDuckGo

Consumir esta API no es nada difícil, pues es una simple petición GET y parseo de JSON.

Preparar cosas necesarias

Recuerda instalar Node y NPM, también pásate por el tutorial de petición GET simple con Node.JS y aprende a trabajar con JSON en JS.

Además de eso, te invito a leer lo que son las funciones flecha, const, callbacks y plantillas de cadena; esto es para que entiendas mejor el código.

Dependencias

Solamente dependemos de request y request-promise, se instalan así:

npm install --save request request-promise

Listo

Sobre otras librerías

Me parece que por ahí hay librerías para consumir de DuckDuckGo pero lo haremos con una petición HTTP simple para que pueda ser entendido a más “bajo nivel” que usando una librería.

Además, podremos consumir la api en español gracias a algo que descubrí (bueno, seguramente ya es sabido por muchos pero para mí fue un descubrimiento)

Dirección de la API y forma de usarla

Bueno, como lo dije, es una petición HTTP GET y un parseo simple con JSON a la siguiente URL:

https://api.duckduckgo.com

A ella le añadimos parámetros get:

  • q: la búsqueda
  • format: el formato, en este caso JSON (también se puede XML pero ya estamos en 2019 como para seguir usándolo)

Por ejemplo, para buscar “JavaScript” haría esto:

https://api.duckduckgo.com/?q=JavaScript&format=json

Y listo.

Dicho eso ahora sí vamos al ejemplo y al truco para los resultados en español.

Hablar es de mal gusto, muéstrame el código

Antes de todo, para que la API responda en español hay que mandarle el encabezado de Accept-Language dentro de la petición HTTP; y ponerlo en un idioma de español.

Esto lo descubrí porque, probando la API en el navegador, respondía en español, pero desde la petición HTTP no. Más tarde lo puse y funcionó de maravilla.

/**
 * Consumir API de respuestas inmediatas (instant answers)
 * de DuckDuckGo en español con Node.js y request, 
 * usando JSON para el intercambio de datos
 * 
 * @author parzibyte
 */
const request = require("request-promise"),
    RUTA = "https://api.duckduckgo.com";

/**
 * Una función que devuelve una promesa, al resolverse
 * se tendrá la respuesta que dio DuckDuckGo.
 * 
 * @param {string} busqueda La definición, pregunta o búsqueda
 */const respuestaInmediata = busqueda => request({
    uri: `${RUTA}/?q=${encodeURIComponent(busqueda)}&format=json`,
    headers: {
        'Accept-Language': 'es_LA', // Para consumirla en español
    },
    json: true, // Para que lo decodifique automáticamente 
});

respuestaInmediata("JavaScript")
    .then(datosRespuesta => {
        let definicion = datosRespuesta.Definition,
            resumen = datosRespuesta.AbstractText,
            respuesta = datosRespuesta.Answer,
            url = datosRespuesta.AbstractURL,
            imagen = datosRespuesta.Image,
            relacionados = datosRespuesta.RelatedTopics.map(relacionado => relacionado.Text);
        console.log({ definicion, resumen, respuesta, url, imagen, relacionados });
    });

Aquí lo importante es lo que devuelve la función llamada respuestaInmediata, y es un objeto que tiene algunas propiedades. En el ejemplo pongo las más importantes (que me parecieron más importantes) pero puedes ver la lista completa aquí.

Con eso podemos consumir la API de DuckDuckGo de una manera sencilla.

Aunque esto parezca sencillo, podemos hacer más cosas con la API y los datos que devuelve. Además, según DuckDuckGo, se mejorará conforme pase el tiempo.

Estoy aquí para ayudarte 🤝💻


Estoy aquí para ayudarte en todo lo que necesites. Si requieres alguna modificación en lo presentado en este post, deseas asistencia con tu tarea, proyecto o precisas desarrollar un software a medida, no dudes en contactarme. Estoy comprometido a brindarte el apoyo necesario para que logres tus objetivos. Mi correo es parzibyte(arroba)gmail.com, estoy como@parzibyte en Telegram o en mi página de contacto

No te pierdas ninguno de mis posts 🚀🔔

Suscríbete a mi canal de Telegram para recibir una notificación cuando escriba un nuevo tutorial de programación.
parzibyte

Programador freelancer listo para trabajar contigo. Aplicaciones web, móviles y de escritorio. PHP, Java, Go, Python, JavaScript, Kotlin y más :) https://parzibyte.me/blog/software-creado-por-parzibyte/

Entradas recientes

Creador de credenciales web – Aplicación gratuita

Hoy te voy a presentar un creador de credenciales que acabo de programar y que…

2 semanas hace

Desplegar PWA creada con Vue 3, Vite y SQLite3 en Apache

Ya te enseñé cómo convertir una aplicación web de Vue 3 en una PWA. Al…

2 semanas hace

Arquitectura para wasm con Go, Vue 3, Pinia y Vite

En este artículo voy a documentar la arquitectura que yo utilizo al trabajar con WebAssembly…

2 semanas hace

Vue 3 y Vite: crear PWA (Progressive Web App)

En un artículo anterior te enseñé a crear un PWA. Al final, cualquier aplicación que…

2 semanas hace

Errores de Comlink y algunas soluciones

Al usar Comlink para trabajar con los workers usando JavaScript me han aparecido algunos errores…

2 semanas hace

Esperar promesa para inicializar Store de Pinia con Vue 3

En este artículo te voy a enseñar cómo usar un "top level await" esperando a…

2 semanas hace

Esta web usa cookies.