Brand Mentions
브랜드 언급이란 리뷰, 뉴스 기사, 커뮤니티 스레드, 상품 페이지처럼 본문에 브랜드 이름이 등장하는 공개 웹 페이지로, 이름 주변의 문단, 작성자, 언어, 국가, 게시일이 함께 따라옵니다. 여기에 감성 점수를 매기고 페이지와 도메인 권위도로 순위를 매기면 브랜드가 어디서 이야기되고, 대화가 어느 쪽으로 기울며, 어떤 출처가 영향력을 갖는지 보여 평판 모니터링, PR 성과 측정, 경쟁사 조사에 활용할 수 있습니다.
Brand Mentions API 주요 기능
- 키워드 검색과 정확히 일치query에 100자 이내의 브랜드, 제품, 주제를 넣을 수 있고, 구문을 큰따옴표로 감싸면 그 문구 그대로 일치시킬 수 있습니다.
- 사이트 유형으로 필터링content_type으로 news, blogs, message-boards, ecommerce, organization 중 하나로 좁힐 수 있으며, 각 결과의 page_types에도 사이트 유형이 표시됩니다.
- 문단별 감성 점수sentiment는 긍정·부정·중립의 합이 1이 되는 점수이고, emotions는 기쁨, 애정, 재미, 공유, 슬픔, 분노 여섯 가지를 0~1로 나타냅니다.
- 권위도와 품질 지표domain_rank와 page_rank는 0~1000으로 권위도를 나타내고, spam_score와 content_quality_score로 내용이 빈약하거나 스팸성인 페이지를 걸러낼 수 있습니다.
- 언급의 맥락title, text의 해당 문단, author_name, language, country, 게시일이 있으면 published_at, 그리고 fetched_at으로 언급이 언제 어디서 쓰였는지 알 수 있습니다.
- 한 번에 최대 1,000페이지results_limit은 1~1000으로 지정할 수 있어 브랜드의 웹 노출을 한 번에 점검할 수 있습니다.
Brand Mentions API 매개변수
| 매개변수 | 필수 | 설명 |
|---|---|---|
query | 필수 | 찾을 브랜드, 제품, 주제(100자 이내). 구문을 큰따옴표로 감싸면 정확히 일치하는 결과만 찾습니다. |
content_type | 선택 | 언급을 가져올 사이트 유형: news, blogs, message-boards, ecommerce, organization. |
results_limit | 선택 | 반환할 페이지 수(1~1000). 기본값은 100입니다. |
Brand Mentions API 사용 방법
브랜드나 제품 이름을 보내고 언급을 한 행씩 읽습니다.
- {"query": "notion", "results_limit": 100}을 /v1/brand-monitoring/mentions에 POST합니다.
- GET /v1/tasks/{task_id}를 폴링해 status 값이 succeeded가 될 때까지 기다립니다.
- results.items에서 페이지를 읽고, has_more가 true이면 results.next_cursor로 다음 페이지를 가져옵니다.
curl -X POST "https://api.socq.ai/v1/brand-monitoring/mentions" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query":"notion","results_limit":100}'Brand Mentions API 추천 활용 사례
- 평판 모니터링: sentiment.negative가 긍정 점수보다 높은 문단을 골라내고, 페이지의 domain_rank와 함께 우선순위를 정해 검토합니다.
- 언론 보도 추적: content_type을 news로 설정해 author_name, published_at, domain_rank를 기록하고, 어떤 매체가 어느 정도의 영향력으로 신제품을 다뤘는지 파악합니다.
- 브랜드 간 비교: 자사와 경쟁사에 같은 요청을 실행해 언급의 사이트 유형, 국가, 감성 분포를 비교합니다.
- 커뮤니티 의견 수집: content_type을 message-boards로 좁혀 사용자가 자기 말로 제품을 이야기하는 스레드를 모읍니다.
Brand Mentions API 활용 팁
- 여러 단어로 된 브랜드 이름은 "notion ai"처럼 큰따옴표로 감싸면 정확한 구문으로 일치시킬 수 있습니다.
- 최신성을 판단할 때는 published_at을 우선하고, 없으면 fetched_at을 사용하세요. 게시일이 없는 페이지도 많습니다.
- 감성을 집계하기 전에 spam_score가 높거나 content_quality_score가 낮은 행을 제외하면 빈약한 페이지가 결과를 왜곡하지 않습니다.
- 페이지별 상세와 전체 비율이 모두 필요하다면 Brand Sentiment Analysis API와 함께 사용하세요.
관련 API
Brand Mentions API 외에 Brand Monitoring의 다른 유형의 공개 데이터가 필요할 때 이 API를 사용하세요.
- Brand Sentiment Analysis API — 브랜드나 주제가 웹에서 어떻게 이야기되는지 한 행으로 요약해 감성과 감정별 페이지 수와 그룹마다의 주요 도메인, 국가, 언어를 반환합니다.