TikTok Shop Product Reviews
TikTok Shopの商品レビューは、本文、評価、レビュアー名、画像、タイムスタンプ、SKU情報、国、明示的な購入ステータスのフラグを含む公開の購入者フィードバックです。これらのフィールドは、商品フィードバックの分析、バリエーション別・地域別の比較、根拠を踏まえたレビューワークフローに活用できます。
TikTok Shop Product Reviews API の主な機能
- リージョンを指定した単一商品の取得対応する公開PDP URLを1件と市場リージョンを送信し、その商品で公開されている重複のないレビューを指定した上限まで取得します。
- レビュー内容・評価・投稿者・メディア正規化された各レコードには、公開されているレビュー本文、数値評価、レビュアー情報、画像、投稿日時、商品URL、取得日時が保持されます。
- 商品・SKU・国・購入状況レビューレコードには、商品IDとSKU ID、バリエーションの仕様、レビューの国に加え、提供されている場合は購入確認済みやインセンティブ付きレビューを示す明示的なフラグが保持されます。
TikTok Shop Product Reviews API のパラメータ
| パラメータ | 必須 | 説明 |
|---|---|---|
url | 必須 | 必須。/shop/pdp/{numeric_id} または /shop/pdp/{slug}/{numeric_id} に一致する公開TikTok Shop URLです。1つのタスクで指定できる商品は1件です。 |
results_limit | 任意 | ソースの全ページを通じて保存する重複のないレビューの最大件数です。デフォルトは100で、20〜2,000の整数を指定できます。 |
region | 任意 | TikTok Shopの市場リージョンです。デフォルトは US で、その他の対応リージョンでは商品やレビューの公開状況が異なる場合があります。 |
TikTok Shop Product Reviews API の使い方
対応する商品URLを1件送信し、非同期タスクを追跡して、正規化されたレビューレコードをカーソルページネーションで読み取ります。
- 対応するTikTok ShopのPDP url を1件、20〜2,000の results_limit、商品の市場 region を用意します。
- リクエストを /v1/tiktok-shop/product-reviews に POST し、返された task_id を保存します。
- タスクが成功するか失敗を返すまで GET /v1/tasks/{task_id} をポーリングします。
- data.results.items を読み取り、has_more が true の間は返された next_cursor を指定して続きを取得します。
curl -X POST "https://api.socq.ai/v1/tiktok-shop/product-reviews" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"url":"https://www.tiktok.com/shop/pdp/example-product/1729587769570529799","results_limit":100,"region":"US"}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueTikTok Shop Product Reviews API の主なユースケース
- 商品フィードバックの分析: レビュー本文、数値評価、タイムスタンプ、商品情報を使って、特定の既知商品について返された公開フィードバックを分析します。
- SKU別・地域別のフィードバック比較: SKUの仕様やレビューの国でレコードをグループ化し、欠けているフィールドの値を推測せずに本文と評価を比較します。
- 購入状況とレビュー画像の確認: 購入者が投稿した画像を確認し、値がある場合は購入確認済みやインセンティブ付きレビューの明示的なフラグでレコードを分類します。
TikTok Shop Product Reviews API 活用のヒント
- プロフィール、動画、ショップなどのTikTok URLは拒否されるため、送信前に入力が数値の商品IDを含む完全なtiktok.comのPDP URLであることを確認してください。
- 商品の市場に合ったリージョンを選択してください。有効なURLでも、選択した市場で商品やレビューが公開されていない場合は公開レビューが返らないことがあります。
- 取得範囲に応じて results_limit を20〜2,000の間で設定し、保存された結果ページをすべて読み取るには has_more が false になるまで next_cursor をたどってください。
- レビュー本文、レビュアー情報、SKU情報、購入ステータスのフラグがない場合は不明として扱ってください。booleanがないことは false を意味せず、評価のみのレコードも有効です。
関連API
TikTok Shop Product Reviews 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 User Showcase API — TikTokユーザー名1件について公開ショーケースの商品を取得し、価格、出品者、メディア、評価、レビュー、販売数、地域情報を返します。
- TikTok Shop Hot Products API — 地域コードで選んだTikTok Shop市場の売れ筋商品を、ランキング順に価格と通貨、販売数、評価、ショップとともに取得します。
- TikTok Shop Categories API — TikTok Shop市場のカテゴリツリー全体を、カテゴリID、名前、英語のスラッグ、階層、親カテゴリ、パスとともに取得します。