现已支持 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 引用的博客、社区和网站，以及你自己页面的位置。

发送请求

在 Authorization 请求头中带上 API 密钥发送请求。

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

提问所在市场的两位国家代码。默认 KR。

webhook.urlstring

你服务器上的 HTTPS 地址。任务完成后立即把结果推送到这里。

idempotencyKeystring

你为请求设定的 ID。每个键在账户内对应一个任务，因此重试发送后仍是同一个任务。

响应

完成的任务如下所示，已截取部分内容。

{
  "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 的任务。用 GET /v1/async/task/{id} 轮询，直到 status 变为 COMPLETED 或 FAILED；或者加上 webhook.url，在服务器上接收同样的 task、credits 和 response。任务结束后，结果保留 24 小时供查询。

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

价格

每个完成的任务消耗 2 个积分。