tiktok-shop/
product-reviews

1件の商品PDP URLから公開TikTok Shopレビューを取得し、レビュー本文、評価、レビュアー情報、画像、SKU、購入状況を正規化されたレコードとして返します。

TikTok Shop Product Reviews API

単一商品のPDP URL
公開レビュー本文と評価
SKUと購入状況
リージョン指定の取得
結果1件あたり0.3クレジット
準備完了
準備完了

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

README

SocQ 編集 · 更新

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

  1. 対応するTikTok ShopのPDP url を1件、20〜2,000の results_limit、商品の市場 region を用意します。
  2. リクエストを /v1/tiktok-shop/product-reviews に POST し、返された task_id を保存します。
  3. タスクが成功するか失敗を返すまで GET /v1/tasks/{task_id} をポーリングします。
  4. 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 true

TikTok 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 を意味せず、評価のみのレコードも有効です。

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

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

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

TikTok Shop Product Reviews API — よくある質問

TikTok Shop Product Reviews APIは、対応するTikTok ShopのPDP URL 1件について、公開されている購入者レビューを取得するAPIです。正規化されたレビュー本文、評価、レビュアー情報、画像、タイムスタンプ、商品とSKUの情報、国、明示的な購入ステータスのフラグを返します。

パスが /shop/pdp/{numeric_id} または /shop/pdp/{slug}/{numeric_id} に一致する、tiktok.com またはTikTokサブドメインのURLを使用してください。region のデフォルトは US で、US、GB、DE、FR、IT、ID、MY、MX、PH、SG、ES、TH、VN、BR、JP、IE を指定できます。

これらのフィールドは、公開レビューに付随する明示的な値のみを返します。いずれかのフィールドがない場合は、その値を false ではなく不明として扱い、購入確認やインセンティブの有無を推測しないでください。

results_limit は上限であり、件数を保証するものではありません。取得は、利用可能なレビューフィードの終端、上流の has_more による区切り、または上限に達した時点で停止します。また、削除された商品、利用できない商品、リージョン制限のある商品、公開アクセスできない商品ではレコードが返らないことがあります。

保存されたレビュー1件につき0.3 SocQクレジットで、ソースの全ページを通じて保存された重複のないレビューがすべて対象です。保存されたレビューがないタスクには結果の料金はかかりません。