tiktok-shop/
hot-products

지역 코드로 TikTok Shop 시장 하나의 인기 판매 상품을 수집하며, 상품명, 가격과 통화, 판매량, 평점, 판매자를 TikTok Shop이 매긴 순위 그대로 반환합니다.

TikTok Shop Hot Products API

시장 코드 입력
순위가 매겨진 베스트셀러
현지 통화 가격
판매량
결과당 0.5 크레딧
준비됨
준비됨

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

README

SocQ 작성 · 업데이트

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 사용 방법

시장을 고르고 순위를 어디까지 읽을지 정한 뒤 목록을 수집합니다.

  1. {"region": "MY", "results_limit": 50}을 /v1/tiktok-shop/hot-products로 POST하고 반환된 task_id 값을 보관합니다.
  2. GET /v1/tasks/{task_id}를 폴링해 status 값이 succeeded로 바뀔 때까지 기다립니다.
  3. 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 값을 고정하세요.

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 카테고리 하나의 상품을 나열하며 가격, 판매량, 평점, 리뷰, 판매자를 포함합니다.

다른 플랫폼 둘러보기

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

TikTok Shop Hot Products API — 자주 묻는 질문

TikTok Shop Hot Products API는 지역 코드로 고른 TikTok Shop 시장 하나의 인기 판매 상품 순위를 가져오는 프로그래밍 인터페이스입니다. 상품마다 상품명, 설명, 판매자, 가격과 통화, 판매량, 평점, 리뷰 수, 이미지를 순위대로 반환합니다.

region 값으로 ID, JP, MX, MY, PH, SG, TH, VN 중 하나를 요청마다 지정합니다. 미국 상품은 region US를 받는 TikTok Shop Category Products로 카테고리를 살펴보거나 TikTok Shop Search로 키워드 검색을 하세요.

행은 TikTok Shop이 매긴 순위를 따르므로 results.items의 첫 상품이 목록의 1위입니다. 전체 순서를 유지하려면 이후 결과 페이지도 차례대로 읽으세요.

results_limit 값은 1~200이고 기본값은 50이므로, 요청 한 번으로 시장의 상위 200개 상품까지 다룰 수 있습니다.

반환된 상품 하나당 0.5 크레딧이므로 기본값 50개는 25 크레딧입니다.