API de Naver AI Tab: respuestas conversacionales, fuentes, lugares y productos - querying.ai

NAVER_AI_TAB pregunta a AI Tab de Naver, la respuesta conversacional siempre disponible de la búsqueda de Naver.


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

Solicitud

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_TAB", "payload": { "query": "best running shoes for flat feet", "country": "KR" } }'

Respuesta

Campo	Tipo	Descripción
`text`	string	La respuesta.
`markdown`	string	La respuesta con las tarjetas de Naver escritas en su lugar. Se devuelve sin ningún flag.
`sources`	array	`position`, `url`, `label`, `description`.
`map`	array	Lugares, en preguntas sobre lugares: `name`, `position`, `placeId`, `location`, `url`, `mapsUrl`, `reviews`, `category`, `image`.
`products`	array	Productos, en preguntas de compras.
`images`	array	Imágenes mostradas con la respuesta: `title`, `url`, `image`, `thumbnail`, `source`, `sourceName`.
`videos`	array	Vídeos mostrados con la respuesta.
`rawContent`	string	El stream de eventos original. Solo con `include.rawResponse`.

En markdown, las citas aparecen como [n] según sources[].position, las imágenes como ![title](url) y las tarjetas de lugares y productos como líneas enlazadas. Por ejemplo:

{
  "text": "For flat feet, look for stability shoes with firm arch support ...",
  "markdown": "For flat feet, look for **stability shoes** with firm arch support [1].",
  "sources": [{ "position": 1, "url": "https://blog.naver.com/...", "label": "Running shoes for flat feet", "description": "..." }]
}

Cuando Naver rechaza una consulta por motivos de política, la tarea se completa con ese rechazo y un notice cuyo type es policy_declined.

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 la respuesta.

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.

Relacionado