API de DuckDuckGo
DuckDuckGo es un buscador web centrado en la privacidad. search devuelve hasta 50 resultados orgánicos de una consulta con título, enlace, URL visible, fragmento e icono del sitio.
Filtra por región con country y language, y por antigüedad con time_window (día, semana, mes o año). Solo se aceptan palabras normales: las comillas de frase exacta y operadores como site: se rechazan antes de cobrar.
Disponibilidad de la plataforma
- Salud 24 h
- Normal
Últimos 30 días
Funciones disponibles
Cada acción de DuckDuckGo, qué hace, su precio y su salud en las últimas 24 horas. Abre una acción para ver sus parámetros, campos de respuesta y ejemplos de código.
| Capacidad | Qué hace | Por 1.000 | Salud en 24 horas |
|---|---|---|---|
Buscar en DuckDuckGosearch | Envía una keyword y recibe hasta 50 resultados de DuckDuckGo con rank, title, url, displayed_url, text y favicon_url. | $0.56 por 1.000 solicitudes | Normal |
Abre una capacidad para ver sus parámetros, campos de respuesta, ejemplos de código y prueba.
¿Qué acepta cada acción de DuckDuckGo?
Cada respuesta enlaza una acción ejecutable con sus entradas reales. El significado y los valores permitidos pertenecen a esa acción; un nombre parecido no conserva automáticamente el mismo sentido en otra plataforma.
Las fuentes oficiales se enlazan solo para precisar el término de la plataforma indicado a su lado. No implican autorización ni respaldo y no añaden a EveryInfra funciones del sitio oficial.
| Acción | Obligatorios | Opcionales | Entrega | Límite | Por 1.000 | Campos de respuesta |
|---|---|---|---|---|---|---|
searchBuscar en DuckDuckGo Envía una | keyword | country, language, page, time_window | Entrega síncrona | El catálogo declara defaultLimit = 20 y maxLimit = 50 para el límite de esta acción. Según la acción, la unidad puede aplicarse a una página, a cada elemento padre o a otra unidad propia de la acción; no es necesariamente el total final de filas de toda la solicitud. | $0.56 por 1.000 solicitudes | rank · title · url · displayed_url · text · favicon_url · platform |
¿Qué significan los parámetros de DuckDuckGo search?
Envía una keyword y recibe hasta 50 resultados de DuckDuckGo con rank, title, url, displayed_url, text y favicon_url. Acota con country, language y time_window, y pasa de página con page.
keywordObligatorio- Palabras de búsqueda de DuckDuckGo, hasta 500 caracteres. Las comillas de frase exacta y operadores como site: se rechazan antes de cobrar.
countryOpcional- Código de país de dos letras, como
us,gb,deojp, que fija la región de búsqueda de DuckDuckGo. Si lo omites, o el país no tiene región en DuckDuckGo, se busca en todas las regiones.Ayuda de DuckDuckGo: elegir la región de búsqueda con parámetros de URL — La página de ayuda de DuckDuckGo indica que la región de búsqueda se fija con el parámetro kl, escrito como región-idioma (por ejemplo us-en o de-de), junto a ajustes como la búsqueda segura. La fuente solo confirma que DuckDuckGo separa los resultados por región; `country` y `language` de esta API los define EveryInfra y los combina en ese ajuste; el código de país de dos letras se convierte al código de región de DuckDuckGo (gb pasa a uk-en) y un país que no está en su lista busca en todas las regiones. La fuente no habla del número de resultados ni de filtros de fecha. · Consultada languageOpcional- Código de idioma de dos letras que elige la versión de idioma de una región que tiene varias, como
enofrpara Canadá; en otro caso no tiene efecto. pageOpcional- Página de resultados, desde 1, con
limitresultados por página (hasta 20 páginas). time_windowOpcional- Devuelve solo páginas de un periodo reciente:
day,week,monthoyear. Sin él no hay límite de fecha.
Cómo usar la API de DuckDuckGo
- 01Consulta el catálogo público y elige una acción de la plataforma.
- 02Envía los parámetros platform y action, junto con los campos obligatorios, a POST /api/v1/social.
- 03Procesa el resultado síncrono o consulta el identificador de trabajo cuando la acción se ejecute de forma asíncrona.
- 04Guarda los campos de la respuesta estructurada que necesita tu aplicación.
curl -X POST https://api.everyinfra.com/api/v1/social \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"platform":"duckduckgo","action":"search","params":{"keyword":"<keyword>"}}'
Preguntas sobre la API de DuckDuckGo
¿Cómo llamo a la API de DuckDuckGo?
Envía POST /api/v1/social con platform igual a duckduckgo, elige uno de los identificadores de acción indicados e incluye sus parámetros obligatorios.
¿Qué devuelve la API de DuckDuckGo?
Devuelve JSON estructurado. Por ejemplo, el esquema de search incluye rank, title, displayed_url y text. Cada acción tiene su propia lista de campos; que un campo esté declarado no garantiza que todos los registros tengan un valor.
¿Qué matiz de la documentación oficial conviene conservar al usar datos de DuckDuckGo?
La página de ayuda de DuckDuckGo indica que la región de búsqueda se fija con el parámetro kl, escrito como región-idioma (por ejemplo us-en o de-de), junto a ajustes como la búsqueda segura. La fuente solo confirma que DuckDuckGo separa los resultados por región; country y language de esta API los define EveryInfra y los combina en ese ajuste; el código de país de dos letras se convierte al código de región de DuckDuckGo (gb pasa a uk-en) y un país que no está en su lista busca en todas las regiones. La fuente no habla del número de resultados ni de filtros de fecha.
¿Qué parámetros son obligatorios?
Depende de la acción. search requiere keyword.
¿Las acciones de DuckDuckGo responden de inmediato?
Las acciones marcadas como asíncronas devuelven un identificador de trabajo que se consulta por sondeo. Cualquier otra acción también puede ejecutarse de forma asíncrona: añade "mode": "async" al cuerpo de la solicitud para recibir el identificador de inmediato, útil para tareas lentas o límites altos.