비즈니스 검색
1 크레딧/v1/trustpilot/business-search이름 또는 키워드로 Trustpilot 비즈니스를 검색합니다. 도메인과 리뷰 수를 반환합니다. 상품이 아니라 회사입니다. 첫 호출은 약 15-45초일 수 있습니다. 표준 티어(1 크레딧)입니다.
query, depth
Trustpilot 엔드포인트
Trustpilot 읽기 엔드포인트는 2개입니다. 회사 domain을 찾은 뒤 평판 리뷰를 가져옵니다. 회사 리뷰만 지원하며 상품 SKU 리뷰가 아닙니다.
비즈니스 리뷰
5 크레딧/v1/trustpilot/reviews검색에서 얻은 비즈니스 도메인의 고객 리뷰입니다. 별점, 본문, 인증 플래그, 소유자 응답이 포함됩니다. 상품 SKU가 아니라 회사 평판입니다. 고급 티어(5 크레딧)입니다.
domain, depth, sort
Trustpilot API2개 엔드포인트 지원
문서 보기키워드와 맞는 Trustpilot 등록 업체를 회사명, Trustpilot 도메인, 자체 홈페이지, 리뷰 페이지 URL, 총 리뷰 수와 함께 반환합니다.
상품이 아니라 업체를 찾는 검색입니다. reviews에 넘길 Trustpilot 도메인을 알아낼 때 사용하세요.
1크레딧
GET/v1/trustpilot/business-search?query=nike&depth=20
query · Business name or keyword (e.g. 'nike'). Matches companies, not products; do not pass a bare domain.
$ curl https://www.socialcrawl.dev/v1/trustpilot/business-search?query=nike&depth=20 \
-H "x-api-key: sc_YOUR_API_KEY"대기 중
// 실제 실행에는 API 키가 필요합니다. "실행해보기"를 누르면 예시 응답을 표시합니다Trustpilot API 동작
Trustpilot도 다른 SocialCrawl 데이터 엔드포인트와 같습니다. API 키로 GET /v1/trustpilot/… 를 호출하고 캐시 미스에 크레딧을 쓰며 동일한 JSON 봉투를 받습니다.
호출 인증
x-api-key 헤더에 키를 보냅니다. 공개 읽기에 Trustpilot OAuth 앱은 필요 없습니다. SocialCrawl 전 플랫폼에 같은 키를 사용합니다.
GET과 쿼리 파라미터
Trustpilot 라우트는 모두 GET입니다. query, domain, depth, sort를 쿼리로 전달합니다. 과금 전에 형식을 검증합니다.
크레딧 과금
business-search는 1 크레딧입니다. reviews는 5 크레딧입니다. 콜드 작업은 15-45초일 수 있으며 이후 캐시됩니다.
JSON 봉투
응답 형태는 success, data, credits_used, credits_remaining, request_id, cached로 동일합니다. 페이지가 있는 목록 응답은 페이지네이션 필드를 가집니다.
연동 순서
대부분 제품은 엔티티를 먼저 찾은 뒤 필요할 때만 상세와 리뷰를 깊게 봅니다.
01비즈니스 찾기
GET /v1/trustpilot/business-search?query=…domain id가 있는 비즈니스 AuthorList
reviews에는 상품 ASIN이 아니라 Trustpilot domain이 필요합니다.
02리뷰
GET /v1/trustpilot/reviews?domain=…회사 domain ReviewList
VoC용 브랜드 평판 텍스트입니다.
03정렬
GET /v1/trustpilot/reviews?domain=…&sort=relevancerelevance 또는 recency 정렬 ReviewList
모니터링은 recency, 조사는 relevance입니다.
04깊이
GET /v1/trustpilot/reviews?domain=…&depth=100플랫폼 한도까지 더 큰 리뷰 창
depth가 한 호출 행 수를 정합니다. 무한 커서는 없습니다.
요청
GET /v1/trustpilot/business-search?query=nike&depth=20
Host: www.socialcrawl.dev
x-api-key: sc_your_api_key_here
GET /v1/trustpilot/reviews?domain=www.nike.com&depth=20&sort=recency응답 봉투
{
"success": true,
"data": {
"items": [
{
"author": {
"id": "www.nike.com",
"username": "www.nike.com",
"display_name": "Nike",
"posts_count": 12000,
"url": "https://www.trustpilot.com/review/www.nike.com"
}
}
]
},
"credits_used": 1,
"credits_remaining": 9999,
"request_id": "req_…",
"cached": false
}data 형태
아키타입이 맞는 범위에서 필드 이름은 SocialCrawl 나머지와 같습니다. 한 번 파싱해 플랫폼에 재사용합니다.
AuthorListbusiness-search
비즈니스 표시명, domain id, 리뷰 수, Trustpilot url
ReviewListreviews
items[]에 rating, text, verified, responses[], published_at
리뷰 창reviews + depth
depth 제한 단일 페이지, 최대 200
404 환불empty business
리뷰 없는 domain은 404 후 환불
게이트웨이 내부
다른 /v1 플랫폼 엔드포인트와 같은 요청 수명주기입니다. Trustpilot은 사이드카가 아닙니다.
- 01
엣지가 호출을 받음
Next.js catch-all이 Hono 소셜 API로 라우팅합니다. request_id를 만들고 키를 인증한 뒤 분당 600회, 키당 동시 50개 한도를 적용합니다.
- 02
검증 후 차감
레지스트리에서 trustpilot/business-search (or reviews)를 찾습니다. 필수 파라미터와 형식 검사를 먼저 합니다. 잘못된 입력은 과금 없이 400입니다. 유효 호출은 업스트림 전에 티어 비용을 원자적으로 차감합니다.
- 03
캐시 또는 수집
platform + resource + params로 캐시 키를 만듭니다. 히트면 credits_used = 0으로 즉시 반환합니다. 미스면 Trustpilot 작업을 서버에서 스핀 폴링합니다. 소스가 불안정하면 5xx/네트워크 재시도와 서킷 브레이커를 사용합니다.
- 04
정규화 후 반환
업스트림 JSON을 Product, ProductList, ReviewList, SellerList, App, PlaceList 등 커머스 아키타입으로 매핑하고 Zod로 검증한 뒤 성공 봉투로 감싸 과금 감사 로그를 남깁니다.
운영에서 중요한 과금 규칙
- business-search: 1 크레딧
- reviews: 5 크레딧
- 캐시 히트: 0 크레딧
- 빈 응답 / 하드 실패: 자동 환불
- 잘못된 파라미터: 400, 과금 없음
- 크레딧 부족: 402, 과금 없음
- 콜드 호출은 종종 15-45초
- depth가 리뷰 창 제한 (최대 200)
- 쓰기·비즈니스 답글 도구 없음
데이터 수집 방식
Trustpilot은 공개 읽기 데이터입니다. SocialCrawl 스키마로 정규화하므로 별도 벤더 SDK를 배울 필요가 없습니다.
이 API에서 Trustpilot의 의미
공개 회사 프로필과 회사에 대한 고객 리뷰입니다. 상품 페이지가 아닙니다.
SocialCrawl 수집 경로
업체 프로필과 리뷰 조회는 서버 측 작업으로 실행됩니다. 비동기 수명주기는 서버가 처리합니다.
엣지에서 나가는 형태
비즈니스 AuthorList와 domain 리뷰 ReviewList입니다.
라이브로 제공하지 않는 것
리뷰 초대, 비즈니스 답글, 비공개 분석은 없습니다.
필드 매핑
Trustpilot company→ author.*domain이 id/username
review body→ ReviewList items[]stars, text, owner responses
depth / sort→ query controlsdepth 최대 밖 커서 없음
이 API의 활용 분야
이 API가 가장 많이 사용되는 작업입니다.
2active Trustpilot endpoints in the registry
1 / 5business-search와 reviews 크레딧 구간
브랜드 평판과 지원 품질 모니터링
호출은 검색 또는 분류 후 후보 엔티티의 상세·리뷰 심화에 몰립니다. 1 크레딧 검색 후 domain 기준 회사 리뷰를 5 크레딧으로 가져옵니다. Trustpilot 파트너 OAuth는 없습니다.
라이브 미스는 보통 수 초입니다. 일부 경로는 콜드 캐시에서 더 걸릴 수 있습니다.
Trustpilot API 활용 사례
Trustpilot 데이터가 가장 많이 쓰이는 작업입니다. 각 항목에서 엔드포인트 순서와 과금 방식을 확인합니다.
활용 사례
이 데이터를 활용하는 대표적인 방식과 각 방식에서 주로 사용하는 스택입니다.
브랜드 운영
Python, Slackbusiness-search로 domain을 찾고 reviews로 최신 모니터링합니다.
VoC 조사
Node, notebooksdomain별 reviews와 depth로 언어를 수집합니다.
경쟁 인텔
BI loads경쟁 브랜드를 검색하고 리뷰 볼륨·톤을 샘플링합니다.
두 줄로 호출
검색은 1 크레딧입니다. 리뷰는 5 크레딧입니다. 캐시 히트는 무료입니다.
curl "https://www.socialcrawl.dev/v1/trustpilot/business-search?query=nike&depth=20" \
-H "x-api-key: sc_your_api_key_here"curl "https://www.socialcrawl.dev/v1/trustpilot/reviews?domain=www.nike.com&depth=20&sort=recency" \
-H "x-api-key: sc_your_api_key_here"엔드포인트
Trustpilot API는 어떤 데이터를 돌려주나요
모든 엔드포인트가 같은 응답 구조의 JSON을 보내드려요. 엔드포인트가 해당 지표를 지원하고 계산에 필요한 원본 값이 있을 때만 참여율·콘텐츠 카테고리 같은 계산 필드가 포함돼요.
비교
SocialCrawl과 직접 스크래핑, 뭐가 다른가요?
같은 Trustpilot 데이터를 받는 두 가지 방법을 나란히 비교했어요. 인증부터 비용까지 한눈에 확인해 보세요.
| 항목 | SocialCrawl | 직접 스크래핑 |
|---|---|---|
| 인증 | x-api-key 하나로 가입하자마자 호출하면 돼요 | 키는 없지만 프록시와 봇 차단 우회를 직접 관리해야 해요 |
| 시작하기 | 기업 검색 후 리뷰, GET 요청 두 번이면 끝이에요 | 헤드리스 브라우저, 프록시 풀, HTML 파서, 재시도 로직을 직접 만들어야 해요 |
| 응답 스키마 | 65개 플랫폼과 같은 통합 ReviewList JSON으로 와요 | 원시 HTML을 직접 파싱해야 하고, 리뉴얼 때마다 셀렉터가 깨져요 |
| 요금 | 검색 1 크레딧, 리뷰 5 크레딧, 신용카드 없이 100 크레딧 무료 | 프록시·서버 비용에 엔지니어링 시간이 계속 들어가요 |
| 데이터 범위 | 별점·본문·인증 여부·언어·기업 답변을 한 번에 최대 200개까지 받아요 | 마크업이 바뀌기 전까지 파서가 뽑아내는 만큼만이에요 |
| 유지보수 | 업스트림 변경은 SocialCrawl이 흡수해 드려요 | 페이지 구조가 바뀔 때마다 스크레이퍼를 직접 고쳐야 해요 |
인증
SocialCrawl
x-api-key 하나로 가입하자마자 호출하면 돼요
직접 스크래핑
키는 없지만 프록시와 봇 차단 우회를 직접 관리해야 해요
시작하기
SocialCrawl
기업 검색 후 리뷰, GET 요청 두 번이면 끝이에요
직접 스크래핑
헤드리스 브라우저, 프록시 풀, HTML 파서, 재시도 로직을 직접 만들어야 해요
응답 스키마
SocialCrawl
65개 플랫폼과 같은 통합 ReviewList JSON으로 와요
직접 스크래핑
원시 HTML을 직접 파싱해야 하고, 리뉴얼 때마다 셀렉터가 깨져요
요금
SocialCrawl
검색 1 크레딧, 리뷰 5 크레딧, 신용카드 없이 100 크레딧 무료
직접 스크래핑
프록시·서버 비용에 엔지니어링 시간이 계속 들어가요
데이터 범위
SocialCrawl
별점·본문·인증 여부·언어·기업 답변을 한 번에 최대 200개까지 받아요
직접 스크래핑
마크업이 바뀌기 전까지 파서가 뽑아내는 만큼만이에요
유지보수
SocialCrawl
업스트림 변경은 SocialCrawl이 흡수해 드려요
직접 스크래핑
페이지 구조가 바뀔 때마다 스크레이퍼를 직접 고쳐야 해요
자주 묻는 질문
자주 묻는 질문
API, 요금제, 기능에 대한 질문과 답변입니다.
문의하기트러스트파일럿 리뷰는 어떻게 수집하나요?
SocialCrawl은 트러스트파일럿 엔드포인트 2종을 제공해요. 먼저 GET /v1/trustpilot/business-search로 기업과 도메인을 찾고, 그 도메인으로 GET /v1/trustpilot/reviews를 호출하면 별점, 리뷰 본문, 인증 여부, 기업 답변이 통합 JSON으로 와요.
트러스트파일럿 API는 제품 리뷰도 주나요?
아니요. 트러스트파일럿 리뷰는 배송, 환불, 고객지원처럼 기업 자체에 대한 평가예요. 특정 제품이 아니라 기업 도메인 기준으로 정리돼요. 제품 리뷰가 필요하면 Google Shopping이나 Amazon 리뷰 엔드포인트를 써 보세요.
Trustpilot API는 어떤 데이터를 주나요?
기업 검색은 기업 이름, 트러스트파일럿 도메인, 웹사이트, 총 리뷰 수를 받아볼 수 있어요. 리뷰는 별점, 제목, 본문, 인증 여부, 언어, 리뷰어 정보, 기업 답변, 작성일까지 하나의 통합 스키마로 와요.
Trustpilot API 요금은 얼마인가요?
기업 검색은 한 번에 1 크레딧(스탠다드), 리뷰는 5 크레딧(어드밴스드)이 소진돼요. 새 계정에는 100 크레딧이 무료로 제공돼서, 신용카드 없이 두 엔드포인트를 먼저 테스트해 볼 수 있어요.
트러스트파일럿 리뷰를 수집해도 괜찮나요?
SocialCrawl은 트러스트파일럿의 공개 리뷰 페이지만 가져와요. URL을 아는 누구나 볼 수 있는 내용이지만, 사용 목적이 트러스트파일럿 약관과 개인정보 관련 법령에 맞는지는 직접 확인해 주세요.
가장 좋은 트러스트파일럿 스크레이퍼 API는 무엇인가요?
기업 평판 분석이라면 SocialCrawl이 좋은 선택이에요. 기업 검색은 1 크레딧으로 트러스트파일럿 도메인을 찾고, 리뷰 엔드포인트는 5 크레딧에 별점·인증 여부·기업 답변이 담긴 리뷰를 최대 200개까지 돌려드려요. 프록시나 헤드리스 브라우저를 관리할 필요 없이, 신용카드 없이 100 크레딧으로 시작할 수 있어요.
Trustpilot 데이터 스크래핑, 법적으로 괜찮을까요?
SocialCrawl은 누구나 볼 수 있는 공개 Trustpilot 데이터만 돌려드리고, 로그인이 필요한 비공개 콘텐츠에는 접근하지 않아요. 다만 실제 적법성은 활용 목적과 국가별 법률에 따라 달라져요. Trustpilot 이용약관과 GDPR·CCPA 같은 개인정보 보호 법규를 지키는 책임은 이용자에게 있어요. 이 답변은 일반 안내일 뿐, 법률 자문은 아니에요.
Trustpilot 스크래핑 API와 공식 Trustpilot API는 뭐가 다른가요?
SocialCrawl은 앱 심사나 승인 대기가 없어요. 가입 직후 x-api-key 하나로 Trustpilot 엔드포인트를 바로 호출할 수 있고, 응답은 다른 모든 플랫폼과 같은 통합 스키마로 와요. 요금도 플랫폼별 쿼터 대신 크레딧으로 계산해요. 글 게시 같은 쓰기 작업이 필요하다면 공식 API가 맞아요. SocialCrawl은 읽기 전용 데이터만 다뤄요.
AI에게 SocialCrawl을 물어보세요