tiktok/
live-products

방 ID와 호스트 ID로 TikTok LIVE 방송의 쇼핑 상품 목록을 조회해, 상품명, 현재 가격, 판매 수량, 판매자 ID, 상품 링크, 이미지를 받습니다.

TikTok Live Shopping API

방 ID와 호스트 ID
쇼핑 상품 목록
상품 최대 500개
결과당 0.1 크레딧
준비됨
준비됨

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

README

SocQ 작성 · 업데이트

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

쇼핑 라이브를 찾고, 방송 중에 상품 목록을 조회합니다.

  1. 쇼핑 키워드로 TikTok Live Search를 실행해 결과의 id와 author.id를 가져옵니다.
  2. {"room_id": "7704767945901132575", "user_id": "7153432386608251946"}을 /v1/tiktok/live-products로 POST합니다.
  3. 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입니다.

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 데이터를 지원되는 다른 소셜 플랫폼의 공개 데이터와 함께 활용하세요.

TikTok Live Shopping API — 자주 묻는 질문

TikTok Live Shopping API는 방송의 room_id와 호스트의 user_id로 TikTok LIVE 방송의 쇼핑 상품 목록을 조회하는 프로그래밍 인터페이스입니다. 상품별 이름, 가격, 판매 수량, 판매자 ID, 링크, 이미지를 반환합니다.

TikTok Live Search를 실행해 결과의 id를 room_id로, author.id를 user_id로 사용하세요. 두 값은 반드시 같은 결과에서 가져와야 합니다.

results_limit은 1~500을 받고 기본값은 100이며, 목록이 더 작으면 그만큼에서 끝납니다. 반환된 상품 1개당 0.1 크레딧이 청구되므로 상품 500개를 모두 받으면 50 크레딧입니다.

그 방에서 호스트가 쇼핑 목록을 열어 두지 않았거나, 방이 더 이상 방송 중이 아닙니다. 빈 결과는 청구되지 않습니다.

아니요, 목록을 요청하는 시점에 방이 방송 중이어야 합니다. 방송이 진행되는 동안 읽어 두고, 나중에 상품 구성이 필요하면 저장해 두세요.

sold_count는 TikTok이 해당 상품에 대해 알려 주는 판매 수량이며, 제공되는 값이 없으면 null입니다. 방송 중에 얼마나 팔렸는지 보려면 목록을 두 번 읽어 차이를 계산하세요.