API des résultats de recherche Naver (NAVER_SERP) - querying.ai

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

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 :

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

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 :

{
  "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.
Les autres erreurs de requête sont listées dans Erreurs.

Voir aussi

Naver AI Brief, qui renvoie aussi les documents organiques sous son résumé
Naver AI Tab
Régions et position