Brand Monitoring API
브랜드, 제품, 주제를 언급한 웹 페이지를 찾아 페이지마다 감성과 감정을 점수로 매기고, 웹 전체에서 어떻게 이야기되는지 요약합니다.
사용할 수 있는 Brand Monitoring API
감성·권위도 점수가 붙은 페이지 단위 근거가 필요하면 Brand Mentions API를, 감성과 감정으로 나눈 요약 한 행이 필요하면 Brand Sentiment Analysis API를 사용합니다.
어떤 브랜드 모니터링 데이터를 가져올 수 있나요?
두 API는 같은 색인 웹 페이지를 대상으로 하며, 하나는 페이지 자체를, 다른 하나는 그 요약을 반환합니다.
웹 페이지 속 언급
페이지 제목, URL, 언급 주변 문단, 작성자, 도메인, 언어, 국가, 게시일 또는 수집일.
감성과 감정
합이 1인 긍정·부정·중립 비율과 기쁨, 애정, 재미, 공유, 슬픔, 분노의 0~1 점수.
권위도와 품질
0~1000의 도메인·페이지 순위와 0~100의 스팸 점수, 콘텐츠 품질 점수.
사이트 유형
각 페이지가 뉴스, 블로그, 커뮤니티, 쇼핑몰 페이지, 기관 사이트 중 무엇인지.
감성 분포
감성 그룹과 감정 그룹별 페이지 수, 그리고 그룹마다의 주요 도메인, 국가, 언어, 페이지 유형.
Brand Mentions와 Brand Sentiment Analysis 선택
전체 그림과 그 뒤의 페이지가 모두 필요하면 같은 query로 두 API를 함께 실행하세요.
| 비교 항목 | Brand Mentions API | Brand Sentiment Analysis API |
|---|---|---|
| 결과 | 웹 페이지마다 한 행 | query마다 요약 한 행 |
| 감성 | 각 페이지 문단의 점수 | 감성 그룹·감정 그룹별 페이지 수 |
| 출처 | 페이지별 도메인, 작성자, 사이트 유형, 권위도 | 그룹별 주요 도메인, 국가, 언어, 페이지 유형 |
| 지정 조건 | query, content_type, 최대 1,000의 results_limit | query |
| 비용 | 요청 1건 10크레딧 + 페이지당 0.02크레딧 | 요청 1건 10크레딧 |
Brand Monitoring API 작동 방식
두 API 모두 같은 비동기 작업 흐름을 사용합니다.
1. query 보내기
브랜드, 제품, 주제를 /v1/brand-monitoring/mentions 또는 /v1/brand-monitoring/sentiment에 POST합니다.
2. 작업 추적
GET /v1/tasks/{task_id}를 폴링해 status 값이 succeeded가 될 때까지 기다립니다. 범위가 넓은 검색어는 몇 분이 걸릴 수 있습니다.
3. 결과 읽기
results.items에서 페이지 목록이나 요약 행을 읽습니다.
SocQ API 키로 인증하고 브랜드 이름을 보냅니다. 요청 1건에 10크레딧, 반환된 페이지 1개당 0.02크레딧이 추가됩니다.
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}'
# Poll GET /v1/tasks/{task_id}
# Read the mentions in results.itemsBrand Monitoring API 주요 활용 사례
평판 모니터링
권위도가 높은 페이지의 부정적인 문단을 찾아 먼저 검토합니다.
언론 보도 추적
출시나 발표 후 뉴스 언급을 작성자, 날짜, 도메인 순위와 함께 모읍니다.
경쟁사 벤치마크
자사와 경쟁사의 감성, 감정, 출처 구성을 비교합니다.
커뮤니티 의견 수집
사용자가 자기 말로 제품을 이야기하는 커뮤니티 스레드를 모읍니다.
캠페인 회고
캠페인 전후의 감성 그룹과 감정 그룹을 비교합니다.
요청 규칙과 비용
다음 규칙은 두 Brand Monitoring API에 공통으로 적용됩니다.
- query에는 100자 이내의 브랜드, 제품, 주제를 넣으며, 구문을 큰따옴표로 감싸면 정확히 일치하는 결과만 찾습니다.
- Brand Mentions API의 content_type은 news, blogs, message-boards, ecommerce, organization 중에서 고를 수 있고, 요청 1건에 1~1,000페이지(기본 100)를 반환합니다.
- 대부분의 감성 요약은 1분 안에 완료되며, 일치하는 페이지가 수백만 건인 넓은 검색어는 몇 분이 걸릴 수 있습니다.
- Brand Mentions API는 요청 1건에 10크레딧과 반환된 페이지 1개당 0.02크레딧, Brand Sentiment Analysis API는 요청 1건에 10크레딧입니다.
Brand Monitoring API 자주 묻는 질문
Brand Monitoring API란 무엇인가요?
Brand Monitoring API는 브랜드, 제품, 주제를 언급한 웹 페이지를 찾아 감성을 측정하는 API로, Brand Mentions API로 페이지별 결과를, Brand Sentiment Analysis API로 요약 한 행을 받을 수 있습니다.
어떤 Brand Monitoring API를 사용할 수 있나요?
페이지마다 감성, 감정, 권위도 점수를 반환하는 Brand Mentions API와, 일치한 페이지 전체의 감성·감정 분포를 반환하는 Brand Sentiment Analysis API입니다.
어떤 웹사이트가 포함되나요?
뉴스 기사, 블로그, 커뮤니티, 쇼핑몰 페이지, 기관 사이트 등 색인된 공개 웹 페이지입니다.
감성은 어떻게 측정하나요?
각 언급 주변의 문단을 긍정·부정·중립과 여섯 가지 감정으로 평가하며, 감성 요약은 이 점수로 페이지를 그룹화합니다.
Brand Monitoring 요청 비용은 어떻게 되나요?
Brand Mentions API는 요청 1건에 10크레딧과 반환된 페이지 1개당 0.02크레딧, Brand Sentiment Analysis API는 요청 1건에 10크레딧입니다.
여러 플랫폼의 데이터를 결합해 더 폭넓은 비즈니스 인사이트를 얻으세요
여러 플랫폼의 공개 프로필, 콘텐츠, 참여도 데이터를 하나의 워크플로로 모으면 브랜드, 크리에이터, 주제를 추적하고 플랫폼 간 모니터링과 분석을 더 효율적으로 진행할 수 있습니다.
AI Search API
AI 개요, ChatGPT, Google AI 모드가 시장의 질문에 어떻게 답하는지 추적합니다. 브랜드를 언급한 답변, 브랜드의 노출 수준, 답변이 인용한 도메인과 페이지를 알 수 있습니다.
Instagram API
공개 프로필을 조회하거나 찾고, 팔로워 목록 레코드, 팔로잉 관계, 작성 게시물, 프로필이 태그된 게시물, 해시태그 결과, 릴스, 스크립트, 댓글, 계정 수치, 참여도 지표, 미디어 메타데이터를 하나의 비동기 워크플로로 수집합니다.
TikTok API
지원하는 공개 TikTok 프로필, 개별 동영상 메타데이터, 최상위 댓글, 동영상 검색 결과, 지정한 해시태그의 동영상을 하나의 정규화된 비동기 워크플로로 수집합니다.
YouTube API
지원되는 공개 YouTube 채널 프로필, 동영상 상세 정보, 채널 동영상, 댓글, 쇼츠, 키워드·해시태그 결과, 제공되는 스크립트를 하나의 정규화된 비동기 워크플로로 수집합니다.
Facebook API
공개 Facebook 페이지 프로필, 게시물, 그룹 게시물, 댓글, 키워드에 일치하는 이벤트, 가져올 수 있는 동영상 스크립트를 수집합니다. 식별 정보, 콘텐츠, 출처, 형식, 장소, 미디어, 반응, 참석, 참여도 필드는 정규화되어 제공됩니다.
X API
공개 프로필, 팔로워·팔로잉 관계, 게시물, 답글, 인용, 리포스트한 사용자, 검색 결과, 현재 트렌드를 수집합니다. 일관된 결과를 리서치와 모니터링에 활용하세요.

