TikTok Shop Products
TikTok Shop 상품은 상품 정보, 판매자 맥락, 이미지, 가격, 카테고리, SKU 데이터, 평점, 리뷰 수, 판매 수를 담은 공개 스토어 진열 상품입니다. 이러한 레코드는 스토어 카탈로그 스냅샷, 상품 구성 비교, 공개 가격 모니터링, 상품 단위 정보 보강에 활용할 수 있습니다.
TikTok Shop Products API 주요 기능
- 스토어 단위 카탈로그 설정지원되는 공개 스토어 URL 하나에서 요청한 결과 수 제한, 인기순 또는 신상품순 정렬, 문서화된 시장 지역을 지정해 상품을 수집합니다.
- 상품, 판매자, 미디어 정보레코드마다 상품 ID, 제목, 제공되는 설명, 정식 URL, 판매자 또는 상점 정보, 중복을 제거한 공개 이미지 참조를 반환합니다.
- 가격과 공개된 커머스 신호상품 비교를 위해 노출된 판매가와 정가, 통화, 서식이 적용된 값, 할인, 평점, 리뷰 수, 판매 수를 보존합니다.
- 구조화된 카탈로그 행제공되는 상태, 카테고리, SKU 구조를 정규화된 상품 행과 함께 보존하며, 개별 상품에 속하지 않는 상점 단위 카운터는 제외합니다.
TikTok Shop Products API 매개변수
| 매개변수 | 필수 | 설명 |
|---|---|---|
url | 필수 | /shop/store/{slug}/{numeric_shop_id} 형식과 일치하는 TikTok Shop 공개 스토어 URL로, 필수 값입니다. 작업 하나에 스토어 하나만 받습니다. |
results_limit | 선택 | 원본 여러 페이지에 걸쳐 저장할 고유 상품의 최대 개수입니다. 기본값은 100이며 20~2,000 범위의 정수를 받습니다. |
sort_by | 선택 | 스토어 카탈로그의 원본 정렬 기준입니다. top은 베스트셀러순, new_releases는 최신 출시순이며, 기본값은 top입니다. |
region | 선택 | TikTok Shop 시장 지역입니다. 기본값은 US이며, 그 밖에 허용되는 지역에서는 공개 카탈로그 제공 여부가 다를 수 있습니다. |
TikTok Shop Products API 사용 방법
공개 TikTok Shop 스토어 URL 하나를 선택적인 수집 설정과 함께 제출하고, 비동기 작업을 추적하며, 정규화된 상품 레코드를 커서 페이지네이션으로 읽습니다.
- 지원되는 /shop/store/{slug}/{numeric_shop_id} URL 하나를 준비하고, results_limit, sort_by, region 값을 정합니다.
- 요청을 /v1/tiktok-shop/products로 POST하고, 반환된 task_id를 저장합니다.
- 작업이 성공하거나 실패할 때까지 /v1/tasks/{task_id}를 폴링합니다.
- data.results.items를 읽고, has_more가 true인 동안 반환된 next_cursor로 다음 결과를 요청합니다.
curl -X POST "https://api.socq.ai/v1/tiktok-shop/products" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"url":"https://www.tiktok.com/shop/store/goli-nutrition/7495794203056835079","results_limit":100,"sort_by":"top","region":"US"}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueTikTok Shop Products API 추천 활용 사례
- 스토어 카탈로그 스냅샷: 상품 ID, 제목, URL, 판매자, 가격, 이미지, 카테고리, SKU 구조, collected_at을 활용해 특정 시점의 공개 스토어 카탈로그를 구성합니다.
- 인기순·신상품순 상품 구성 비교: 같은 스토어를 top과 new_releases 정렬로 각각 수집한 뒤, 반환된 상품 정보, 가격, 카테고리, 공개된 상품 신호를 비교합니다.
- 공개 가격과 신호 추적: 같은 상품 ID에 대해 따로 수집한 가격, 할인, 평점, 리뷰 수, 판매 수, 상태, 수집 시각 필드를 비교합니다.
- 상품 URL 후보 목록 준비: 정식 상품 URL, 제목, 이미지, 판매자 맥락, 공개된 지표를 활용해 상세 조회나 리뷰 워크플로에 쓸 상품을 선별합니다.
TikTok Shop Products API 활용 팁
- 작업을 제출하기 전에 입력값이 숫자 상점 ID가 포함된 tiktok.com의 공개 /shop/store/ 경로인지 검증하세요.
- region은 확인하려는 스토어의 시장으로 설정하세요. 유효한 스토어에서 레코드가 반환되지 않으면 재시도하기 전에 지역별 제공 여부를 확인하세요.
- 원본 베스트셀러 정렬에는 top, 최신 출시 정렬에는 new_releases를 사용하되, 어느 쪽도 수익성이나 트렌드를 보장하는 것으로 해석하지 마세요.
- results_limit은 수집 최대값으로 취급하고, 저장된 행을 모두 읽으려면 has_more가 false가 될 때까지 작업 결과 커서를 별도로 계속 따라가세요.
- 반복 스냅샷은 상품 ID를 키로 관리하고 collected_at을 보관하며, 판매자, 가격, 상태, 카테고리, SKU, 미디어, 지표 필드는 선택 값으로 처리하세요.
관련 API
TikTok Shop Products API 외에 TikTok Shop의 다른 유형의 공개 데이터가 필요할 때 이 API를 사용하세요.
- TikTok Shop Search API — 키워드와 시장 지역으로 공개 TikTok Shop 상품을 검색하며, 판매자, 가격, 미디어, 평점, 리뷰, 판매량 필드를 포함합니다.
- 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, 레벨, 상위 카테고리, 경로와 함께 가져옵니다.