API de Naver AI Brief: resumen de IA, fuentes y resultados web

NAVER_AI_BRIEF busca en Naver y devuelve el AI Brief, el recuadro de resumen de IA de la página de resultados de Naver, junto con los documentos web que se muestran debajo.


taskType	`NAVER_AI_BRIEF`
Alias	`NAVER` (obsoleto)
Lee	`query` (recurre a `prompt`)
Créditos	1,25
País	Opcional, por defecto `KR`.

Solicitud

Naver es un buscador coreano, así que country vale KR por defecto cuando lo omites. El ejemplo siguiente lo envía de forma explícita.

curl -X POST https://api.querying.ai/v1/async/task \
  -H "Authorization: Bearer $QUERYING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "taskType": "NAVER_AI_BRIEF", "payload": { "query": "best running shoes for flat feet", "country": "KR" } }'

Respuesta

Campo	Tipo	Descripción
`text`	string	El resumen como texto plano. Vacío cuando Naver no mostró ningún resumen.
`markdown`	string	El resumen tal como lo escribió Naver, con títulos, listas y tablas. Se devuelve sin ningún flag.
`sources`	array	`position`, `url`, `label`, `description`.
`relatedQuestions`	string[]	Preguntas de seguimiento que sugiere Naver.
`images`	array	Imágenes mostradas con la respuesta: `title`, `url`, `image`, `thumbnail`, `source`, `sourceName`.
`organicResults`	array	Los documentos web bajo el recuadro de resumen: `position`, `title`, `link`, `displayedLink`, `snippet`, `date`, `page`.
`rawContent`	string	El stream de eventos original. Solo con `include.rawResponse`.

En markdown, las citas aparecen como [n] según sources[].position y las imágenes como ![title](url). El resumen es condicional: Naver no lo muestra para todas las consultas, y una tarea sin resumen se completa igualmente. El resumen y los documentos vienen de dos solicitudes distintas a Naver. Cuando Naver no encuentra documentos, organicResults está ausente en lugar de vacío. Si no se puede leer alguna de las dos solicitudes, la tarea falla con ENGINE_NO_RESULT. Por ejemplo:

{
  "text": "Shoes with firm arch support and a stable midsole suit flat feet ...",
  "markdown": "### Choosing shoes for flat feet\n- Firm arch support [1]\n- Stable midsole [2]",
  "sources": [{ "position": 1, "url": "https://blog.naver.com/...", "label": "Running shoes for flat feet", "description": "..." }],
  "relatedQuestions": ["Which brands make stability running shoes?"],
  "organicResults": [
    { "position": 1, "title": "Stability running shoes guide", "link": "https://www.example.com/guide", "displayedLink": "example.com", "snippet": "...", "page": 1 }
  ]
}

Flags include

Flag	Efecto
`rawResponse`	Añade `rawContent`.
`analysis`	Añade `analysis`, 1 crédito. Consulta Análisis de la respuesta.
`citationAnalysis`	Ejecuta un Citation Analysis sobre el resumen.

markdown no necesita flag. searchQueries, ads y shopping no tienen efecto. html se rechaza con 422 EVIDENCE_UNSUPPORTED. Consulta Respuestas en Markdown y en bruto.

Primeros pasos

Conceptos clave

Motores de respuesta

Búsqueda y datos web

Opciones de solicitud

Investigación

Monitorización GEO

Cuenta y datos

API de Naver AI Brief: resumen de IA, fuentes y resultados web

Solicitud

Respuesta

Flags include

Relacionado

​Solicitud

​Respuesta

​Flags include

​Relacionado

Solicitud

Respuesta

Flags include

Relacionado