TikTok Shop User Showcase
TikTok Shop 사용자 쇼케이스는 TikTok 공개 사용자 프로필에 연결된 상품 진열로, 노출되는 경우 상품 및 판매자 정보, 가격, 미디어, 평점, 리뷰 수, 판매 수를 담고 있습니다. 이러한 커머스 신호는 상품 구성 검토, 지역별 스냅샷, 상품 비교, 리서치 데이터셋 정보 보강에 활용할 수 있습니다.
TikTok Shop User Showcase API 주요 기능
- 사용자 이름 하나로 쇼케이스 수집TikTok 사용자 이름 하나에 진열된 공개 상품을 수집하며, 핸들 앞의 @는 있어도 없어도 됩니다.
- 시장 지역 선택지원되는 16개 region 값 중 하나를 골라, 원하는 TikTok Shop 공개 시장의 쇼케이스를 수집합니다.
- 범위가 제한된 고유 상품 결과쇼케이스 상품을 20~2,000개 요청할 수 있으며, 수집한 페이지는 공개 상품 식별 정보를 기준으로 중복이 제거됩니다.
- 정규화된 상품 및 판매자 맥락노출되는 경우 상품 ID, 제목, 설명, 정식 링크, 이미지, 판매자 필드, 가격, 카테고리, SKU 구조를 반환합니다.
- 공개된 커머스 신호와 공개 범위의 한계제공되는 평점, 리뷰 수, 판매 수, 상태, 지역, 수집 시각을 보존하며, 공개되지 않은 필드는 비워 둡니다.
TikTok Shop User Showcase API 매개변수
| 매개변수 | 필수 | 설명 |
|---|---|---|
username | 필수 | TikTok 공개 사용자 이름으로, 필수 값입니다. 작업 하나에 값 하나만 받으며, 앞의 @는 있어도 없어도 됩니다. |
results_limit | 선택 | 요청할 고유 쇼케이스 상품 수의 상한으로, 20~2,000 범위입니다. 기본값은 100입니다. |
region | 선택 | 시장 지역으로, US, GB, DE, FR, IT, ID, MY, MX, PH, SG, ES, TH, VN, BR, JP, IE 중 하나입니다. 기본값은 US입니다. |
TikTok Shop User Showcase API 사용 방법
공개 사용자 이름 하나와 시장을 비동기 작업으로 제출하고, 저장된 쇼케이스 상품을 커서 페이지네이션으로 읽습니다.
- TikTok 공개 사용자 이름 하나를 준비하고, 지원되는 region을 고르고, 20~2,000 범위의 results_limit을 설정합니다.
- 요청을 /v1/tiktok-shop/user-showcase로 POST하고, 반환된 task_id를 저장합니다.
- 작업이 succeeded 또는 failed가 될 때까지 /v1/tasks/{task_id}를 폴링합니다.
- data.results.items를 읽습니다. has_more가 true이면 next_cursor로 이어서 가져옵니다.
curl -X POST "https://api.socq.ai/v1/tiktok-shop/user-showcase" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"username":"mrtiktokreviews","results_limit":100,"region":"US"}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueTikTok Shop User Showcase API 추천 활용 사례
- 사용자 쇼케이스 상품 구성 검토: 상품 ID, 제목, 링크, 판매자 맥락, 이미지, 카테고리를 활용해 사용자 이름 하나에 진열된 공개 상품을 살펴봅니다.
- 가격과 공개된 수요 신호 비교: 반환된 쇼케이스 상품들의 가격, 통화, 할인, 평점, 리뷰 수, 판매 수를 비교합니다.
- 지역별 쇼케이스 스냅샷 생성: input_username, region, 상품 정보, 공개 커머스 필드, collected_at을 저장해 특정 시점의 검토를 반복할 수 있게 합니다.
- 상품 리서치 데이터셋 정보 보강: 사용자 이름을 중심으로 구성한 기존 리서치 세트에 정식 상품 URL, 판매자 정보, 미디어, 카테고리, SKU 맥락, 공개된 지표를 추가합니다.
TikTok Shop User Showcase API 활용 팁
- 실행할 때마다 같은 사용자 이름 표기를 사용하세요. 이 엔드포인트는 @핸들과 핸들을 모두 받으며, 정규화된 입력 사용자 이름을 상품마다 기록합니다.
- region의 기본값은 US이고 미국 외 지역의 공개 제공 여부는 다를 수 있으므로, 원하는 카탈로그에 맞는 시장을 선택하세요.
- 모든 쇼케이스에 기본값인 100개 상품이 있다고 가정하지 말고, 필요한 범위에 맞게 results_limit을 20~2,000 사이로 설정하세요.
- 성공한 뒤에는 has_more가 true인 동안 next_cursor를 따라가서, 작업 결과 페이지네이션 때문에 저장된 상품을 읽지 못하는 일이 없게 하세요.
- 스냅샷은 상품 id 기준으로 중복을 제거하고, 비어 있는 작업이나 누락된 판매자, 가격, 미디어, 카테고리, SKU, 지표 필드는 공개 원본에서 나올 수 있는 정상적인 결과로 취급하세요.
관련 API
TikTok Shop User Showcase API 외에 TikTok Shop의 다른 유형의 공개 데이터가 필요할 때 이 API를 사용하세요.
- TikTok Shop Search API — 키워드와 시장 지역으로 공개 TikTok Shop 상품을 검색하며, 판매자, 가격, 미디어, 평점, 리뷰, 판매량 필드를 포함합니다.
- 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 Hot Products API — 지역 코드로 TikTok Shop 시장의 인기 판매 상품을 순위대로 수집하며 가격, 통화, 판매량, 평점, 판매자를 포함합니다.
- TikTok Shop Categories API — TikTok Shop 시장의 전체 카테고리 트리를 카테고리 ID, 이름, 영문 slug, 레벨, 상위 카테고리, 경로와 함께 가져옵니다.