TikTok Shop Category Products
TikTok Shop 카테고리 상품은 한 시장의 특정 카테고리 아래 등록된 상품으로, 상품마다 상품명, 설명, 가격과 통화, 판매량, 평점, 리뷰 수, 판매자, 이미지가 담겨 있습니다. 카테고리별로 모아 보면 한 분야의 가격대, 베스트셀러, 활발한 판매자가 드러나고 하위 카테고리마다 그 양상이 어떻게 다른지도 확인할 수 있습니다.
TikTok Shop Category Products API 주요 기능
- 키워드 대신 카테고리 ID로 탐색category_id 값에는 TikTok Shop Categories가 반환한 숫자 ID를 넣으므로, 검색어를 추측하지 않고 카테고리의 상품을 바로 읽을 수 있습니다.
- 9개 시장, 기본값은 USregion 값은 US, SG, MY, PH, TH, VN, ID, JP, MX를 지원하며 생략하면 US가 적용됩니다.
- 카테고리당 최대 500개 상품results_limit 값은 1~500이고 기본값은 30이어서, 요청 하나로 카테고리를 가볍게 샘플링하거나 깊게 잘라 볼 수 있습니다.
- 상품마다 갖춘 커머스 필드각 행에는 title, text, 금액과 통화로 나뉜 price, sold_count, rating, reviews_count, seller, media 이미지와 상품 페이지 url 값이 담깁니다.
TikTok Shop Category Products API 매개변수
| 매개변수 | 필수 | 설명 |
|---|---|---|
category_id | 필수 | TikTok Shop Categories의 id 필드에서 가져온 숫자 카테고리 ID로, 601450 같은 값입니다. |
region | 선택 | 카테고리가 속한 시장으로 US, SG, MY, PH, TH, VN, ID, JP, MX 중 하나이며 기본값은 US입니다. |
results_limit | 선택 | 반환할 상품 수로 1~500 사이이며 기본값은 30입니다. |
TikTok Shop Category Products API 사용 방법
TikTok Shop Categories에서 카테고리 ID를 가져와 그 아래 상품을 읽습니다.
- {"category_id": "601450", "region": "US", "results_limit": 30}을 /v1/tiktok-shop/category-products로 POST합니다.
- 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/category-products" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"category_id":"601450","region":"US","results_limit":30}'TikTok Shop Category Products API 추천 활용 사례
- 하위 카테고리 간 가격대 비교: 하위 카테고리마다 요청을 하나씩 보내 price.amount 값의 분포를 비교하고, 각 하위 카테고리 상품이 어느 가격에 몰려 있는지 확인합니다.
- 카테고리 베스트셀러 추적: 같은 카테고리를 정기적으로 다시 실행하고 상품 id별 sold_count 값을 따라가 판매량이 계속 늘어나는 상품을 찾습니다.
- 분야별 판매자 지도 작성: seller.id와 seller.name 값으로 상품을 묶어 카테고리에서 상품 수가 가장 많고 판매량이 가장 높은 스토어를 찾습니다.
TikTok Shop Category Products API 활용 팁
- 시장마다 카테고리 트리가 따로 있으므로, TikTok Shop Categories에서 카테고리 ID를 읽을 때 쓴 것과 같은 region 값을 사용하세요.
- 카테고리는 상품 행의 필드가 아니라 요청에서 정해지므로, 보관하는 상품 옆에 보낸 category_id 값을 함께 저장하세요.
- 여러 카테고리나 반복 실행 결과를 합칠 때는 id 값을 키로 써서 두 번 수집된 상품이 한 번만 집계되게 하세요.
관련 API
TikTok Shop Category 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 Hot Products API — 지역 코드로 TikTok Shop 시장의 인기 판매 상품을 순위대로 수집하며 가격, 통화, 판매량, 평점, 판매자를 포함합니다.
- TikTok Shop Categories API — TikTok Shop 시장의 전체 카테고리 트리를 카테고리 ID, 이름, 영문 slug, 레벨, 상위 카테고리, 경로와 함께 가져옵니다.