TikTok Shop Products
TikTok Shopの商品一覧は、商品情報、セラー情報、画像、価格、カテゴリ、SKUデータ、評価、レビュー数、販売数を含む公開ストアフロントの出品です。これらのレコードは、ストアカタログのスナップショット、品揃えの比較、公開価格のモニタリング、商品単位の情報補完に活用できます。
TikTok Shop Products API の主な機能
- ストア単位のカタログ取得設定対応する公開ストアURLを1件指定し、取得件数の上限、人気順または新着順の並び順、ドキュメント記載の市場リージョンを設定して商品を取得します。
- 商品・セラー・メディア情報各レコードで、商品ID、タイトル、取得可能な説明文、正規URL、セラーまたはショップの情報、重複を除いた公開画像の参照を返します。
- 価格と表示中のコマース指標公開されている販売価格と元の価格、通貨、表示用にフォーマットされた値、割引、評価、レビュー数、販売数を保持し、商品比較に活用できます。
- 構造化されたカタログ行取得可能なステータス、カテゴリ、SKUの構造を正規化された商品行に保持し、個々の商品に紐づかないショップ単位のカウンターは除外します。
TikTok Shop Products API のパラメータ
| パラメータ | 必須 | 説明 |
|---|---|---|
url | 必須 | 必須。/shop/store/{slug}/{numeric_shop_id} に一致する公開TikTok ShopストアURLです。1つのタスクで指定できるストアは1件です。 |
results_limit | 任意 | ソースの全ページを通じて保存する重複のない商品の最大件数です。デフォルトは100で、20〜2,000の整数を指定できます。 |
sort_by | 任意 | ストアカタログのソース側の並び順です。売れ筋順は top、新着順は new_releases を指定します。デフォルトは top です。 |
region | 任意 | TikTok Shopの市場リージョンです。デフォルトは US で、その他の対応リージョンではカタログの公開状況が異なる場合があります。 |
TikTok Shop Products API の使い方
公開TikTok ShopストアURLを1件と任意の取得設定を送信し、非同期タスクを追跡して、正規化された商品レコードをカーソルページネーションで読み取ります。
- 対応する /shop/store/{slug}/{numeric_shop_id} 形式のURLを1件用意し、results_limit、sort_by、region の値を決めます。
- リクエストを /v1/tiktok-shop/products に POST し、返された task_id を保存します。
- タスクが成功するか失敗を返すまで /v1/tasks/{task_id} をポーリングします。
- data.results.items を読み取り、has_more が true の間は返された next_cursor を指定して続きを取得します。
curl -X POST "https://api.socq.ai/v1/tiktok-shop/products" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"url":"https://www.tiktok.com/shop/store/goli-nutrition/7495794203056835079","results_limit":100,"sort_by":"top","region":"US"}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueTikTok Shop Products API の主なユースケース
- ストアカタログのスナップショット: 商品ID、タイトル、URL、セラー、価格、画像、カテゴリ、SKUの構造、collected_at を使って、特定時点の公開ストアカタログを構築します。
- 人気順と新着順の品揃え比較: 同じストアを top と new_releases の並び順で取得し、返された商品情報、価格、カテゴリ、表示中の商品指標を比較します。
- 公開価格と指標のトラッキング: 同じ商品IDについて、個別に取得した価格、割引、評価、レビュー数、販売数、ステータス、取得日時のフィールドを比較します。
- 商品URL候補リストの作成: 正規の商品URL、タイトル、画像、セラー情報、表示中の指標を使って、詳細取得やレビュー取得のワークフローに回す商品を選定します。
TikTok Shop Products API 活用のヒント
- タスクを送信する前に、入力が数値のショップIDを含む公開tiktok.comの /shop/store/ パスであることを確認してください。
- region は確認したいストアの市場に設定してください。有効なストアでレコードが返らない場合は、リトライの前にリージョンでの公開状況を確認してください。
- ソース側の売れ筋順には top、新着順には new_releases を使用してください。どちらのモードも収益性やトレンドを保証するものではありません。
- results_limit は取得件数の上限として扱い、保存されたすべての行を読み取るには、has_more が false になるまで別のタスク結果用カーソルをたどってください。
- 繰り返し取得したスナップショットは商品IDをキーにして collected_at を保持し、セラー、価格、ステータス、カテゴリ、SKU、メディア、指標のフィールドは任意項目として扱ってください。
関連API
TikTok Shop Products API 以外に別の種類の公開TikTok Shopデータが必要な場合は、これらのAPIをご利用ください。
- TikTok Shop Search API — キーワードと市場地域で公開TikTok Shopの商品を検索し、出品者、価格、メディア、評価、レビュー、販売数の各フィールドを返します。
- TikTok Shop Product API — PDP URLからTikTok Shopの公開商品1件を取得し、出品者、価格、メディア、カテゴリ、SKU、評価、レビュー、販売数の各フィールドを返します。
- TikTok Shop Product Reviews API — TikTok ShopのPDP URL 1件について公開レビューを取得し、本文、評価、レビュー投稿者、画像、SKU、国、購入情報の各フィールドを返します。
- TikTok Shop User Showcase API — TikTokユーザー名1件について公開ショーケースの商品を取得し、価格、出品者、メディア、評価、レビュー、販売数、地域情報を返します。
- TikTok Shop Hot Products API — 地域コードで選んだTikTok Shop市場の売れ筋商品を、ランキング順に価格と通貨、販売数、評価、ショップとともに取得します。
- TikTok Shop Categories API — TikTok Shop市場のカテゴリツリー全体を、カテゴリID、名前、英語のスラッグ、階層、親カテゴリ、パスとともに取得します。