tiktok-shop/
category-products

카테고리 ID와 시장으로 TikTok Shop 카테고리의 상품을 호출당 최대 500개까지 나열하며, 상품명, 가격과 통화, 판매량, 평점, 리뷰, 판매자를 반환합니다.

TikTok Shop Category Products API

카테고리 ID 입력
9개 시장
최대 500개 상품
결과당 0.5 크레딧
준비됨
준비됨

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

README

SocQ 작성 · 업데이트

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를 가져와 그 아래 상품을 읽습니다.

  1. {"category_id": "601450", "region": "US", "results_limit": 30}을 /v1/tiktok-shop/category-products로 POST합니다.
  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/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 값을 키로 써서 두 번 수집된 상품이 한 번만 집계되게 하세요.

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, 레벨, 상위 카테고리, 경로와 함께 가져옵니다.

다른 플랫폼 둘러보기

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

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

TikTok Shop Category Products API는 카테고리 ID와 시장으로 지정한 TikTok Shop 카테고리 하나의 상품을 나열하는 프로그래밍 인터페이스입니다. 상품마다 상품명, 설명, 가격과 통화, 판매량, 평점, 리뷰 수, 판매자, 이미지, 페이지 URL을 반환합니다.

TikTok Shop Categories를 실행하고 원하는 카테고리의 id 값을 복사하세요. ID는 601450처럼 숫자로만 이루어져 있습니다.

트리에 있는 카테고리 ID라면 모두 사용할 수 있습니다. 사용 방법의 예시 요청은 최상위 카테고리인 Beauty & Personal Care의 601450을 보내며, 더 깊은 ID를 쓰면 목록이 한 갈래로 좁혀집니다.

상품 하나당 0.5 크레딧이므로 기본값 30개는 15 크레딧, 최대 500개는 250 크레딧입니다.