brand-monitoring/
sentiment

웹에서 브랜드가 어떻게 이야기되는지 한 번의 요청으로 요약합니다. 페이지를 감성과 감정으로 나누고 그룹별 페이지 수와 주요 사이트·국가를 반환합니다.

Brand Sentiment Analysis API

긍정·부정·중립
여섯 가지 감정
그룹별 주요 사이트
국가와 언어 분포
요청당 10 크레딧
준비됨
준비됨

매개변수를 입력하고 요청을 전송하세요. 작업 상태와 정규화된 결과가 여기에 표시됩니다.

README

SocQ 작성 · 업데이트

Brand Sentiment Analysis

브랜드 감성이란 브랜드를 언급한 웹 페이지 전체의 논조로, 긍정·부정·중립으로 얼마나 나뉘는지, 기쁨과 애정부터 슬픔과 분노까지 어떤 감정이 두드러지는지로 표현됩니다. 각 그룹을 이루는 사이트, 국가, 언어, 사이트 유형까지 나눠 보면 비판이 뉴스 매체에서 오는지, 커뮤니티에서 오는지, 특정 시장에서 오는지 알 수 있어 평판 보고서, 캠페인 회고, 경쟁사 벤치마크에 활용할 수 있습니다.

Brand Sentiment Analysis API 주요 기능

  • 세 가지 감성 그룹sentiments는 긍정, 부정, 중립 세 그룹을 반환하며, 각 그룹의 mentions_count는 그 그룹으로 분류된 페이지 수입니다.
  • 여섯 가지 감정 범주emotions는 같은 페이지를 가장 강한 감정으로 묶습니다: 기쁨, 애정, 재미, 공유, 슬픔, 분노.
  • 그룹을 이끄는 사이트top_domains는 그룹 안에서 페이지가 가장 많은 사이트를 최대 10개까지 보여 줘 긍정·부정 대화를 어디가 주도하는지 알려 줍니다.
  • 국가, 언어, 사이트 유형countries, languages, page_types로 각 그룹 페이지의 출처를 보여 줍니다. WW는 전 세계 대상 사이트이며, 유형에는 news, blogs, message-boards 등이 있습니다.
  • 브랜드당 한 행한 번의 요청으로 검색어의 분포 전체가 반환되므로 날짜를 붙인 스냅숏으로 그대로 저장할 수 있습니다.

Brand Sentiment Analysis API 매개변수

매개변수필수설명
query필수분석할 브랜드, 제품, 주제(100자 이내). 구문을 큰따옴표로 감싸면 정확히 일치하는 결과만 분석합니다.

Brand Sentiment Analysis API 사용 방법

브랜드나 주제를 보내고 감성 분포를 한 행으로 읽습니다.

  1. {"query": "notion"}을 /v1/brand-monitoring/sentiment에 POST합니다.
  2. GET /v1/tasks/{task_id}를 폴링해 status 값이 succeeded가 될 때까지 기다립니다. 범위가 넓은 검색어는 몇 분이 걸릴 수 있습니다.
  3. results.items에서 분포를 읽습니다. has_more와 results.next_cursor는 일반 페이지 규칙을 따르며, 이 한 행짜리 결과에서는 비어 있습니다.
curl -X POST "https://api.socq.ai/v1/brand-monitoring/sentiment" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"notion"}'

Brand Sentiment Analysis API 추천 활용 사례

  • 월간 평판 스냅숏: 매달 감성 그룹별 mentions_count를 기록하고 부정 페이지 비율의 추이를 차트로 그립니다.
  • 비판의 출처 파악: 부정 그룹의 top_domains, countries, page_types를 보고 비판이 소수 사이트, 특정 국가, 커뮤니티 중 어디에 몰려 있는지 판단합니다.
  • 경쟁사 벤치마크: 자사와 경쟁사를 같은 형식의 검색어로 분석해 긍정·부정·중립 페이지 수와 주된 감정을 비교합니다.
  • 캠페인 회고: 캠페인 전후로 기쁨, 분노 같은 감정 그룹을 비교해 대화의 흐름이 어떻게 바뀌었는지 확인합니다.

Brand Sentiment Analysis API 활용 팁

  • 일반 단어보다 구체적인 제품명이나 캠페인명을 분석하세요. 언급이 수백만 건에 이르는 넓은 검색어는 완료까지 몇 분이 걸릴 수 있습니다.
  • 경쟁사 분석을 자사와 같은 날 실행하면 모든 스냅숏이 같은 시점의 웹을 반영합니다.
  • 어느 그룹의 수치가 크게 움직이면 같은 query로 Brand Mentions API를 호출해 그 뒤에 있는 페이지를 직접 읽어 보세요.

Brand Sentiment Analysis API 외에 Brand Monitoring의 다른 유형의 공개 데이터가 필요할 때 이 API를 사용하세요.

  • Brand Mentions API — 브랜드, 제품, 주제를 언급한 웹 페이지를 찾아 해당 문단, 작성자, 날짜, 사이트 유형, 감성·감정 점수, 페이지와 도메인 권위도를 반환합니다.

다른 플랫폼 둘러보기

Brand Monitoring 데이터를 지원되는 다른 소셜 플랫폼의 공개 데이터와 함께 활용하세요.

Brand Sentiment Analysis API — 자주 묻는 질문

Brand Sentiment Analysis API는 브랜드, 제품, 주제를 언급한 웹 페이지의 논조를 요약하는 API로, 긍정·부정·중립 세 그룹과 여섯 가지 감정 그룹의 페이지 수, 각 그룹의 주요 사이트, 국가, 언어, 사이트 유형을 반환합니다.

Brand Mentions API는 페이지를 한 건씩 각각의 점수와 함께 반환합니다. Brand Sentiment Analysis API는 일치한 페이지 전체를 감성과 감정으로 묶은 요약을 한 행으로 반환합니다.

기쁨, 애정, 재미, 공유, 슬픔, 분노 여섯 가지이며, 각각 독립된 그룹으로 페이지 수와 출처 분포가 함께 반환됩니다.

대부분의 검색어는 1분 안에 완료됩니다. 일치하는 페이지가 수백만 건에 이르는 넓은 검색어는 몇 분이 걸릴 수 있습니다.

요청 1건에 10크레딧이며, 한 행을 반환합니다.