카테고리 불만 조회
키워드가 아니라 불만을 겪는 구매자가 쓸 법한 문장으로 질의합니다. 실제로 성과가 나오는 질의는 가격이 비싸다, 자꾸 끊긴다, 설정이 어렵다처럼 문장 형태입니다.
엔드포인트 순서
search/forums (what people complain about)활용 사례
구매자의 실제 발언을 수집하는 시장 조사 API
시장이 무엇을 불편해하고 무엇을 원하며 지금 무엇에 돈을 쓰는지 확인합니다. 질문 하나가 포럼과 커뮤니티, 영상, 뉴스로 확장되고 해당 글은 댓글 전체와 함께 구조화된 데이터로 반환됩니다.
/v1/search
구매자 발언에서 수요 확인
- GET /v1/search/forums
- GET /v1/prism/audience-questions
- GET /v1/prism/demand-signals
- GET /v1/reddit/search
시장 조사 API는 구매자가 필요한 것과 지금 사용하는 제품, 지불하는 금액을 직접 언급한 공개 게시물과 포럼 글, 댓글을 반환합니다. SocialCrawl은 질의 하나를 46개 플랫폼으로 확장하고 해당 스레드와 댓글 전체를 공통 스키마로 반환합니다. 수요 조사를 외부에 의뢰하지 않고 스크립트로 실행합니다.
실제로 만들어지는 것
모두 현재 운영 중인 패턴입니다. 각 카드 아래의 엔드포인트 순서가 실제 호출 순서입니다.
반복되는 질문 수집
특정 주제에서 반복되는 질문을 커뮤니티와 영상에서 한 번에 수집합니다. 같은 결과가 콘텐츠 기획안과 기능 백로그로 동시에 사용됩니다. 아직 제대로 답이 없는 질문이 양쪽의 출발점이기 때문입니다.
엔드포인트 순서
prism/audience-questions -> content brief제목이 아닌 스레드 전문 확인
불리언 연산자로 검색한 뒤 중요한 글의 댓글 트리 전체를 가져옵니다. 가격에 대한 반박과 우회 방법, 경쟁 제품 이름은 본문이 아니라 답글 안쪽에 있습니다.
엔드포인트 순서
reddit/search -> reddit/post/comments카테고리 전체 파악
경쟁 제품 목록을 대상으로 키워드를 하나씩 조회하고 각 제품에 대한 언급을 수집합니다. 조사 범위가 단일 제품이 아니라 시장 전체일 때 사용하는 방식입니다.
엔드포인트 순서
prism/demand-signals (category read)기존 제품 평가 수집
이미 해당 카테고리에서 판매 중인 제품을 대상으로 공개된 평가를 모읍니다. 수요 검증은 대부분 비교표로 끝나므로 기능 체크리스트 대신 근거로 표를 채웁니다.
엔드포인트 순서
prism/reputation (competitor landscape)표현 변화 추적
한 시점의 스냅숏이 아니라 수개월간 카테고리를 설명하는 표현이 어떻게 달라지는지 추적합니다. 구매자가 쓰는 단어의 변화가 기대 수준이 바뀌었다는 가장 이른 신호입니다.
엔드포인트 순서
content_analysis/phrase-trends (over time)시장 조사 API 동작 방식
네 번의 호출로 막연한 가설을 보고서에 인용할 수 있는 근거로 만듭니다. 각 단계에서 범위를 좁힙니다.
조회는 크레딧으로 과금됩니다. 목록 엔드포인트에서 결과가 없으면 과금되지 않고 업스트림 실패는 자동 환불됩니다.
GET /v1/search/forums문제 중심 질의 실행
일상적인 문장으로 질문하면 사람들이 문제를 설명한 포럼과 커뮤니티 글을 반환합니다. 문제가 실재하는지 확인하는 가장 저렴한 방법입니다.
호출당GET /v1/prism/audience-questions반복 질문 수집
주제와 조회할 소스를 전달하면 시장이 반복해 묻는 질문을 반환합니다. 소비재 카테고리는 커뮤니티와 영상으로 범위를 지정합니다.
호출당GET /v1/reddit/post/comments토론 전체 수집
읽을 가치가 있는 스레드를 골라 댓글과 답글을 전부 가져옵니다. 의사결정자가 받아들이는 근거는 대부분 이 단계에서 나온 인용문입니다.
페이지당GET /v1/prism/demand-signals카테고리로 확장
같은 조회를 경쟁 제품 전체에 실행해 단일 제품 질문을 시장 전체 관점으로 넓힙니다.
호출당
수요 근거를 수집하는 소스
모두 같은 조사 과정에서 동작하는 레인입니다. 링크를 열면 해당 플랫폼의 전체 엔드포인트를 확인합니다.
기존 방식과 비교
대부분 패널 조사를 의뢰하거나 커뮤니티를 직접 읽습니다. 달라지는 지점은 다음과 같습니다.
| Capability | SocialCrawl | 일반적인 구성 |
|---|---|---|
| 근거의 출처 | 조사자가 묻기 전에 자발적으로 작성된 공개 게시물입니다. | 설문 문항의 틀에 맞춰 응답된 패널 답변입니다. |
| 커버리지 | 키 하나로 포럼과 커뮤니티, 영상, 뉴스를 포함한 46개 플랫폼을 조회합니다. | 패널 하나 또는 커뮤니티 하나 단위로 별도 과금됩니다. |
| 깊이 | 가격 반박과 경쟁 제품 이름이 실제로 등장하는 댓글 트리 전체를 조회합니다. | 최상위 게시물을 요약해 제공합니다. |
| 소요 시간 | 첫 카테고리 조사를 오늘 스크립트로 실행합니다. | 현장 조사 일정을 몇 주 단위로 잡습니다. |
| 과금 방식 | 소멸되지 않는 크레딧 팩으로 호출당 과금하므로 일회성 조사는 일회성 비용으로 끝납니다. | 프로젝트 비용 또는 연간 좌석 라이선스로 청구됩니다. |
| 원문 추적 | 모든 결과가 원본 게시물과 URL을 유지하므로 의사결정자가 원문을 직접 엽니다. | 집계 차트만 제공하고 기반 응답은 공개하지 않습니다. |
시장 조사 API 자주 묻는 질문
시장 조사 API란 무엇입니까?
시장 조사 API는 특정 문제와 제품, 가격에 대해 시장이 논의한 공개 게시물과 스레드, 댓글을 구조화된 데이터로 반환합니다. 커뮤니티를 직접 읽는 작업을 대체하고 상당수 질문에서는 의뢰하려던 설문 조사도 대체합니다.
제품 아이디어 검증에 사용할 수 있습니까?
가능하며 이 API에서 가장 많이 쓰이는 패턴입니다. 사람들이 그 문제를 지금 어떻게 해결하는지, 무엇에 돈을 쓰는지, 사용 중인 도구의 어떤 점을 불평하는지 조회합니다. 질의 세 건과 그 댓글 트리로 구매자 존재 여부가 대체로 판명됩니다.
어떤 소스를 조회합니까?
SocialCrawl은 46개 플랫폼과 375개 엔드포인트를 제공합니다. 레딧과 해커뉴스, 유튜브, X, 트러스트파일럿, 뉴스, 웹을 포함합니다. API 키 하나로 전부 조회하며 질의 하나를 여러 소스로 동시에 확장할 수 있습니다.
설문 조사와 무엇이 다릅니까?
설문은 조사자가 정한 질문에 대한 답을 수집합니다. 이 API는 아무도 묻지 않았을 때 사람들이 남긴 발언을 수집하므로 질문의 틀이 개입하지 않는 대신 관련 스레드를 찾는 작업이 추가됩니다. 실무에서는 이 API로 진짜 질문을 먼저 찾고 끝까지 불확실한 항목만 설문합니다.
시장의 변화를 기간별로 추적할 수 있습니까?
가능합니다. 표현과 카테고리 추이 엔드포인트가 카테고리를 설명하는 언어의 월별 변화를 제공하고, 모든 검색은 자체 스케줄로 재실행해 저장할 수 있습니다. 동일 주제를 반복 조회하는 방식이 가장 일반적인 운영 패턴입니다.
카테고리 조사 비용은 얼마입니까?
조회는 소멸되지 않는 크레딧 팩에서 차감됩니다. 좌석이나 프로젝트가 아니라 호출 단위로 과금합니다. 첫 조사는 보통 검색 몇 건과 그 아래 댓글 트리로 구성됩니다. 가입 시 무료 크레딧 100개를 제공하며 카드 등록이 필요하지 않습니다.
결과를 고객 산출물에 포함할 수 있습니까?
가공한 분석 결과를 자체 고객이나 사용자에게 제공하는 것은 가능합니다. 약관은 파생 조사 결과물을 허용하고 원본 전달과 대량 재배포를 제한합니다. 산출물이 어디에 해당하는지 불확실하면 배포 전에 문의하시기 바랍니다.
AI에게 SocialCrawl을 물어보세요
요청
curl -G "https://socialcrawl.dev/v1/search/forums" \
-H "x-api-key: $SOCIALCRAWL_API_KEY" \
--data-urlencode "query=project management tool too expensive"curl -G "https://socialcrawl.dev/v1/prism/audience-questions" \
-H "x-api-key: $SOCIALCRAWL_API_KEY" \
--data-urlencode "topic=ai note taking apps" \
--data-urlencode "platforms=reddit,youtube"두 호출 모두 실제 데이터로 동작합니다. 키와 질의만 바꾸면 그대로 실행됩니다.