NaverのAI Briefに対応しました

韓国のNaverが検索結果の上に表示するAI Briefを、引用元とともに受け取れます。

得られる結果

• text: Naverが書いたAI Briefの本文です。
• sources: AI Briefが引用したページを、URL、タイトル、説明付きで受け取れます。
• クエリごとにAI Briefが表示されたかが記録され、キーワードセットでの表示率がすぐにわかります。

仕組み

Naverは韓国最大の検索エンジンで、多くのクエリで検索結果の最上部にAI Briefが表示されます。タスクごとにNaverで検索してAI Briefと出典を返すため、NaverのAIが韓国のユーザーにどのブランドとページを見せているかがわかります。

AI Briefを表示するかどうかはNaverがクエリごとに決めます。カテゴリー、ショッピング、比較のキーワードから始めて表示率を測り、AI Brief内のブランド言及を読み解きましょう。

活用例

• 韓国語のカテゴリーやショッピングのキーワードで、AI Brief内のブランド言及を追跡できます。
• Naverが引用するブログ、コミュニティ、サイトと、その中での自社ページの位置を確認できます。

リクエストを送る

API キーを 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" }
  }'

リクエストのフィールド

taskTypestring必須

実行するエンジン。CHATGPT や GOOGLE などを指定します。

payload.querystring必須

ユーザーが検索ボックスに入力するとおりに書いた検索クエリ。

payload.countrystring

質問する市場の2文字の国コード。既定値は KR。

webhook.urlstring

サーバーの HTTPS アドレス。タスクが完了した瞬間に結果をここへ送ります。

idempotencyKeystring

リクエストに付ける独自の ID。1つのキーはアカウント内で1つのタスクを作るため、再送してもタスクは1つのままです。

レスポンス

完了したタスクはこの形で届きます。長さを抑えて抜粋しています。

{
  "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 を経て、回答付きの COMPLETED か error 付きの FAILED で終わります。

credits.creditsChargedinteger

完了したタスクに請求されたクレジット。失敗したタスクは0です。

response.textstring

回答のプレーンテキスト。

response.markdownstring

見出し、リスト、表を保った回答。すべての結果に入ります。

response.sourcesarray

回答が引用したページ。エンジンの表示順に position、url、label が入ります。

response.organicResultsarray

AI Brief の下に並ぶウェブ文書。position、title、link、snippet、date。

response.relatedQuestionsarray

Naver がブリーフとともに提案する関連質問。

response.noticeobject

年齢確認など、Naver が結果の一部を保留したときの案内。type と message。

結果を受け取る

リクエストすると status が QUEUED のタスクがすぐに返ります。status が COMPLETED か FAILED になるまで GET /v1/async/task/{id} で取得するか、webhook.url を指定して同じ task、credits、response をサーバーで受け取ります。結果はタスクの完了から24時間取得できます。

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

料金

完了したタスク1件につき2クレジットを使用します。