tiktok-shop/
user-showcase

ユーザー名とリージョンを指定して、公開TikTokユーザーのShopショーケースに表示された商品を取得し、セラー、価格、メディア、評価、レビュー数、販売数のフィールドを返します。

TikTok Shop User Showcase API

ユーザー名で指定
ショーケース商品
リージョン別カタログ
結果1件あたり0.7クレジット
準備完了
準備完了

パラメータを入力してリクエストを送信してください。タスクのステータスと正規化された結果がここに表示されます。

README

SocQ 編集 · 更新

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件ずつ非同期タスクとして送信し、保存されたショーケース商品をカーソルページネーションで読み取ります。

  1. 公開TikTokユーザー名を1件用意し、対応する region を選び、results_limit を20〜2,000の範囲で設定します。
  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、タイトル、リンク、セラー情報、画像、カテゴリを使って、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、指標のフィールドがない状態も公開ソースの有効な結果として扱ってください。

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、名前、英語のスラッグ、階層、親カテゴリ、パスとともに取得します。

他のプラットフォームを見る

TikTok Shopのデータを、対応する他のソーシャルプラットフォームの公開データと組み合わせられます。

TikTok Shop User Showcase API — よくある質問

TikTok Shop User Showcase APIは、1つのTikTokユーザー名と選択した市場について、公開表示されているShop商品を取得するAPIです。公開されている場合、正規化された商品、セラー、価格、メディア、カテゴリ、SKU、評価、レビュー数、販売数のフィールドを返します。

空でないユーザー名の文字列を1つ送信してください。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、指標の値が省略されることもあります。そのため、succeeded のタスクでもアイテムが0件になったり、任意フィールドが空のレコードが含まれたりすることがあります。

/v1/tasks/{task_id} をポーリングし、成功後に data.results.items を読み取ります。has_more が true の間は next_cursor でタスク結果の次のページをリクエストしてください。

返された正規化ショーケース商品1件につき0.7 SocQクレジットです。結果が空の場合は結果の料金はかかりません。