> ## 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 da Busca do Naver (NAVER_SERP)

> Receba uma página de resultados de documentos web do Naver para uma consulta, ou leia uma página do naver.com como texto.

`NAVER_SERP` retorna uma página de resultados da aba de documentos web do Naver, 15 documentos por página. Com `"action": "page"`, ele lê uma página do naver.com (um post de blog, um artigo de cafe, uma notícia, uma resposta do Knowledge iN ou qualquer outra página do naver.com) e retorna seu texto.

| | |
| - | - |
| `taskType` | `NAVER_SERP` |
| Entrada | `query` (obrigatório na busca); `page`, `country`; ou `action: "page"` com `url`, `maxChars` |
| Créditos | 1 por tarefa |
| País | Padrão `KR`. |
| Localização | Não suportada (`422 LOCATION_UNSUPPORTED`). |

## Busca

```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 | Obrigatório | Descrição |
| - | - | - |
| `query` | Sim | A consulta de busca, de 1 a 100.000 caracteres. `prompt` é aceito quando `query` está ausente. |
| `page` | Não | Página de resultados, um inteiro de 1 a 10. Padrão `1`. Outros valores retornam `422 VALIDATION_ERROR`. |
| `country` | Não | Padrão `KR`, o mercado do Naver. |

Por exemplo, a página 2:

```json theme={"theme":"css-variables"}
{
  "organicResults": [
    { "position": 16, "title": "...", "link": "https://...", "displayedLink": "example.com›path", "snippet": "...", "page": 2 }
  ]
}
```

| Campo | Descrição |
| - | - |
| `organicResults` | Os documentos da página. `position` conta através das páginas, então o primeiro documento da página 2 é `16`. Cada linha traz sua `page`. |
| `notice` | Presente quando o Naver esconde os resultados atrás da verificação de idade: `{ "type": "age_verification_required", "scope": "organicResults", "message" }`. `message` cita o Naver quando é possível lê-lo. |

Um `organicResults` vazio em uma tarefa concluída significa que o próprio Naver não retornou documentos.

## Ler uma página do 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 | Obrigatório | Descrição |
| - | - | - |
| `action` | Sim | `page`. |
| `url` | Sim | Um endereço `https` em `naver.com` ou em um de seus subdomínios. Outros endereços retornam `422 VALIDATION_ERROR`. |
| `maxChars` | Não | Limita `text`, um inteiro de 1.000 a 50.000. Padrão 20.000. |

Por exemplo:

```json theme={"theme":"css-variables"}
{
  "type": "blog",
  "url": "https://blog.naver.com/example/223000000000",
  "title": "...",
  "text": "...",
  "author": "...",
  "publishedAt": "...",
  "images": ["https://..."],
  "truncated": false
}
```

| Campo | Descrição |
| - | - |
| `type` | `blog`, `cafe`, `news`, `terms`, `kin` ou `generic`. |
| `title`, `text` | O título e o texto do corpo da página. |
| `author`, `publishedAt`, `cafeName` | Presentes quando a página os tem. |
| `images` | Até 30 endereços de imagem do corpo. |
| `truncated` | `true` quando `text` foi cortado em `maxChars`. |

Estes casos fazem a tarefa falhar com `PAGE_UNAVAILABLE` e um motivo: um redirecionamento que sai do naver.com, uma página inexistente (404 ou 410), um artigo de cafe que só membros podem ler e uma página sem corpo legível.

## Limites e erros

* `NAVER_SERP` ignora `markdown`, `rawResponse` e `searchQueries`. Recusa `html` e `analysis` com `422` e `citationAnalysis` com `400`; veja [flags não suportadas](/pt/engines/response-options.md#flags-não-suportadas).
* Os demais erros de requisição estão em [Erros](/pt/concepts/errors.md).

## Relacionados

* [Naver AI Brief](/pt/engines/naver-ai-brief.md), que também retorna os documentos orgânicos abaixo do resumo
* [Naver AI Tab](/pt/engines/naver-ai-tab.md)
* [Regiões e localização](/pt/engines/capacity.md)


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