API de resultados da Busca do Naver (NAVER_SERP) - querying.ai

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

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:

{
  "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

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:

{
  "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.
Os demais erros de requisição estão em Erros.

Relacionados

Naver AI Brief, que também retorna os documentos orgânicos abaixo do resumo
Naver AI Tab
Regiões e localização