tiktok-shop/
user-showcase

사용자 이름과 지역으로 TikTok 공개 사용자의 Shop 쇼케이스에 진열된 상품을 수집하고, 판매자, 가격, 미디어, 평점, 리뷰, 판매 수 필드를 반환합니다.

TikTok Shop User Showcase API

사용자 이름 입력
쇼케이스 상품
지역별 카탈로그
결과당 0.7 크레딧
준비됨
준비됨

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

README

SocQ 작성 · 업데이트

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

공개 사용자 이름 하나와 시장을 비동기 작업으로 제출하고, 저장된 쇼케이스 상품을 커서 페이지네이션으로 읽습니다.

  1. TikTok 공개 사용자 이름 하나를 준비하고, 지원되는 region을 고르고, 20~2,000 범위의 results_limit을 설정합니다.
  2. 요청을 /v1/tiktok-shop/user-showcase로 POST하고, 반환된 task_id를 저장합니다.
  3. 작업이 succeeded 또는 failed가 될 때까지 /v1/tasks/{task_id}를 폴링합니다.
  4. 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 true

TikTok 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, 지표 필드는 공개 원본에서 나올 수 있는 정상적인 결과로 취급하세요.

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

다른 플랫폼 둘러보기

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

TikTok Shop User Showcase API — 자주 묻는 질문

TikTok Shop User Showcase API는 TikTok 사용자 이름 하나와 선택한 시장에서 공개적으로 진열된 Shop 상품을 수집합니다. 노출되는 경우 정규화된 상품, 판매자, 가격, 미디어, 카테고리, SKU, 평점, 리뷰 수, 판매 수 필드를 반환합니다.

비어 있지 않은 사용자 이름 문자열 하나를 보내세요. mrtiktokreviews와 @mrtiktokreviews 모두 허용되며, 앞의 @는 수집 전에 제거됩니다.

results_limit은 20~2,000 범위의 정수를 받으며 기본값은 100입니다. region의 기본값은 US이고 GB, DE, FR, IT, ID, MY, MX, PH, SG, ES, TH, VN, BR, JP, IE도 받습니다.

결과에는 상품 및 판매자 정보, 정식 URL, 제목, 설명, 이미지, 가격 상세, 카테고리, SKU, 상태, 평점, 리뷰 수, 판매 수, 입력 사용자 이름, 지역, 수집 시각이 포함될 수 있습니다.

공개 프로필이라도 선택한 시장에서 제공되는 쇼케이스 상품이 없을 수 있고, 원본이 판매자, 가격, 미디어, 카테고리, SKU, 지표 값을 생략할 수 있습니다. 그래서 성공한 작업도 항목이 없거나 선택 필드가 빈 레코드를 담을 수 있습니다.

/v1/tasks/{task_id}를 폴링하고, 성공하면 data.results.items를 읽은 뒤, has_more가 true인 동안 next_cursor로 작업 결과의 다음 페이지를 요청하세요.

반환된 정규화된 쇼케이스 상품 1개당 0.7 SocQ 크레딧이 차감됩니다. 결과가 비어 있으면 결과 요금이 부과되지 않습니다.