기업 확인 후 리뷰 조회
기업을 검색해 레코드를 확보한 뒤 최신순으로 리뷰를 가져옵니다. 두 단계로 끝나는 흐름이며 운영 중인 리뷰 레인 가운데 가장 안정적입니다.
엔드포인트 순서
business-search -> trustpilot/reviews활용 사례
리뷰 사이트와 앱스토어를 함께 조회하는 리뷰 모니터링 API
고객이 제품에 대해 남긴 평가를 남긴 곳에서 그대로 읽습니다. 트러스트파일럿과 앱스토어, 구글 플레이가 안정적인 축이고 레딧은 지나치게 깔끔해 보이는 평점을 검증하는 필터 없는 대조군입니다.
/v1/prism
여러 소스의 리뷰 통합 조회
- GET /v1/trustpilot/reviews
- GET /v1/app_store/app-reviews
- GET /v1/google_play/app-reviews
- GET /v1/prism/product-reviews
리뷰 모니터링 API는 기업과 앱, 제품에 대한 고객 리뷰를 점수화하고 저장하며 기간별로 비교할 수 있는 구조화된 레코드로 반환합니다. SocialCrawl은 도메인 기준 트러스트파일럿과 앱 기준 앱스토어 및 구글 플레이, 대조군인 레딧을 API 키 하나와 공통 스키마로 제공합니다. 리뷰 조사가 단일 사이트에 의존하지 않습니다.
실제로 만들어지는 것
모두 현재 운영 중인 패턴입니다. 각 카드 아래의 엔드포인트 순서가 실제 호출 순서입니다.
두 앱스토어 동시 조회
앱 이름을 한 번 전달하면 앱스토어와 구글 플레이 리뷰를 함께 반환합니다. 스토어 간 비교가 핵심입니다. 같은 릴리스가 두 스토어에서 전혀 다르게 평가되는 경우가 많아 한 스토어만 보면 판단이 틀어집니다.
엔드포인트 순서
prism/app-reviews (both stores at once)스토어별 개별 조회
스토어별 파라미터와 국가 범위, 자체 페이지네이션 방식이 필요하면 각 스토어를 직접 호출합니다. 두 스토어 모두 리뷰 엔드포인트가 안정적인 표면이므로 목록 메타데이터가 아니라 여기에 구축합니다.
엔드포인트 순서
app_store/app-reviews + google_play/app-reviews판매처별 제품 리뷰
제품 하나를 여러 판매처에 조회해 불만이 제품에 대한 것인지 판매처에 대한 것인지 구분합니다. 판매처 커버리지는 제품과 지역에 따라 달라지므로 누락을 결론으로 삼기 전에 반환 결과를 확인해야 합니다.
엔드포인트 순서
prism/product-reviews (multi-merchant)필터 없는 대조 조회
같은 제품을 레딧에서 검색합니다. 브랜드를 위해 운영되는 커뮤니티가 아니기 때문이며, 실제로 진행되는 리뷰 조사는 별점 옆에 이 단계를 거의 예외 없이 포함합니다.
엔드포인트 순서
reddit/search (the unfiltered cross-check)리뷰 구성 점검
평균 점수 대신 작성 시점과 반복 여부, 분포를 컴포지트 호출로 확인합니다. 일주일 만에 만들어진 별 다섯 개 평균과 2년에 걸쳐 쌓인 같은 평균은 전혀 다른 자료입니다.
엔드포인트 순서
prism/review-integrity리뷰 모니터링 API 동작 방식
네 번의 호출로 기업 리뷰와 두 앱스토어, 판매처별 관점을 모두 확인합니다. 조사 대상이 실제로 있는 곳에서 시작합니다.
조회는 크레딧으로 과금됩니다. 목록 엔드포인트에서 결과가 없으면 과금되지 않고 업스트림 실패는 자동 환불됩니다.
GET /v1/trustpilot/business-search기업 검색
이름이나 도메인으로 검색해 리뷰를 요청하기 전에 기업 레코드를 확정합니다. 브랜드명과 리뷰 사이트 등록명이 정확히 일치하는 경우가 드물어 필요한 단계입니다.
호출당GET /v1/trustpilot/reviews리뷰 수집
도메인 기준으로 정렬을 지정해 리뷰를 요청하고 첫 페이지에서 멈추지 않고 커서로 전체 이력을 순회합니다.
페이지당GET /v1/prism/app-reviews두 앱스토어 추가
컴포지트 호출 하나가 같은 앱의 앱스토어와 구글 플레이 리뷰를 함께 반환합니다. 스토어 간 비교가 한 단계로 끝나는 이유입니다.
호출당GET /v1/prism/product-reviews판매처로 확장
제품을 판매처 전반에 조회해 제품 자체에 대한 불만과 배송 및 판매 과정에 대한 불만을 구분합니다.
호출당
리뷰를 가져오는 소스
모두 같은 리뷰 조사에서 동작하는 레인입니다. 링크를 열면 해당 플랫폼의 전체 엔드포인트를 확인합니다.
기존 구성과 비교
대부분 사이트별 평판 대시보드를 구매하거나 리뷰 페이지 하나를 수집하고 전체를 봤다고 판단합니다. 달라지는 지점은 다음과 같습니다.
| Capability | SocialCrawl | 일반적인 구성 |
|---|---|---|
| 커버리지 | 키 하나로 리뷰 사이트와 두 앱스토어, 판매처, 레딧을 조회합니다. | 공급업체마다 사이트 하나만 다루므로 단일 소스가 전체 결론이 됩니다. |
| 교차 검증 | 이견이 있는 평점을 같은 키로 두 번째, 세 번째 소스에서 확인합니다. | 평점 하나를 그대로 신뢰할 뿐 검증할 방법이 없습니다. |
| 응답 형태 | 모든 소스가 공통 스키마를 사용하므로 점수화 코드를 한 번만 작성합니다. | 공급업체마다 응답 형태가 달라 직접 정규화합니다. |
| 이력 | 커서 페이지네이션으로 리뷰 전체 이력을 날짜와 함께 저장 가능한 형태로 조회합니다. | 최신 페이지만 제공하고 같은 자리에서 갱신됩니다. |
| 과금 방식 | 소멸되지 않는 크레딧 팩으로 호출당 과금하며 업스트림 실패는 환불합니다. | 지점 단위 또는 등록 항목 단위로 월 좌석 요금이 청구됩니다. |
| 제품화 가능 여부 | 가공된 고객용 화면으로 제공하는 것이 약관에 명시적으로 허용됩니다. | 대개 제한되거나 건별 협의가 필요합니다. |
리뷰 모니터링 API 자주 묻는 질문
리뷰 모니터링 API란 무엇입니까?
리뷰 모니터링 API는 기업과 앱, 제품의 고객 리뷰를 대시보드가 아니라 구조화된 레코드로 반환합니다. 리뷰 본문과 평점, 작성일, 작성자 계정을 제공하므로 직접 점수화하고 저장하며 실행 간 변화를 확인할 수 있습니다.
어떤 리뷰 소스를 조회합니까?
도메인 기준 트러스트파일럿, 앱 기준 앱스토어와 구글 플레이, 장소 기준 트립어드바이저, 판매처 전반의 구글 쇼핑, 지역 기준 틱톡숍, 그리고 대조군인 레딧입니다. 아마존 상품과 판매자 데이터도 같은 키로 조회하며 아래 단서를 함께 확인하시기 바랍니다.
아마존 리뷰를 안정적으로 가져올 수 있습니까?
현재는 어렵고 실패하는 기능을 판매하기보다 사실대로 알립니다. 아마존 리뷰 수집은 지금 보유한 소스 중 가장 불안정합니다. 리뷰 워크플로의 핵심은 트러스트파일럿과 앱스토어 위에 구성하고 해당 업스트림이 복구되기 전까지 아마존은 보조 근거로 사용하시기 바랍니다.
같은 앱을 두 스토어에서 비교할 수 있습니까?
가능하며 이 페이지에서 가장 많이 쓰이는 패턴입니다. 컴포지트 호출 하나가 앱스토어와 구글 플레이 리뷰를 함께 반환합니다. 같은 릴리스가 두 스토어에서 상당히 다르게 읽히기 때문에 중요하며 두 스토어 모두 리뷰 엔드포인트가 안정적인 표면입니다.
리뷰 조사에 레딧이 왜 포함됩니까?
브랜드를 위해 운영되는 커뮤니티가 아니기 때문입니다. 별점은 점수를 알려 주고 레딧은 이유를 알려 주며 둘이 어긋난다는 사실 자체가 결과입니다. 실제 운영에서 리뷰 작업과 레딧 검색은 거의 항상 함께 실행됩니다.
가짜 리뷰를 판별할 수 있습니까?
리뷰 묶음의 형태는 확인할 수 있습니다. 작성 시점과 반복 여부, 평점 분포, 평균이 어떤 기간에 걸쳐 형성됐는지가 대상이며 구성 점검 컴포지트가 읽는 값입니다. 판단을 위한 근거이지 판정은 아니며 진위를 단정하는 라벨을 제공하는 공급자는 신뢰하기 어렵습니다.
리뷰 모니터링 비용은 얼마입니까?
조회는 소멸되지 않는 크레딧 팩에서 차감됩니다. 등록 항목이나 지점이 아니라 호출 단위로 과금합니다. 브랜드 하나를 여러 소스에서 주 단위로 점검하면 호출 몇 건으로 끝납니다. 가입 시 무료 크레딧 100개를 제공하며 카드 등록이 필요하지 않습니다.
AI에게 SocialCrawl을 물어보세요
요청
curl -G "https://socialcrawl.dev/v1/trustpilot/reviews" \
-H "x-api-key: $SOCIALCRAWL_API_KEY" \
--data-urlencode "domain=stripe.com" \
--data-urlencode "sort=recency"curl -G "https://socialcrawl.dev/v1/prism/app-reviews" \
-H "x-api-key: $SOCIALCRAWL_API_KEY" \
--data-urlencode "query=Notion"두 호출 모두 실제 데이터로 동작합니다. 키와 도메인만 바꾸면 그대로 실행됩니다.