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を保存して、タスクの成功後に正規化された商品を読み取ります。
- 対応するPDP url を1件と任意の region を指定して、/v1/tiktok-shop/product に POST リクエストを送信します。
- 返された task_id を保存し、status が succeeded または failed になるまで GET /v1/tasks/{task_id} をポーリングします。
- 成功したら 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 succeededTikTok 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 でもアイテムがないタスクではプレースホルダーの商品を作成せずに処理してください。
関連API
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、名前、英語のスラッグ、階層、親カテゴリ、パスとともに取得します。