tiktok-shop/
products

1件のTikTok ShopストアURLから公開商品を取得し、商品情報、価格、画像、セラー情報、評価、レビュー数、販売数を正規化されたレコードとして返します。

TikTok Shop Products API

ストアURLを1件指定
人気順・新着順
取得件数20〜2,000
正規化された商品レコード
結果1件あたり0.7クレジット
準備完了
準備完了

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

README

SocQ 編集 · 更新

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件と任意の取得設定を送信し、非同期タスクを追跡して、正規化された商品レコードをカーソルページネーションで読み取ります。

  1. 対応する /shop/store/{slug}/{numeric_shop_id} 形式のURLを1件用意し、results_limit、sort_by、region の値を決めます。
  2. リクエストを /v1/tiktok-shop/products に POST し、返された task_id を保存します。
  3. タスクが成功するか失敗を返すまで /v1/tasks/{task_id} をポーリングします。
  4. 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 true

TikTok 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、メディア、指標のフィールドは任意項目として扱ってください。

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

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

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

TikTok Shop Products API — よくある質問

TikTok Shop Products APIは、対応するTikTok ShopストアURL 1件から公開商品レコードを取得するAPIです。正規化された商品情報、セラー情報、価格、画像、カテゴリ、SKUデータ、評価、レビュー数、販売数、取得日時を返します。

url は tiktok.com またはTikTokサブドメインを使用し、/shop/store/{slug}/{numeric_shop_id} に一致する必要があります。あわせて、20〜2,000の results_limit、top または new_releases の sort_by、ドキュメント記載の region の値を1つ指定できます。

top はソース側の売れ筋順、new_releases は新着順を指定します。これらはソース側の並び替えモードであり、収益性、トレンド性、在庫全体の完全な順位を保証するものではありません。

正規化された各行には、商品とセラーの情報、正規URL、タイトルまたは説明文、画像、価格、割引、評価、レビュー数、販売数、ステータス、カテゴリ、SKU、入力URL、リージョン、取得日時が含まれる場合があります。個々の商品行に含まれないショップ単位のカウンターは、正規化レコードの仕様に含まれません。

results_limit は上限であり、件数を保証するものではありません。選択したリージョンでそれ以上の商品やカーソルが公開されていない時点で取得は停止し、重複する商品IDはタスクごとに1回だけ保存されます。

タスクの成功後、GET /v1/tasks/{task_id} から data.results.items を読み取ります。has_more が true の場合は、has_more が false になるまで同じタスクエンドポイントに next_cursor を渡してください。

返された商品レコード1件につき0.7 SocQクレジットです。リクエストの見積もりには results_limit(省略時は100)が使われ、結果が空の場合は結果の料金はかかりません。