API de resultados de búsqueda de Naver (NAVER_SERP) - querying.ai

NAVER_SERP devuelve una página de resultados de la pestaña de documentos web de Naver, 15 documentos por página. Con "action": "page" lee una página de naver.com (una entrada de blog, un artículo de cafe, una noticia, una respuesta de Knowledge iN o cualquier otra página de naver.com) y devuelve su texto.


`taskType`	`NAVER_SERP`
Entrada	`query` (obligatorio para buscar); `page`, `country`; o `action: "page"` con `url`, `maxChars`
Créditos	1 por tarea
País	`KR` por defecto.
Ubicación	No admitida (`422 LOCATION_UNSUPPORTED`).

Búsqueda

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

Campo	Obligatorio	Descripción
`query`	Sí	La consulta de búsqueda, de 1 a 100.000 caracteres. Se acepta `prompt` si falta `query`.
`page`	No	Página de resultados, un entero de 1 a 10. `1` por defecto. Otros valores devuelven `422 VALIDATION_ERROR`.
`country`	No	`KR` por defecto, el mercado de Naver.

Por ejemplo, la página 2:

{
  "organicResults": [
    { "position": 16, "title": "...", "link": "https://...", "displayedLink": "example.com›path", "snippet": "...", "page": 2 }
  ]
}

Campo	Descripción
`organicResults`	Los documentos de la página. `position` cuenta a través de las páginas, así que el primer documento de la página 2 es `16`. Cada fila lleva su `page`.
`notice`	Presente cuando Naver oculta los resultados tras su verificación de edad: `{ "type": "age_verification_required", "scope": "organicResults", "message" }`. `message` cita a Naver cuando se puede leer.

Un organicResults vacío en una tarea completada significa que el propio Naver no devolvió ningún documento.

Leer una página de naver.com

curl -X POST https://api.querying.ai/v1/async/task \
  -H "Authorization: Bearer $QUERYING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "taskType": "NAVER_SERP", "payload": { "action": "page", "url": "https://blog.naver.com/example/223000000000", "maxChars": 10000 } }'

Campo	Obligatorio	Descripción
`action`	Sí	`page`.
`url`	Sí	Una dirección `https` en `naver.com` o uno de sus subdominios. Otras direcciones devuelven `422 VALIDATION_ERROR`.
`maxChars`	No	Limita `text`, un entero de 1.000 a 50.000. 20.000 por defecto.

Por ejemplo:

{
  "type": "blog",
  "url": "https://blog.naver.com/example/223000000000",
  "title": "...",
  "text": "...",
  "author": "...",
  "publishedAt": "...",
  "images": ["https://..."],
  "truncated": false
}

Campo	Descripción
`type`	`blog`, `cafe`, `news`, `terms`, `kin` o `generic`.
`title`, `text`	El título y el texto del cuerpo de la página.
`author`, `publishedAt`, `cafeName`	Presentes cuando la página los tiene.
`images`	Hasta 30 direcciones de imágenes del cuerpo.
`truncated`	`true` cuando `text` se cortó en `maxChars`.

Estos casos hacen fallar la tarea con PAGE_UNAVAILABLE y un motivo: una redirección que sale de naver.com, una página inexistente (404 o 410), un artículo de cafe que solo pueden leer los miembros y una página sin cuerpo legible.

Límites y errores

NAVER_SERP ignora markdown, rawResponse y searchQueries. Rechaza html y analysis con 422 y citationAnalysis con 400; consulta flags no admitidos.
Los demás errores de solicitud se enumeran en Errores.

Relacionado

Naver AI Brief, que también devuelve los documentos orgánicos bajo su resumen
Naver AI Tab
Regiones y ubicación