네이버 AI 브리핑을 지원해요

네이버가 검색 결과 위에 보여 주는 AI 브리핑을 인용 출처와 함께 받아요.

받는 결과

• text: 네이버가 작성한 AI 브리핑 본문입니다.
• sources: AI 브리핑이 인용한 페이지를 URL, 제목, 설명과 함께 받습니다.
• 검색어마다 AI 브리핑이 나왔는지 기록되어, 키워드 세트의 브리핑 노출률을 바로 알 수 있습니다.

동작 방식

네이버는 한국에서 가장 많이 쓰는 검색 엔진이고, 많은 검색어에서 AI 브리핑이 검색 결과 맨 위에 나옵니다. 태스크마다 네이버에 검색어를 입력해 AI 브리핑과 출처를 돌려주므로, 네이버 AI가 한국 사용자에게 어떤 브랜드와 페이지를 보여 주는지 알 수 있습니다.

AI 브리핑을 보여 줄지는 네이버가 검색어마다 정합니다. 카테고리, 쇼핑, 비교 키워드부터 시작해 브리핑이 나오는 비율을 재고, 브리핑 안의 브랜드 언급을 읽어 보세요.

이렇게 활용하세요

• 한국어 카테고리, 쇼핑 키워드에서 AI 브리핑 속 브랜드 언급을 추적합니다.
• 네이버가 인용하는 블로그, 카페, 사이트와 그 사이에서 내 페이지의 위치를 확인합니다.

요청 보내기

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

질문할 시장의 두 글자 국가 코드입니다. 기본값 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 브리핑 아래에 나온 웹 문서입니다. position, title, link, snippet, date가 담깁니다.

response.relatedQuestionsarray

네이버가 브리핑과 함께 제안하는 후속 질문입니다.

response.noticeobject

네이버가 결과 일부를 보류할 때 붙이는 안내입니다. 연령 확인 등의 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"

요금

완료된 태스크마다 2크레딧이 차감됩니다.