TikTok Shop User Showcase
TikTok Shopのユーザーショーケースは、公開TikTokユーザープロフィールに紐づく商品の展示で、公開されている場合は商品とセラーの情報、価格、メディア、評価、レビュー数、販売数を含みます。これらのコマース指標は、品揃えの確認、地域別スナップショット、商品比較、調査用データセットの補完に活用できます。
TikTok Shop User Showcase API の主な機能
- 単一ユーザー名のショーケース取得1つのTikTokユーザー名に表示されている公開商品を取得します。ハンドルは先頭の @ の有無にかかわらず指定できます。
- 市場リージョンの選択16の対応 region 値から1つを選び、目的の公開TikTok Shop市場を対象にショーケースを取得します。
- 上限付きの重複のない商品結果20〜2,000件のショーケース商品をリクエストでき、取得ページは公開商品のIDで重複が除外されます。
- 正規化された商品とセラーの情報公開されている場合、商品ID、タイトル、説明文、正規リンク、画像、セラーのフィールド、価格、カテゴリ、SKUの構造を返します。
- 表示中のコマース指標と公開範囲取得可能な評価、レビュー数、販売数、ステータス、リージョン、取得日時を保持し、公開されていないフィールドは空のままにします。
TikTok Shop User Showcase API のパラメータ
| パラメータ | 必須 | 説明 |
|---|---|---|
username | 必須 | 必須。公開TikTokユーザー名です。1つのタスクで指定できる値は1つで、先頭の @ の有無は問いません。 |
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ユーザー名を1件用意し、対応する region を選び、results_limit を20〜2,000の範囲で設定します。
- リクエストを /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、タイトル、リンク、セラー情報、画像、カテゴリを使って、1つのユーザー名に表示されている公開商品を確認します。
- 価格と表示中の需要指標の比較: 返されたショーケース商品間で、取得可能な価格、通貨、割引、評価、レビュー数、販売数を比較します。
- 地域別ショーケーススナップショットの作成: input_username、region、商品情報、公開コマースフィールド、collected_at を保存し、特定時点の状況を繰り返し確認できるようにします。
- 商品調査データセットの補完: ユーザー名起点の既存の調査セットに、正規の商品URL、セラー情報、メディア、カテゴリ、SKU情報、表示中の指標を追加します。
TikTok Shop User Showcase API 活用のヒント
- 実行のたびに同じユーザー名の表記を使用してください。エンドポイントは @handle と handle のどちらも受け付け、正規化された入力ユーザー名を各商品に記録します。
- region のデフォルトは US で、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 1件から公開商品を取得し、出品者、価格、メディア、カテゴリ、SKU、評価、レビュー、販売数の各フィールドを返します。
- TikTok Shop Product API — PDP URLからTikTok Shopの公開商品1件を取得し、出品者、価格、メディア、カテゴリ、SKU、評価、レビュー、販売数の各フィールドを返します。
- TikTok Shop Product Reviews API — TikTok ShopのPDP URL 1件について公開レビューを取得し、本文、評価、レビュー投稿者、画像、SKU、国、購入情報の各フィールドを返します。
- TikTok Shop Hot Products API — 地域コードで選んだTikTok Shop市場の売れ筋商品を、ランキング順に価格と通貨、販売数、評価、ショップとともに取得します。
- TikTok Shop Categories API — TikTok Shop市場のカテゴリツリー全体を、カテゴリID、名前、英語のスラッグ、階層、親カテゴリ、パスとともに取得します。