100 크레딧 무료, 카드 등록 없이지금 시작하기
Logo
Back to blog

댓글 감정분석 API, 질문·구매의도·불만까지 한 번에

··13 min read

TikTok, 인스타그램, 유튜브, 레딧, X, 페이스북 댓글을 가져오면 감성, 질문, 구매의도, 불만 라벨이 같이 와요. 추가 크레딧 없이 쓰는 텍스트 감정분석 API예요.

댓글 감정분석 API, 질문·구매의도·불만까지 한 번에

SNS 댓글을 분석하려고 감정분석 API를 따로 붙일 필요는 없어요. SocialCrawl에서 댓글 목록을 부르면 댓글마다 감성 단계와 질문, 구매의도, 불만일 확률이 같이 와요. 크레딧은 더 들지 않아요. 라벨이 필요 없으면 judgments=off를 붙여서 끄면 돼요.

이미 가진 텍스트에 점수만 매기려는 거라면 아래 구글, AWS, Azure 비교부터 보세요. 이 방식은 댓글 수집부터 해야 하는 분께 맞아요.

댓글이 API 파이프라인을 지나며 감성, 질문, 구매의도, 불만 라벨을 받는 그림. 텍스트 감정분석 API 결과가 평소 댓글 호출에 그대로 얹혀 와요.

댓글 API 호출 하나로 감정분석까지 되나요?

네. 댓글마다 computed.labels 블록이 붙어요. 댓글 언어를 알려 주는 computed.language도 함께 와요. 평소처럼 댓글을 부르면 돼요.

bash
curl "https://www.socialcrawl.dev/v1/tiktok/post/comments?url=https://www.tiktok.com/@stoolpresidente/video/7623818255903329566" \
  -H "x-api-key: $SOCIALCRAWL_API_KEY"

댓글 하나를 필요한 필드만 남겨서 보면 이래요.

json
{
  "comment": { "text": "Ordering it for my 13 year old ❤️" },
  "computed": {
    "language": "en",
    "labels": {
      "sentiment": { "level": 4, "score_0_1": 0.91, "confidence": 0.71 },
      "question": { "p": 0.03 },
      "purchase_intent": { "p": 0.98 },
      "complaint": { "p": 0.02 }
    }
  }
}
라벨값뜻
sentimentlevel 0~4, score_0_1, confidence댓글의 느낌이에요. 0은 매우 부정, 4는 매우 긍정이에요
questionp 0~1진짜 질문일 확률이에요. 비꼬거나 불평하는 수사 의문문은 질문으로 치지 않아요
purchase_intentp 0~1샀다, 주문했다, 갈아탄다, 링크나 가격을 묻는다 같은 신호예요. "살 만한가요?"는 해당하지 않아요
complaintp 0~1글쓴이에게 실제로 일어난 문제예요. 가격이나 스펙을 비판하는 말은 해당하지 않아요

확률은 가공하지 않은 값으로 와요. 기준값은 목적에 맞게 직접 정하세요. 판정하지 못한 댓글은 labels: null로 와요. 확률이 낮다는 표시가 아니에요. 필드 전체는 라벨 문서에 있어요.

어떤 플랫폼과 엔드포인트에서 쓸 수 있나요?

TikTok, 인스타그램, 유튜브, 레딧, X(트윗 답글), 페이스북의 댓글 목록 엔드포인트와 답글 엔드포인트에서 써요. 자주 쓰는 엔드포인트는 이래요.

엔드포인트페이지당 크레딧
tiktok/post/comments1
youtube/video/comments1
twitter/tweet/replies1
instagram/post/comments5
reddit/post/comments5

전체 목록은 라벨 문서에 있어요. 파라미터는 TikTok 댓글과 인스타그램 댓글 페이지에서 확인하세요.

라벨이 붙으면 크레딧이 더 드나요?

아니요. 위 네 가지 라벨은 모든 댓글 호출에 무료로 붙어요. 라벨이 생기기 전과 요금이 같아요. judgments=off로 computed.labels, data.label_share, data.comment_language를 응답에서 빼도 요금은 그대로예요.

label=로 따로 요청하는 spam, toxic, low_quality는 유료예요. 호출할 때 크레딧을 조금 잡아 두었다가 새로 판정한 댓글 25개 단위로 1크레딧만 남기고 돌려줘요.

댓글 페이지 전체의 분위기는 어떻게 숫자로 보나요?

댓글 목록 응답에는 data.label_share도 와요. 댓글별 라벨을 페이지 단위 숫자로 묶어 준 값이에요. 라벨마다 판정된 댓글 중 비율, 90% 신뢰구간, 근거가 되는 원문 댓글 최대 3개가 들어 있어요.

json
{
  "n": 49,
  "counted": 36,
  "abstained": 6,
  "share": 0.8372,
  "low": 0.7252,
  "high": 0.9093,
  "too_few": false
}

문서에 실린 TikTok 예시의 긍정 감성 항목이에요. n은 살펴본 댓글 수이고 abstained는 어느 쪽인지 판정하지 못한 댓글 수예요. share는 counted를 n에서 abstained를 뺀 값으로 나눈 비율이에요. 답글 스레드 하나를 부르면 "이 스레드가 얼마나 부정적인지, 그 숫자를 얼마나 믿어도 되는지"까지 한 번에 나와요.

폭이 넓은 신뢰구간 게이지와 좁은 게이지를 나란히 놓은 그림. 표본이 적으면 감정분석 API가 대표 비율을 내지 않는 이유를 보여줘요.

댓글이 너무 적으면 어떻게 되나요?

대표 비율을 내주지 않아요. 90% 신뢰구간 폭이 0.25를 넘으면 share는 null, too_few는 true로 와요. 판정된 댓글이 두 개뿐인데 퍼센트를 찍어 주면 그 숫자가 근거 없이 믿음직해 보이니까요. 대략적인 범위가 필요하면 low와 high를 보세요.

판정하지 못한 댓글은 "아니오"에 넣지 않고 abstained로 따로 세요.

최신 댓글만, 또는 더 많이 읽을 수 있나요?

TikTok과 인스타그램에서 돼요. scan_pages(1~3, 기본 1)를 올리면 여러 페이지를 읽고 중복을 없앤 뒤 한꺼번에 돌려줘요. 과금은 새 댓글이 들어 있는 페이지에만 해요. TikTok은 페이지당 1크레딧, 인스타그램은 5크레딧이에요. data.scan에 읽은 페이지 수, 과금된 페이지 수, 스레드 끝까지 읽었는지가 담겨요.

sort=recent는 최신순으로 정렬해요. TikTok에는 최신순 댓글 순서가 따로 없어서 읽은 댓글 안에서만 정렬해요. 스레드 전체를 봤다고 말하기 전에 data.scan.complete를 확인하세요. 실시간 스트림은 없어요. 호출할 때마다 새로 읽는 폴링 방식이에요.

comment_language로 오디언스 국가를 알 수 있나요?

알 수 없어요. data.comment_language는 그 페이지 댓글의 언어 구성만 보여 줘요. 국가 정보는 없어요. TikTok 오디언스 지역이 궁금하면 prism/audience-language를 보세요.

구글, AWS, Azure 감정분석 API와는 뭐가 다른가요?

Google Cloud Natural Language, AWS Comprehend, Azure AI Language는 보낸 텍스트에 점수를 매기는 서비스예요. 요금도 텍스트 양 기준이에요. 댓글을 가져오지는 않아서 SNS 댓글을 분석하려면 수집 단계와 점수 단계를 직접 이어야 해요.

SocialCrawl은 위 플랫폼의 댓글을 가져오면서 라벨까지 붙여요. 가진 문장을 보내서 분석받는 API는 아니에요. 상품 리뷰 감성은 다른 엔드포인트가 맡아요. 비교는 리뷰 감성분석 API 글에 있어요.

어떻게 시작하나요?

가입하면 API 키와 시작 크레딧이 나와요. SDK 없이 curl 한 줄이면 첫 호출이 돼요.

bash
curl "https://www.socialcrawl.dev/v1/youtube/video/comments?url=https://www.youtube.com/watch?v=VIDEO_ID" \
  -H "x-api-key: $SOCIALCRAWL_API_KEY"

코드를 쓰기 전에 응답 모양을 보고 싶다면 비주얼 익스플로러를 열어 보세요. 댓글 수집 자체가 처음이면 유튜브 댓글 크롤링 글이 페이지 넘기는 방법부터 설명해요. 스레드 하나를 통째로 읽으려면 prism/comments를 쓰세요. X, Threads, LinkedIn 게시물 링크도 받아요. 라벨은 호출 한 번에 새 댓글 100개까지 똑같이 네 가지가 붙어요. 구매의도 댓글을 잠재 고객으로 넘기는 방법은 소셜 리스닝 리드 API에 있어요.

자주 묻는 질문

SocialCrawl 댓글 감정분석에는 추가 요금이 붙나요?

아니요. 기본 라벨 네 개는 모든 댓글 호출에서 무료예요. 라벨이 있든 없든 요금은 같아요. judgments=off를 붙이면 응답에서 빠져요.

label_share는 무엇을 보여주나요?

라벨마다 판정된 댓글 중 비율을 알려 줘요. 표본 수, 판정하지 못해 뺀 댓글 수, 90% 신뢰구간도 같이 와요. 구간 폭이 0.25를 넘으면 share는 null이고 too_few는 true예요.

comment_language로 오디언스가 어느 나라 사람인지 알 수 있나요?

알 수 없어요. 언어 구성이지 국가가 아니에요. TikTok에서는 prism/audience-language가 팔로워 지역 표본을 더해 줘요.

TikTok이나 인스타그램 댓글을 최신순으로 볼 수 있나요?

네. sort=recent를 쓰고 scan_pages(1~3)를 올려 더 많이 읽으세요. TikTok은 읽은 댓글 안에서만 정렬하니 data.scan.complete를 확인하세요. 반복 댓글뿐인 페이지는 과금되지 않아요.

어떤 플랫폼에서 댓글 라벨을 쓸 수 있나요?

TikTok, 인스타그램, 유튜브, 레딧, X(트윗 답글), 페이스북의 댓글과 답글 엔드포인트에서 써요.

Topics
#텍스트-감정분석-api#ai-감정-분석#텍스트-감정-분석-ai#sentiment-analysis-감성분석#구글-감정-분석-api#한국어-감정분석-api

함께 읽으면 좋은 글

🤖 AI agent or LLM? Read this page as markdown