> ## Documentation Index
> Fetch the complete documentation index at: https://docs.querying.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# API de resultados de búsqueda de Naver (NAVER_SERP)

> Obtén una página de resultados de documentos web de Naver para una consulta, o lee una página de naver.com como texto.

`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

```bash theme={"theme":"css-variables"}
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:

```json theme={"theme":"css-variables"}
{
  "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

```bash theme={"theme":"css-variables"}
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:

```json theme={"theme":"css-variables"}
{
  "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](/es/engines/response-options.md#flags-no-admitidos).
* Los demás errores de solicitud se enumeran en [Errores](/es/concepts/errors.md).

## Relacionado

* [Naver AI Brief](/es/engines/naver-ai-brief.md), que también devuelve los documentos orgánicos bajo su resumen
* [Naver AI Tab](/es/engines/naver-ai-tab.md)
* [Regiones y ubicación](/es/engines/capacity.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.