tiktok-shop/
product

PDP URLから公開TikTok Shop商品を取得し、商品情報、セラー、価格、表示中の評価と販売数、メディア、カテゴリ、SKUを1件の正規化されたレコードで返します。

TikTok Shop Product API

公開商品の詳細
PDP URLで指定
単一の正規化レコード
結果1件あたり0.7クレジット
準備完了
準備完了

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

README

SocQ 編集 · 更新

TikTok Shop Product

TikTok Shopの商品は、商品情報、セラー、価格、メディア、カテゴリ、バリエーション、評価、レビュー数、販売数を含む公開の商品詳細ページです。これらのフィールドは、商品情報の補完、カタログ調査、マーチャンダイジングの見直し、特定時点での比較に活用できます。

TikTok Shop Product API の主な機能

  • 単一PDPの詳細取得対応する公開TikTok ShopのPDP URLを1件送信すると、正規化された商品レコードを最大1件受け取れます。商品の発見ではなく、既知の商品の情報補完に適したエンドポイントです。
  • セラー・価格・表示中のコマース指標商品レコードには、公開されているセラー情報、販売価格と元の価格、通貨、割引、評価、レビュー数、販売数が保持され、フィールド単位で直接評価できます。
  • メディア・カテゴリ・SKU返されるレコードには、公開されている商品画像とそのサイズに加え、公開商品ページのカテゴリとSKU・バリエーションの構造が含まれます。

TikTok Shop Product API のパラメータ

パラメータ必須説明
url必須必須。/shop/pdp/{numeric_id} または /shop/pdp/{slug}/{numeric_id} に一致する公開TikTok Shop URLです。1つのタスクで指定できる商品は1件です。
region任意任意。TikTok Shopの市場リージョンです。デフォルトは US で、その他の対応リージョンでは商品の公開状況が異なる場合があります。

TikTok Shop Product API の使い方

対応する商品URLを送信し、非同期タスクのIDを保存して、タスクの成功後に正規化された商品を読み取ります。

  1. 対応するPDP url を1件と任意の region を指定して、/v1/tiktok-shop/product に POST リクエストを送信します。
  2. 返された task_id を保存し、status が succeeded または failed になるまで GET /v1/tasks/{task_id} をポーリングします。
  3. 成功したら data.results.items を読み取り、has_more が true の場合のみ next_cursor をたどります。
curl -X POST "https://api.socq.ai/v1/tiktok-shop/product" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://www.tiktok.com/shop/pdp/example-product/1729587769570529799","region":"US"}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items after status becomes succeeded

TikTok Shop Product API の主なユースケース

  • 検索結果・カタログ結果の情報補完: 既知のPDP URLを使って、検索結果やショップカタログから選んだ商品にセラー、価格、評価、メディア、カテゴリ、SKUのフィールドを追加します。
  • 商品指標のスナップショット比較: 取得した販売価格、元の価格、割引、評価、レビュー数、販売数を、特定時点の商品レコード間で比較します。
  • カテゴリとバリエーションの確認: 公開されているカテゴリ、画像、SKUの構造を確認し、公開商品がどのように構成・掲載されているかを把握します。

TikTok Shop Product API 活用のヒント

  • リクエストの拒否を避けるため、送信前に入力が数値の商品IDを含む完全なtiktok.comのPDP URLであることを確認してください。
  • 商品が他の対応市場のものでない限り region は US のままにし、US以外で結果が空の場合は公開範囲による制限の可能性として扱ってください。
  • results_limit は送信しないでください。1つのタスクで指定できる商品URLは1件で、返される正規化レコードも最大1件です。
  • nullを取りうるセラー、価格、指標、メディア、カテゴリ、SKUのフィールドは公開ページのスナップショットとして扱い、succeeded でもアイテムがないタスクではプレースホルダーの商品を作成せずに処理してください。

TikTok Shop Product API 以外に別の種類の公開TikTok Shopデータが必要な場合は、これらのAPIをご利用ください。

  • TikTok Shop Search API — キーワードと市場地域で公開TikTok Shopの商品を検索し、出品者、価格、メディア、評価、レビュー、販売数の各フィールドを返します。
  • TikTok Shop Products API — TikTok ShopのストアURL 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 Product API — よくある質問

TikTok Shop Product APIは、対応するTikTok ShopのPDP URLから公開商品を1件取得するAPIです。正規化された商品情報、セラー、価格、評価、レビュー数と販売数、メディア、カテゴリ、SKUデータを返します。

パスが /shop/pdp/{numeric_id} または /shop/pdp/{slug}/{numeric_id} に一致する、tiktok.com またはTikTokサブドメインのURLを使用してください。その他のTikTok URLは無効な入力として拒否されます。

できません。各タスクで指定できる商品URLは1件で、results_limit は受け付けず、返される正規化商品レコードは最大1件です。

region のデフォルトは US で、US、GB、DE、FR、IT、ID、MY、MX、PH、SG、ES、TH、VN、BR、JP、IE を指定できます。US以外では商品の公開状況が異なる場合があります。

商品が削除された場合、選択したリージョンで利用できない場合、または公開ページに表示されていない場合は、有効なPDP URLでもレコードが返らないことがあります。

返された商品レコード1件につき0.7 SocQクレジットです。商品が返らなかったタスクには結果の料金はかかりません。