TikTok Shop Hot Products
TikTok Shop 인기 상품은 한 시장에서 잘 팔리는 상품의 순위로, 상품마다 상품명, 현지 통화 가격, 판매량, 평점, 리뷰 수, 판매자, 상품 이미지가 담겨 있습니다. 순위대로 읽고 주마다 비교하면 어떤 상품이 급부상하는지, 어느 가격대에서 팔리는지, 어떤 판매자가 꾸준히 상위권에 오르는지 보입니다.
TikTok Shop Hot Products API 주요 기능
- 지역 코드 하나로 끝나는 입력region 값에 시장 하나(ID, JP, MX, MY, PH, SG, TH, VN)만 고르면 키워드, 카테고리, 스토어 링크를 따로 준비하지 않아도 목록이 반환됩니다.
- TikTok Shop 순위를 그대로 유지상품은 TikTok Shop이 매긴 순서대로 요청당 최대 200개까지 반환되므로, 행의 위치가 곧 목록에서의 순위입니다.
- 시장 자체 통화로 표시된 가격price 값은 숫자 금액, MYR 같은 통화 코드, 표시용 가격 텍스트로 나뉘어 있어 정렬과 가격대 분석에 바로 쓸 수 있습니다.
- 수요와 평판 신호상품마다 sold_count, rating, reviews_count 값이 있어 얼마나 팔렸고 구매자가 어떻게 평가했는지 빠르게 읽을 수 있습니다.
- 판매자와 상품 이미지seller 값은 상품을 판매하는 스토어 이름과 id를 알려 주고, media 배열에는 상품 이미지가 너비, 높이와 함께 담깁니다.
TikTok Shop Hot Products API 매개변수
| 매개변수 | 필수 | 설명 |
|---|---|---|
region | 필수 | 순위를 읽을 시장으로 ID, JP, MX, MY, PH, SG, TH, VN 중 하나입니다. |
results_limit | 선택 | 반환할 순위 상품 수로 1~200 사이이며 기본값은 50입니다. |
TikTok Shop Hot Products API 사용 방법
시장을 고르고 순위를 어디까지 읽을지 정한 뒤 목록을 수집합니다.
- {"region": "MY", "results_limit": 50}을 /v1/tiktok-shop/hot-products로 POST하고 반환된 task_id 값을 보관합니다.
- GET /v1/tasks/{task_id}를 폴링해 status 값이 succeeded로 바뀔 때까지 기다립니다.
- results.items에서 순위가 매겨진 상품을 순서대로 읽고, has_more 값이 true인 동안 results.next_cursor로 이어 갑니다.
curl -X POST "https://api.socq.ai/v1/tiktok-shop/hot-products" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"region":"MY","results_limit":50}'TikTok Shop Hot Products API 추천 활용 사례
- 시장별 주간 베스트셀러 모니터링: 매주 상품 id, 순위, sold_count 값을 저장하고 실행 결과를 비교해 어떤 상품이 순위에 새로 들어오거나 오르거나 빠지는지 확인합니다.
- 가격대 벤치마킹: 같은 통화 안에서 price.amount 값을 정렬해 시장의 인기 상품이 몰리는 가격대를 찾고, 그 뒤에 자사 상품 가격을 정합니다.
- 소싱 후보 목록 작성: title, media 이미지, sold_count, rating 값을 함께 보고 소싱하거나 홍보할 만한 상품을 고르며, url 값으로 각 상품 페이지에 다시 들어갈 수 있습니다.
- 판매자 집중도 확인: 상위권에 seller.id 값이 몇 번씩 나오는지 세어, 소수 판매자가 시장을 장악하는지 목록이 넓게 분산되어 있는지 확인합니다.
TikTok Shop Hot Products API 활용 팁
- 순위는 별도 rank 필드가 아니라 행의 순서로 전달되므로, results.items를 읽으면서 커서 페이지를 넘어가도 이어지도록 각 상품의 순위를 직접 기록하세요.
- 시장 간 가격을 비교하기 전에 price.currency 값으로 묶고, 계산은 표시용 텍스트가 아닌 price.amount 값으로 하세요.
- sold_count, rating, reviews_count 값이 null이면 0이 아니라 제공되지 않은 값으로 처리해야 평균과 정렬이 의미를 유지합니다.
- 주간 비교가 같은 순위 깊이를 다루도록 실행할 때마다 region과 results_limit 값을 고정하세요.
관련 API
TikTok Shop Hot Products API 외에 TikTok Shop의 다른 유형의 공개 데이터가 필요할 때 이 API를 사용하세요.
- TikTok Shop Products API — TikTok Shop 스토어 URL 하나에서 공개 상품을 수집하며, 판매자, 가격, 미디어, 카테고리, SKU, 평점, 리뷰, 판매량 필드를 포함합니다.
- TikTok Shop Product API — PDP URL로 공개 TikTok Shop 상품 하나를 가져오며, 판매자, 가격, 미디어, 카테고리, SKU, 평점, 리뷰, 판매량 필드를 포함합니다.
- TikTok Shop Product Reviews API — TikTok Shop PDP URL 하나의 공개 리뷰를 수집하며, 본문, 평점, 리뷰어, 이미지, SKU, 국가, 구매 맥락 필드를 포함합니다.
- TikTok Shop User Showcase API — TikTok 사용자 이름 하나의 공개 쇼케이스 상품을 수집하며, 가격, 판매자, 미디어, 평점, 리뷰, 판매량, 지역 맥락을 포함합니다.
- TikTok Shop Categories API — TikTok Shop 시장의 전체 카테고리 트리를 카테고리 ID, 이름, 영문 slug, 레벨, 상위 카테고리, 경로와 함께 가져옵니다.
- TikTok Shop Category Products API — 카테고리 ID와 시장으로 TikTok Shop 카테고리 하나의 상품을 나열하며 가격, 판매량, 평점, 리뷰, 판매자를 포함합니다.