소셜 리스닝 리드 API, 14건 전부가 구매자는 아니에요

소셜 리스닝 리드 API로 2026년 10월 12일에 피그마 대안 댓글을 호출했어요. 응답은 판정 댓글 25개, 리드 0건, 청구 3크레딧이었어요. 같은 날 이어서 호출한 비타민 세럼 댓글 14건 전부가 구매자는 아니에요.

웹 페이지 리드, 핸들 언급, 브랜드 언급도 0시 47분(KST)에 한 번씩 호출했어요. 호스트는 https://www.socialcrawl.dev예요. 도구 순위를 매긴 글은 아니에요. 청구액은 응답의 credits_used만 보면 돼요. 하위 호출을 더한 값이 아니에요.

사고 싶다는 댓글은 어떻게 리드로 남나요?

GET /v1/prism/comment-leads는 틱톡 검색으로 글을 고른 뒤, 연 글의 댓글만 읽어요. 리드로 남는 기준은 purchase_intent 0.5 이상, spam 0.5 미만, fits_offer 0.5 이상이에요. 댓글 감성 라벨 자체를 풀어 쓴 글은 질문·구매의도까지 잡는 텍스트 감정분석 API예요.

GET /v1/prism/comment-leads?query=figma%20alternative&offer=A%20collaborative%20interface%20design%20tool%20for%20product%20teams.&posts=30&open=1&comments_per_post=25

posts=30, open=1, comments_per_post=25. offer 문장은 "A collaborative interface design tool for product teams."예요. 한국어 문장으로 바꾸면 리드가 몇 건이 되는지는 이번 호출에 없어요.

HTTP 200이었어요. 검색한 글 30, 연 글 1, 판정한 댓글 25, 리드 0. 잡아 둔 크레딧 3, 환불 0, 청구 3. credits_per_lead는 null이에요. 리드가 0이라 나누지 않아요. naive_credits_estimate는 25예요. 청구 3과 비교한 22는 그 추정과의 차이고 되돌려 받은 크레딧이 아니에요. 댓글이 있다고 보고된 글을 다 열었을 때의 추정이에요.

연 글은 보고된 댓글 78, buyer_comments 0.8이에요. 그 틱톡에서 댓글 25개만 가져왔고 규칙을 통과한 댓글은 없었어요. 그래서 작성자 이름도, 댓글 본문도, 댓글별 확률도 응답에 없어요.

댓글 68개에 buyer_comments 0.3인 글은 게이트는 통과했는데 open=1이라 열리지 않았어요. 그 글이에요. 댓글 63개, buyer_comments 0.11인 글은 이유가 달라요. 게이트 미달이라 닫혔어요. 이번 0건을 틱톡에 구매자가 없다는 뜻으로 읽으면 안 돼요. 이 쿼리, 이 open의 결과예요.

경고는 post_gate_partial 하나예요. 댓글 9개가 보고됐는데 게이트가 null인 글 1개가 over_open_limit로 빠졌어요. include=askers는 보내지 않아서 askers 배열도 없어요. 하위 호출 두 개의 credits_used를 더하면 2예요. 나머지 1크레딧은 comment_labels예요. 청구는 3이에요.

세럼은 같은 날 1시 2분(KST)에 이어서 호출했어요. 피그마 0건과 3크레딧은 바꾸지 않아요.

GET /v1/prism/comment-leads?query=vitamin%20c%20serum%20acne&offer=A%20vitamin%20C%20serum%20for%20acne.&posts=20&open=5&comments_per_post=30

offer는 "A vitamin C serum for acne."예요. 잡아 둔 크레딧 12, 환불 1, 청구 11. 12를 잡을 때 라벨은 댓글 150개, 6크레딧으로 계산했어요. 실제 판정은 117개라 라벨은 5크레딧이에요. 검색 1크레딧과 댓글 5크레딧은 그대로예요. 검색한 글 20, 연 글 5, 판정 댓글 117, 리드 14.

경고도 post_gate_partial이에요. 14건 중 10건은 게이트 객체가 없는 글에서 나왔어요. 보고된 댓글 21, 가져온 댓글 12, 리드 10인 그 글이에요. 보고된 댓글 161개인 글은 30개만 가져왔고 리드는 0이었어요. 그 글의 buyer_comments는 0.87이에요. open=5라서 buyer_comments 0.77에서 0.9인 글 7개도 열리지 않았고 댓글이 0인 글은 8개예요.

응답은 14행 모두 kind를 buyer로 적었어요. 그 칸만 보고 14명이 사겠다고 보면 안 돼요. 14건 중 10건은 본문에 price나 prix가 있거나 본문 전체가 pp예요. pp만 있는 댓글은 3건이고 그 3건은 10건 안에 있어요. purchase_intent는 0.52에서 0.93, spam 최대는 0.14, fits_offer 최소는 0.55예요. 짧은 글도 확률 규칙은 통과했어요.

price나 pp가 아닌 예는 @lifeewithalliee예요. 게이트가 없던 10건이 아니라, buyer_comments 0.91인 다른 글의 댓글이에요. 2026-10-09 23:14 UTC, 좋아요 0. "Adding to my cart!!" purchase_intent 0.93, question 0.02, spam 0.04, fits_offer 0.8. 이 댓글 본문에 이메일은 없었어요.

{
  "text": "Adding to my cart!!",
  "author": { "username": "lifeewithalliee" },
  "kind": "buyer",
  "likes": 0,
  "labels": {
    "purchase_intent": 0.93,
    "question": 0.02,
    "spam": 0.04,
    "fits_offer": 0.8
  }
}

하위 호출의 credits_used 합은 6이고 청구는 11이에요. 라벨 5크레딧은 economics에만 있어요.

구매 후보는 어떤 순서로 올라오나요?

GET /v1/prism/leads는 경쟁 제품 이름과 offer로 웹 페이지를 모아 lead_score 순으로 돌려요. 연락할 소셜 핸들을 붙여 주는 호출이 아니에요.

GET /v1/prism/leads?competitor=figma&product_category=design%20tool&offer=A%20collaborative%20interface%20design%20tool%20for%20product%20teams.&limit=20&freshness=30d

리스트 가격은 50이에요. coverage가 1/3이고 partial_failure가 true라 청구는 25예요. 본문에 refunded 필드는 없어요. 50을 이 호출의 비용으로 적으면 안 돼요. 하위 호출 다섯 개는 모두 HTTP 200인데, 그 credits_used를 더하면 61이에요. 61은 실제로 빠진 크레딧이 아니에요.

유지한 페이지는 20, dropped_ids는 36이에요. 20행 모두 author_handle이 null이고 engagement도 null이에요. Reddit 주소 7개는 버린 쪽에 있어요. 유지한 피드에는 Reddit도 Hacker News도 없어요.

쓴 문구는 alternative to figma, figma vs, switching from figma예요. counts_by_phrase 세 값은 null이에요. 0건이 아니에요. 유지한 행의 phrase_matched는 switching from figma 10, figma vs 7, alternative to figma 3이에요.

1위 점수는 0.405, 라벨은 uncertain이에요. 제목은 "Why Notion is the #1 Notes & Productivity Application"이고 도메인은 colorless.id예요. 문구는 switching from figma, about 0.77, fits_offer 0.6, seller 0.13이에요. 점수가 높다고 피그마를 떠난 사람이 아니에요. asking_for_recommendation도 switching_away도 한 행도 없어요. 갈아탄 글을 읽는 쪽은 경쟁사 분석, 갈아탄 고객의 글부터 읽어요에 따로 있어요.

2위 0.368, 3위 0.357은 Canva 좌석 가격 글이고 라벨은 comparing_options예요. 유지한 20개 중 6개가 saastruecost.com이에요. published_at은 전부 2026-10-11 12:02부터 15:43 UTC예요. freshness 창은 2026-09-11에 시작하지만 이 20건을 30일치 발행으로 보면 안 돼요.

{
  "lead_score": 0.405,
  "phrase_matched": "switching from figma",
  "author_handle": null,
  "title": "Why Notion is the #1 Notes & Productivity Application",
  "intent": {
    "label": "uncertain",
    "about": 0.77,
    "fits_offer": 0.6,
    "seller": 0.13
  }
}

라벨은 news_or_discussion 7, comparing_options 6, uncertain 4, other 2, promoting 1이에요. 이 20행만의 개수예요.

핸들 언급은 첫 페이지만 나오나요?

GET /v1/prism/mentions에 handle=figma를 보냈어요. 앞에 @는 없어요. platforms=twitter만 보내서 청구는 1크레딧이에요. 플랫폼을 비우면 보류가 3인데, 이번엔 트위터 하위 호출 하나라 1이었어요.

GET /v1/prism/mentions?handle=figma&platforms=twitter

20행, 모두 트위터예요. mention 19, reply 1, 작성자 17명. 본문에 @figma가 있는 행은 20이에요. 시각은 2026-10-11 13:37부터 15:41 UTC예요. 각 검색의 첫 페이지예요. 멘션 총량이 아니에요.

dropped_unverified는 빈 객체예요. 필드가 빠진 것도 아니고 안에 플랫폼별 건수가 적힌 것도 아니에요. 0건으로 집계된 결과가 아니에요.

not_covered는 9개예요. 요청이 트위터뿐이어도 같이 와요. Facebook, Threads, TikTok은 검색하지 않아요. 아직 모르는 글의 인스타그램 댓글, 인스타그램 캡션 언급, Bluesky, LinkedIn, 비공개이거나 지워진 글, 전체 인덱스도 이번 범위 밖이에요.

as_if_so의 mention, 15:41 UTC. "Folder - Hover animation Made in @figma and @motiondotdev"

hellonearthis의 reply, 15:25 UTC. "@figma @grok review this product, be honest and blunt"

확인한 행의 matched_url은 null이에요.

같은 철자의 브랜드 언급은 빠지나요?

빠지지 않아요. GET /v1/prism/brand-mentions는 키워드에 점수를 붙이고 낮은 행을 recent_mentions에서 빼지 않았어요.

GET /v1/prism/brand-mentions?keyword=figma&date_from=2026-09-12&date_to=2026-10-12&brand_description=Figma%20is%20a%20collaborative%20interface%20design%20tool%20for%20product%20teams.

brand_description은 "Figma is a collaborative interface design tool for product teams."예요. 청구는 50크레딧이에요.

total_count 3,931,232는 전체 기간, 모든 페이지 종류를 합친 수예요. 응답 문구는 all-time, all page types예요. Brandwatch가 KPI로 적는 언급량하고는 다른 숫자예요. 2026-09-12부터 2026-10-12까지의 창도 아니고 about_brand로 거른 수도 아니에요.

트렌드 하위 호출 /v1/content_analysis/phrase-trends는 HTTP 400이었고 credits_used는 0이에요. 그래서 windowed_total_count는 0, 타임라인은 비었어요. volume_direction이 flat이라는 문자열이어도 버킷이 0개인 빈 창이에요. 한 달 언급이 평평했다는 측정이 아니에요. 하위 호출의 credits_used 합은 40인데 청구는 50이에요. 실패한 호출이 데이터 하위 호출 세 개의 과반이 아니라서 50이 반으로 줄지 않았어요.

최근 20행은 전부 판정됐어요. about_brand 0.5 이상이 4행, 미만이 16행이에요. about_brand_share 0.2는 이 20행의 4/20이에요. 다른 키워드의 비율로 옮기지 마세요. 16개 not_about_brand_ids는 여전히 recent_mentions 안에 있어요.

Talkwalker는 Boolean만으로는 Orange처럼 다른 뜻이 섞인다고 적고 YouScan은 Apple처럼 이름만 넣으면 다른 글이 들어온다고 적어요. 이번 응답은 그 행을 지우는 대신 점수만 붙였어요.

0.53과 0.57은 액션 피규어예요. 0.93과 0.78만 디자인 툴 문맥이에요. 0.5 미만 16건의 제목도 대부분 피규어와 장난감이에요. lorem ipsum 글이 0.02, 웹사이트 데모가 0.04, 코칭 사이트가 0.42로 남아 있어요.

0.5 이상 4행의 감성은 중립 4, 긍정 0, 부정 0이에요. 요약의 긍정 3,098,016, 부정 626,232, 중립 439,752를 더하면 4,164,000이라 total_count보다 232,768 커요. ground_truth는 false예요. 여기서 긍정 비율을 만들지 마세요. 페이지 타입 다섯 칸을 더해도 total_count보다 커요. 한 페이지가 타입을 여러 개 가질 수 있어요.

날짜가 있는 브랜드 행 둘은 2026-01-26, 2026-06-22예요. 요청한 창 밖이에요. 최근 행은 검색 하위 호출이 준 최신 행이에요. 그 한 달을 전부 센 숫자는 아니에요.

자주 묻는 질문은 뭐예요?

모니터링 도구 순위가 필요하면 어느 글을 보면 되나요?

영어 글 두 편이 그 자리예요. 도구를 비교한 글은 Best Social Listening Tools, 모니터링 API를 짜는 글은 Social Media Monitoring API예요. 이 글은 그 순위를 다시 만들지 않아요.

사고 싶다는 댓글만 따로 받을 수 있나요?

comment-leads가 그 목록을 돌려요. 사람이 문장을 읽고 고른 결과가 아니라, purchase_intent 0.5 이상, spam 0.5 미만, fits_offer 0.5 이상이에요. 세럼 호출에서는 pp 한 단어가 그 규칙을 통과했어요. open이 작으면 게이트를 넘긴 글도 닫혀요. 피그마는 open=1에서 리드가 0이었어요.

핸들 앞에 @가 없어도 언급을 찾나요?

handle=figma처럼 @ 없이 보냈어요. 20행 본문에는 @figma가 있었어요. 청구는 1크레딧이고 각 검색의 첫 페이지예요. 전체 인덱스가 아니에요.

브랜드와 철자가 같은 다른 뜻은 언급에서 빠지나요?

빠지지 않아요. about_brand 0.5 미만 16건이 recent_mentions에 남았어요. 0.5 이상 4건 중 2건은 피규어 글이에요. 점수는 붙고 행은 그대로예요.

댓글의 감성·구매의도 라벨은 어느 글이 다루나요?

질문·구매의도까지 잡는 텍스트 감정분석 API예요. 이 글의 댓글 리드는 그 확률로 행을 거르는 호출이고 라벨 칸을 풀어 쓴 글은 그쪽이에요.

다음에 그대로 칠 주소는 뭔가요?

Prism 컴포지트 다섯 줄이에요. 키는 x-api-key 헤더에 넣고 API 키 하나로 호출하면 돼요. 호스트는 https://www.socialcrawl.dev예요. 인덱스가 움직여서 행은 이날과 같지 않아요.

앞의 네 줄이 피그마 댓글 3, 웹 페이지 리드 25, 핸들 언급 1, 브랜드 언급 50이에요. 합은 79크레딧이에요. 마지막 세럼 11은 그 위에 더해져요. 하위 호출을 더한 값을 영수증으로 쓰지 마세요.

GET /v1/prism/comment-leads?query=figma%20alternative&offer=A%20collaborative%20interface%20design%20tool%20for%20product%20teams.&posts=30&open=1&comments_per_post=25
GET /v1/prism/leads?competitor=figma&product_category=design%20tool&offer=A%20collaborative%20interface%20design%20tool%20for%20product%20teams.&limit=20&freshness=30d
GET /v1/prism/mentions?handle=figma&platforms=twitter
GET /v1/prism/brand-mentions?keyword=figma&date_from=2026-09-12&date_to=2026-10-12&brand_description=Figma%20is%20a%20collaborative%20interface%20design%20tool%20for%20product%20teams.
GET /v1/prism/comment-leads?query=vitamin%20c%20serum%20acne&offer=A%20vitamin%20C%20serum%20for%20acne.&posts=20&open=5&comments_per_post=30