tiktok-shop/
product-reviews

상품 PDP URL 하나에서 TikTok Shop 공개 리뷰를 수집하고, 리뷰 텍스트, 평점, 작성자 정보, 이미지, SKU와 구매 맥락을 정규화된 레코드로 반환합니다.

TikTok Shop Product Reviews API

상품 PDP URL 하나
공개 리뷰 텍스트와 평점
SKU와 구매 맥락
지역별 수집
결과당 0.3 크레딧
준비됨
준비됨

매개변수를 입력하고 요청을 전송하세요. 작업 상태와 정규화된 결과가 여기에 표시됩니다.

README

SocQ 작성 · 업데이트

TikTok Shop Product Reviews

TikTok Shop 상품 리뷰는 텍스트, 평점, 작성자 이름, 이미지, 타임스탬프, SKU 정보, 국가, 명시적인 구매 상태 플래그를 담은 공개 고객 피드백 레코드입니다. 이러한 필드는 상품 피드백 분석, 옵션별·지역별 비교, 근거를 중시하는 리뷰 워크플로에 활용할 수 있습니다.

TikTok Shop Product Reviews API 주요 기능

  • 상품 하나와 지역 범위지원되는 공개 PDP URL 하나를 시장 지역과 함께 제출하면, 해당 상품에 노출된 고유 리뷰를 요청한 한도까지 수집합니다.
  • 리뷰 내용, 평점, 작성자, 미디어정규화된 레코드마다 노출된 리뷰 텍스트, 숫자 평점, 작성자 정보, 이미지, 게시 시각, 상품 URL, 수집 시각을 보존합니다.
  • 상품, SKU, 국가, 구매 맥락리뷰 레코드에는 상품·SKU 식별자, 옵션 사양, 리뷰 국가가 유지되며, 명시적으로 제공되는 경우 구매 인증 여부나 대가 제공 리뷰 여부 플래그도 포함됩니다.

TikTok Shop Product Reviews API 매개변수

매개변수필수설명
url필수/shop/pdp/{numeric_id} 또는 /shop/pdp/{slug}/{numeric_id} 형식과 일치하는 TikTok Shop 공개 URL로, 필수 값입니다. 작업 하나에 상품 하나만 받습니다.
results_limit선택원본 여러 페이지에 걸쳐 저장할 고유 리뷰의 최대 개수입니다. 기본값은 100이며 20~2,000 범위의 정수를 받습니다.
region선택TikTok Shop 시장 지역입니다. 기본값은 US이며, 그 밖에 허용되는 지역에서는 공개 상품이나 리뷰의 제공 여부가 다를 수 있습니다.

TikTok Shop Product Reviews API 사용 방법

지원되는 상품 URL 하나를 제출하고, 비동기 작업을 추적하며, 정규화된 리뷰 레코드를 커서 페이지네이션으로 읽습니다.

  1. 지원되는 TikTok Shop PDP url 하나, 20~2,000 범위의 results_limit, 상품이 판매되는 시장의 region을 준비합니다.
  2. 요청을 /v1/tiktok-shop/product-reviews로 POST하고, 반환된 task_id를 저장합니다.
  3. 작업이 성공하거나 실패할 때까지 GET /v1/tasks/{task_id}를 폴링합니다.
  4. data.results.items를 읽고, has_more가 true인 동안 반환된 next_cursor로 다음 결과를 요청합니다.
curl -X POST "https://api.socq.ai/v1/tiktok-shop/product-reviews" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://www.tiktok.com/shop/pdp/example-product/1729587769570529799","results_limit":100,"region":"US"}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is true

TikTok Shop Product Reviews API 추천 활용 사례

  • 상품 피드백 분석: 리뷰 텍스트, 숫자 평점, 타임스탬프, 상품 정보를 활용해 알고 있는 상품 하나에 대해 반환된 공개 피드백을 살펴봅니다.
  • SKU·지역별 피드백 비교: 레코드를 SKU 사양이나 리뷰 국가별로 묶어 텍스트와 평점을 비교하되, 누락된 필드의 값은 추정하지 않습니다.
  • 구매 맥락과 리뷰 미디어 확인: 고객이 올린 이미지를 확인하고, 값이 있는 경우 명시적인 구매 인증 또는 대가 제공 리뷰 플래그로 레코드를 구분합니다.

TikTok Shop Product Reviews API 활용 팁

  • 프로필, 동영상, 상점 등 그 밖의 TikTok URL은 거부되므로, 제출하기 전에 입력값이 숫자 상품 ID가 포함된 tiktok.com의 전체 PDP URL인지 검증하세요.
  • 상품이 판매되는 시장과 일치하는 region을 선택하세요. 유효한 URL이라도 선택한 시장에 상품이나 리뷰 피드가 노출되지 않으면 공개 리뷰가 반환되지 않을 수 있습니다.
  • 수집 범위에 맞게 results_limit을 20~2,000 사이로 정하고, 저장된 결과 페이지를 모두 읽으려면 has_more가 false가 될 때까지 next_cursor를 따라가세요.
  • 없는 리뷰 텍스트, 작성자 정보, SKU 상세, 구매 상태 플래그는 알 수 없는 값으로 취급하세요. 누락된 불리언은 false가 아니며, 평점만 있는 레코드도 유효합니다.

TikTok Shop Product Reviews API 외에 TikTok Shop의 다른 유형의 공개 데이터가 필요할 때 이 API를 사용하세요.

  • TikTok Shop Search API — 키워드와 시장 지역으로 공개 TikTok Shop 상품을 검색하며, 판매자, 가격, 미디어, 평점, 리뷰, 판매량 필드를 포함합니다.
  • TikTok Shop Products API — TikTok Shop 스토어 URL 하나에서 공개 상품을 수집하며, 판매자, 가격, 미디어, 카테고리, SKU, 평점, 리뷰, 판매량 필드를 포함합니다.
  • TikTok Shop Product API — PDP URL로 공개 TikTok Shop 상품 하나를 가져오며, 판매자, 가격, 미디어, 카테고리, SKU, 평점, 리뷰, 판매량 필드를 포함합니다.
  • TikTok Shop User Showcase API — TikTok 사용자 이름 하나의 공개 쇼케이스 상품을 수집하며, 가격, 판매자, 미디어, 평점, 리뷰, 판매량, 지역 맥락을 포함합니다.
  • TikTok Shop Hot Products API — 지역 코드로 TikTok Shop 시장의 인기 판매 상품을 순위대로 수집하며 가격, 통화, 판매량, 평점, 판매자를 포함합니다.
  • TikTok Shop Categories API — TikTok Shop 시장의 전체 카테고리 트리를 카테고리 ID, 이름, 영문 slug, 레벨, 상위 카테고리, 경로와 함께 가져옵니다.

다른 플랫폼 둘러보기

TikTok Shop 데이터를 지원되는 다른 소셜 플랫폼의 공개 데이터와 함께 활용하세요.

TikTok Shop Product Reviews API — 자주 묻는 질문

TikTok Shop Product Reviews API는 지원되는 TikTok Shop PDP URL 하나의 공개 고객 리뷰를 가져옵니다. 정규화된 리뷰 텍스트, 평점, 작성자 정보, 이미지, 타임스탬프, 상품·SKU 맥락, 국가, 명시적인 구매 상태 플래그를 반환합니다.

경로가 /shop/pdp/{numeric_id} 또는 /shop/pdp/{slug}/{numeric_id}와 일치하는 tiktok.com 또는 TikTok 서브도메인 URL을 사용합니다. region의 기본값은 US이며 US, GB, DE, FR, IT, ID, MY, MX, PH, SG, ES, TH, VN, BR, JP, IE를 받습니다.

이 필드들은 공개 리뷰와 함께 명시적으로 제공된 값만 보고합니다. 필드가 없으면 false가 아니라 알 수 없는 값으로 취급하고, 구매 인증이나 대가 제공 여부를 추정하지 마세요.

results_limit은 보장된 개수가 아니라 최대값입니다. 제공되는 리뷰 피드의 끝, 원본의 has_more 경계, 한도 중 먼저 도달하는 지점에서 수집이 멈추며, 삭제되었거나 이용할 수 없거나 지역 제한이 있거나 공개적으로 접근할 수 없는 상품은 레코드가 없을 수 있습니다.

저장된 리뷰 1개당 0.3 SocQ 크레딧이 차감되며, 원본 여러 페이지에 걸쳐 저장된 고유 리뷰가 모두 포함됩니다. 저장된 리뷰가 없는 작업에는 결과 요금이 부과되지 않습니다.