> ## 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 des résultats de recherche Naver (NAVER_SERP)

> Obtenez une page de résultats de documents web Naver pour une requête, ou lisez une page naver.com en texte.

`NAVER_SERP` renvoie une page de résultats de l'onglet Documents web de Naver, 15 documents par page. Avec `"action": "page"`, il lit une page naver.com (billet de blog, article de cafe, actualité, réponse Knowledge iN ou toute autre page naver.com) et renvoie son texte.

| | |
| - | - |
| `taskType` | `NAVER_SERP` |
| Entrée | `query` (obligatoire pour la recherche) ; `page`, `country` ; ou `action: "page"` avec `url`, `maxChars` |
| Crédits | 1 par tâche |
| Pays | `KR` par défaut. |
| Position | Non prise en charge (`422 LOCATION_UNSUPPORTED`). |

## Recherche

```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 } }'
```

| Champ | Obligatoire | Description |
| - | - | - |
| `query` | Oui | La requête de recherche, de 1 à 100 000 caractères. `prompt` est accepté si `query` est absent. |
| `page` | Non | Page de résultats, un entier de 1 à 10. `1` par défaut. Les autres valeurs renvoient `422 VALIDATION_ERROR`. |
| `country` | Non | `KR` par défaut, le marché de Naver. |

Par exemple, la page 2 :

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

| Champ | Description |
| - | - |
| `organicResults` | Les documents de la page. `position` compte à travers les pages : le premier document de la page 2 est donc `16`. Chaque ligne porte sa `page`. |
| `notice` | Présent quand Naver masque les résultats derrière sa vérification d'âge : `{ "type": "age_verification_required", "scope": "organicResults", "message" }`. `message` cite Naver quand il est lisible. |

Un `organicResults` vide dans une tâche terminée signifie que Naver lui-même n'a renvoyé aucun document.

## Lire une page 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 } }'
```

| Champ | Obligatoire | Description |
| - | - | - |
| `action` | Oui | `page`. |
| `url` | Oui | Une adresse `https` sur `naver.com` ou l'un de ses sous-domaines. Les autres adresses renvoient `422 VALIDATION_ERROR`. |
| `maxChars` | Non | Plafonne `text`, un entier de 1 000 à 50 000. 20 000 par défaut. |

Par exemple :

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

| Champ | Description |
| - | - |
| `type` | `blog`, `cafe`, `news`, `terms`, `kin` ou `generic`. |
| `title`, `text` | Le titre et le texte du corps de la page. |
| `author`, `publishedAt`, `cafeName` | Présents quand la page les contient. |
| `images` | Jusqu'à 30 adresses d'images du corps. |
| `truncated` | `true` quand `text` a été coupé à `maxChars`. |

Les cas suivants font échouer la tâche avec `PAGE_UNAVAILABLE` et une raison : une redirection qui sort de naver.com, une page manquante (404 ou 410), un article de cafe réservé aux membres et une page sans corps lisible.

## Limites et erreurs

* `NAVER_SERP` ignore `markdown`, `rawResponse` et `searchQueries`. Il refuse `html` et `analysis` avec `422` et `citationAnalysis` avec `400` ; voir [flags non pris en charge](/fr/engines/response-options.md#flags-non-pris-en-charge).
* Les autres erreurs de requête sont listées dans [Erreurs](/fr/concepts/errors.md).

## Voir aussi

* [Naver AI Brief](/fr/engines/naver-ai-brief.md), qui renvoie aussi les documents organiques sous son résumé
* [Naver AI Tab](/fr/engines/naver-ai-tab.md)
* [Régions et position](/fr/engines/capacity.md)


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