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 사용 방법
브랜드나 주제를 보내고 감성 분포를 한 행으로 읽습니다.
- {"query": "notion"}을 /v1/brand-monitoring/sentiment에 POST합니다.
- GET /v1/tasks/{task_id}를 폴링해 status 값이 succeeded가 될 때까지 기다립니다. 범위가 넓은 검색어는 몇 분이 걸릴 수 있습니다.
- 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를 호출해 그 뒤에 있는 페이지를 직접 읽어 보세요.
관련 API
Brand Sentiment Analysis API 외에 Brand Monitoring의 다른 유형의 공개 데이터가 필요할 때 이 API를 사용하세요.
- Brand Mentions API — 브랜드, 제품, 주제를 언급한 웹 페이지를 찾아 해당 문단, 작성자, 날짜, 사이트 유형, 감성·감정 점수, 페이지와 도메인 권위도를 반환합니다.