L’AI Brief de Naver est désormais pris en charge

Recevez l’AI Brief que Naver affiche au-dessus de ses résultats de recherche en Corée, avec les sources qu’il cite.

Ce que vous obtenez

• text : l’AI Brief tel que Naver le rédige.
• sources : les pages citées par l’AI Brief, avec URL, titre et description.
• Un relevé de l’apparition d’un AI Brief pour chaque requête, qui donne sa couverture sur vos mots-clés.

Fonctionnement

Naver est le premier moteur de recherche de Corée, et pour de nombreuses requêtes un AI Brief s’affiche en tête des résultats. Chaque tâche lance votre requête sur Naver et renvoie l’AI Brief et ses sources : vous voyez quelles marques et quelles pages l’IA de Naver met sous les yeux des utilisateurs coréens.

Naver décide pour chaque requête s’il affiche un AI Brief. Commencez par vos mots-clés de catégorie, d’achat et de comparaison, mesurez la fréquence d’apparition, puis lisez les mentions de marque qu’il contient.

Cas d’usage

• Suivez les mentions de marque dans l’AI Brief pour des mots-clés coréens de catégorie et d’achat.
• Repérez les blogs, communautés et sites que Naver cite, et la place de vos propres pages.

Envoyer la requête

Envoyez la requête avec votre clé API dans l’en-tête Authorization.

curl -X POST https://api.querying.ai/v1/async/task \
  -H "Authorization: Bearer $QUERYING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "taskType": "NAVER_AI_BRIEF",
    "payload": { "query": "노이즈 캔슬링 이어폰 장단점", "country": "KR" }
  }'

Champs de la requête

taskTypestringObligatoire

Le moteur à interroger, par exemple CHATGPT ou GOOGLE.

payload.querystringObligatoire

La requête, rédigée comme un utilisateur la tape dans le champ de recherche.

payload.countrystring

Code pays à deux lettres du marché d’où part la question. Par défaut KR.

webhook.urlstring

Une adresse HTTPS de votre serveur. La tâche terminée y est envoyée dès qu’elle se termine.

idempotencyKeystring

Votre identifiant pour la requête. Chaque clé crée une seule tâche par compte : un envoi répété reste une seule tâche.

Réponse

Voici une tâche terminée, raccourcie pour la lecture.

{
  "success": true,
  "task": {
    "id": "6bd9ecc8-b263-4277-8fbd-46316da041f5",
    "taskType": "NAVER_AI_BRIEF",
    "status": "COMPLETED",
    "createdAt": "2026-09-10T02:34:53.236Z"
  },
  "credits": { "creditsToCharge": 2, "creditsCharged": 2 },
  "response": {
    "text": "노이즈 캔슬링 이어폰의 장단점은 사용 목적과 이어폰의 형태에 따라 크게 달라지며, 저주파 소음 차단 능력과 착용감의 선호도가 중요합니다.",
    "sources": [
      {
        "position": 1,
        "url": "https://blog.naver.com/vitamin2230/224396484958",
        "label": "애플 에어팟 프로 2 노이즈캔슬링 무선이어폰, 실사용 6개월 솔직 장단점 비교",
        "platform": "네이버 블로그",
        "sourceName": "리원피앤아이",
        "datePublished": "2026-09-01T12:00:00+09:00"
      }
    ],
    "organicResults": [
      {
        "position": 1,
        "title": "노이즈캔슬링 이어폰 기능별 장단점 알아보기",
        "link": "https://blog.naver.com/hrgipn14/224377207212",
        "date": "2026.08.13."
      }
    ],
    "relatedQuestions": [
      "출퇴근용 노이즈 캔슬링 이어폰 추천해 주세요",
      "3만 원대 노이즈 캔슬링 이어폰 추천해 주세요"
    ]
  }
}

task.statusstring

QUEUED, PROCESSING, puis COMPLETED avec la réponse ou FAILED avec error.

credits.creditsChargedinteger

Crédits facturés pour la tâche terminée. Une tâche en échec facture 0.

response.textstring

La réponse en texte brut.

response.markdownstring

La réponse avec ses titres, listes et tableaux, dans chaque résultat.

response.sourcesarray

Les pages citées par la réponse, dans l’ordre du moteur, avec position, url et label.

response.organicResultsarray

Les documents web listés sous l’AI Brief : position, title, link, snippet et date.

response.relatedQuestionsarray

Les questions de suivi que Naver propose avec le résumé.

response.noticeobject

L’avis de Naver lorsqu’il retient une partie du résultat, comme une vérification d’âge, avec type et message.

Recevoir le résultat

La requête renvoie aussitôt la tâche avec status QUEUED. Interrogez GET /v1/async/task/{id} jusqu’à ce que status vaille COMPLETED ou FAILED, ou ajoutez webhook.url pour recevoir la tâche terminée sur votre serveur, avec les mêmes task, credits et response. Les résultats restent disponibles 24 heures après la fin de la tâche.

curl https://api.querying.ai/v1/async/task/$TASK_ID \
  -H "Authorization: Bearer $QUERYING_API_KEY"

Tarif

Chaque tâche terminée utilise 2 crédits.