El AI Brief de Naver ya está disponible

Recibe el AI Brief que Naver muestra encima de sus resultados de búsqueda en Corea, con las fuentes que cita.

Qué obtienes

• text: el AI Brief tal como lo redacta Naver.
• sources: las páginas que cita el AI Brief, con URL, título y descripción.
• Un registro de si apareció un AI Brief en cada consulta, que te da su cobertura en tus palabras clave.

Cómo funciona

Naver es el mayor buscador de Corea, y en muchas consultas un AI Brief aparece en lo más alto de los resultados. Cada tarea busca tu consulta en Naver y devuelve el AI Brief y sus fuentes, para que veas qué marcas y páginas pone la IA de Naver delante de los usuarios coreanos.

Naver decide en cada consulta si muestra un AI Brief. Empieza por tus palabras clave de categoría, compra y comparación, mide con qué frecuencia aparece y luego lee las menciones de marca que contiene.

Para qué sirve

• Sigue las menciones de marca en el AI Brief para palabras clave coreanas de categoría y compra.
• Descubre los blogs, comunidades y sitios que cita Naver y dónde quedan tus propias páginas.

Envía la solicitud

Envía la solicitud con tu clave de API en la cabecera 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" }
  }'

Campos de la solicitud

taskTypestringObligatorio

El motor que se ejecuta, como CHATGPT o GOOGLE.

payload.querystringObligatorio

La búsqueda, escrita como la teclea un usuario en el buscador.

payload.countrystring

Código de país de dos letras del mercado desde el que se pregunta. Por defecto KR.

webhook.urlstring

Una dirección HTTPS de tu servidor. La tarea terminada se envía allí en cuanto se completa.

idempotencyKeystring

Tu propio ID para la solicitud. Cada clave crea una sola tarea por cuenta, así que un reenvío sigue siendo una sola tarea.

Respuesta

Así llega una tarea terminada, recortada para que se lea mejor.

{
  "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 y al final COMPLETED con la respuesta o FAILED con error.

credits.creditsChargedinteger

Créditos cobrados por la tarea terminada. Una tarea fallida cobra 0.

response.textstring

La respuesta en texto plano.

response.markdownstring

La respuesta con sus títulos, listas y tablas, en cada resultado.

response.sourcesarray

Las páginas que cita la respuesta, en el orden del motor, con position, url y label.

response.organicResultsarray

Los documentos web listados bajo el AI Brief: position, title, link, snippet y date.

response.relatedQuestionsarray

Las preguntas de seguimiento que Naver sugiere con el resumen.

response.noticeobject

El aviso de Naver cuando retiene parte del resultado, como una verificación de edad, con type y message.

Recibe el resultado

La solicitud devuelve la tarea al instante con status QUEUED. Consulta GET /v1/async/task/{id} hasta que status sea COMPLETED o FAILED, o añade webhook.url y la tarea terminada llega a tu servidor con los mismos task, credits y response. Los resultados siguen disponibles 24 horas después de terminar la tarea.

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

Precio

Cada tarea completada usa 2 créditos.