TikTok Live Shopping
TikTok LIVE 쇼핑 목록은 호스트가 방송 중에 판매하는 상품의 모음으로, 상품마다 이름, 통화가 명시된 가격, 판매 수량, 판매자, 이미지가 있습니다. 목록을 읽으면 방송이 어떤 상품을 밀고 있는지, 호스트가 방송하는 동안 가격이 어떻게 책정되는지, 이미 많이 팔린 상품이 무엇인지 알 수 있습니다.
TikTok Live Shopping API 주요 기능
- 목록의 모든 상품room_id와 호스트의 user_id를 보내면 방의 쇼핑 목록에 있는 상품이 하나씩 개별 레코드로 오며, results_limit이 허용하는 최대 500개까지입니다.
- 금액, 통화, 표시 문자열로 나뉜 가격price.amount, price.currency, price.formatted가 각각 숫자, 통화 코드, 시청자에게 보이는 문자열을 제공합니다. 예를 들면 41.6, USD, $41.60입니다.
- 정수로 제공되는 판매 수량sold_count는 101600 같은 정수라서 목록을 바로 정렬하고 비교할 수 있습니다.
- 상품 링크, 판매자 ID, 이미지레코드마다 url에 상품 페이지, seller.id에 판매자 ID, media에 가로·세로 크기가 포함된 상품 이미지가 들어 있습니다.
TikTok Live Shopping API 매개변수
| 매개변수 | 필수 | 설명 |
|---|---|---|
room_id | 필수 | LIVE 방의 숫자 ID로, TikTok Live Search 결과의 id 값을 사용합니다. |
user_id | 필수 | 호스트의 숫자형 TikTok 사용자 ID로, 같은 Live Search 결과의 author.id 값을 사용합니다. |
results_limit | 선택 | 반환할 상품의 개수로, 1~500 사이 값입니다. 기본값은 100입니다. |
TikTok Live Shopping API 사용 방법
쇼핑 라이브를 찾고, 방송 중에 상품 목록을 조회합니다.
- 쇼핑 키워드로 TikTok Live Search를 실행해 결과의 id와 author.id를 가져옵니다.
- {"room_id": "7704767945901132575", "user_id": "7153432386608251946"}을 /v1/tiktok/live-products로 POST합니다.
- status가 succeeded가 될 때까지 GET /v1/tasks/{task_id}를 폴링한 뒤 results.items에서 상품을 읽고, has_more가 true인 동안 results.next_cursor를 다시 보내 이어서 가져옵니다.
curl -X POST "https://api.socq.ai/v1/tiktok/live-products" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"room_id":"7704767945901132575","user_id":"7153432386608251946","results_limit":100}'
# Each item is one product with title, price and sold_count.TikTok Live Shopping API 추천 활용 사례
- 경쟁사 라이브의 상품 목록 확인: Live Search에서 경쟁 호스트의 room_id와 user_id를 가져와 상품 목록 전체를 조회하면, 어떤 상품을 어떤 가격대로 판매하는지 알 수 있습니다.
- 방송 중 가격 변동 관찰: 같은 방을 몇 분 간격으로 읽고 상품 id별 price.amount를 비교하면, 호스트가 방송에서 알리는 가격 인하를 포착할 수 있습니다.
- 목록의 베스트셀러 찾기: 목록을 sold_count로 정렬해 가장 많이 팔린 상품을 확인하고, 가격과 함께 견줘 봅니다.
TikTok Live Shopping API 활용 팁
- 방끼리 가격을 비교하기 전에 price.currency부터 확인하세요. 금액은 통화와 함께 있어야 의미가 있습니다.
- 조회 간 같은 상품은 id로 맞추세요. 달라지는 필드는 price.amount와 sold_count입니다.
관련 API
TikTok Live Shopping API 외에 TikTok의 다른 유형의 공개 데이터가 필요할 때 이 API를 사용하세요.
- TikTok Profiles API — 사용자 이름으로 공개 프로필 정보, 소개글, 계정 속성, 오디언스 수치를 가져옵니다.
- TikTok Hashtags API — 지정한 해시태그의 공개 동영상, 크리에이터, 미디어, 사운드, 참여도를 수집합니다.
- TikTok Comments API — 공개된 최상위 댓글, 작성자, 참여도, 멘션, 크리에이터 상호작용 플래그를 수집합니다.
- TikTok Videos API — 동영상 URL에서 크리에이터, 캡션, 미디어, 음악, 태그, 멘션, 참여도를 가져옵니다.
- TikTok Live Room Info API — 방 ID와 소유자 ID 쌍으로 알고 있는 라이브 방송 하나를 조회하며, 상태, 소유자 맥락, 커버 미디어, 시청자 수를 반환합니다.
- TikTok Live Search API — 키워드로 지금 방송 중인 LIVE를 찾으며, 호스트, 제목, 현재 시청자 수를 포함합니다.
- TikTok Search API
- TikTok Comment Replies API
- TikTok Followers List API
- TikTok Following List API
- TikTok User Videos API
- TikTok Trending Feed API
- TikTok Video Transcript API
- TikTok Search Users API
- TikTok Song API
- TikTok Song Videos API
- TikTok Popular Songs API
- TikTok Top Search API
- TikTok User Live API
- TikTok Audience Demographics API
- TikTok Similar Accounts API
- TikTok Reposts API
- TikTok Playlists API
- TikTok Hashtag Views API
- TikTok Sound Search API
- TikTok Photo Search API
- TikTok Trending Searches API
- TikTok Creator Search Insights API
- TikTok Live Ranking API
- TikTok Fake Views Checker API
- TikTok Comment Keywords API