logo
languageJPdown
menu

TikTok Shop 商品レビュー

TikTok Shop 米国の商品 ID または SPU と取得上限を渡すと、公開レビュー、評価、SKU 情報、投稿者情報を受け取れます

翻訳済み · ja-JP原文を表示

概要

公開されている TikTok Shop 米国のレビューは、買い手がフィット感、品質、実際に購入した SKU を自分の言葉でどう語るかを残します。この Data App は、米国出品 1 件の公開レビュー欄を、レビュー本文、評価、SKU 情報、投稿者、収集時刻を含む一貫した記録にします。

結果は、商品ページをスクロールする代わりに、繰り返し使える評判分析向けです。各レビューは原文を保ち、商品ID、SPU ID、SKU仕様 に紐づくので、サイズや収集回をまたいで同じ項目で比較できます。

データ説明

データは、収集時点の Product ID / SPU 1 件に対する公開 TikTok Shop 米国レビューを対象にします。結果は収集時刻順で、通常の各記録は コメントID で識別されます。米国外のマーケットプレイス、非公開のフィードバック、注文、買い手の連絡先は対象外です。

評価、商品評価、SKU仕様、ユーザー名、匿名 や 編集済み などのフラグはスナップショットであり、収集後に変わることがあります。アバター一覧、画像一覧、いいね数 は、ソースがその形で返す場合はソーステキストのまま保持されます。公開時刻、収集時刻、作成時刻、更新時刻 はタイムゾーンを推定せずソースの時刻を保ちます。照会商品 と データなし は、公開レビュー結果がない場合の収集結果を残します。

結果はどのような形か

通常の各記録は、選んだ TikTok Shop 米国商品の公開レビュー 1 件を表します。

コメントIDレビュー本文評価ユーザー名SKU仕様公開時刻
7634602945472333582So I bought the zoom regular shoes last year, but they are too soft too spongy when you’re just walking around these are just right! Wide toe box Support you need support soft where you need it soft! I owned just about every air max and this is the best I’ve felt on my feet! Can’t say enough5Os HsUS M 132026-05-01T01:18:51
7646028688848471821Best Nike out5b**dUS M 112026-05-31T20:16:30
7661519510674917133Great shoe great quality. I love it.5S**4US M 102026-07-12T14:08:54

追加の値には 商品ID、SPU ID、SKU ID、アバター一覧、画像一覧、データなし があります。

利用シーン

  • 評価 でレビューを分け、レビュー本文 を読んで低評価の論点を見つけます。
  • SKU仕様 ごとに レビュー本文 をまとめ、サイズ別の体験を分けます。
  • ユーザー名 を 匿名 と レビュー本文 と突き合わせ、レビューの重みを判断します。
  • 公開時刻 ごとに コメントID を数え、フィードバックの構成がどう変わったかを見ます。

適用範囲と境界

1 回の実行では TikTok Shop の商品 ID または SPU を 1 件受け付け、公開レビューを最大 4500 件収集します。対象は米国マーケットプレイスのみです。取得保護は 225 ページ / 4500 件です。

  • 適している用途
  • TikTok Shop 米国の商品 1 件について、公開レビュー本文、評価、公開時刻が必要なとき
  • 評判分析のために SKU 情報、投稿者名、収集時刻が必要なとき
  • 適さない用途
  • 米国以外の TikTok Shop マーケットプレイスのレビューが必要なとき
  • 1 回の収集スナップショットではなく、新規レビューのリアルタイム監視が必要なとき
  • 注文、買い手の連絡先、その他の非公開ショップデータが必要なとき

失敗時の処理

作者が宣言した失敗時と再試行の動作です。連携時にはシステムプロンプトに含めることをおすすめします。

  1. 1レビューが返らない場合は、商品 ID または SPU を確認し、データなしで空の出品と失敗を区別してください
  2. 2部分成功でも完了したレビューは返ります。失敗または期限切れのあとは新しい収集を送信してください
  3. 3認証失敗、タスクコンテキスト不一致、タイムアウトの場合は、実行環境の認証情報を確認し、旧ジョブを再利用せず新しい収集を送信してください

入力

この App の呼び出しに必要なパラメータで、manifest.json の input.schema から生成されています。

フィールド業務名称型必須デフォルト列挙値/制約例説明
product_item商品 ID / SPUstringはい——1732075599219691674公開されている米国レビューを収集する TikTok Shop の商品 ID または SPU です。識別子を 1 件、1〜512 文字で入力します。
crawl_count最大取得レビュー数stringはい——10収集する公開レビューの上限で、1〜4500 です。この数を超えることはなく、商品のレビューが少ない場合はそれより少なくなることがあります。

出力

1 件のレコードのフィールド構造で、manifest.json の output.schema から生成されています。

フィールド業務名称型例説明
avatar_url_listアバター一覧string["https://p16-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/7b7cc85e68a43794946269620078f2ac~tplv-tiktokx-cropcenter:100:100.jpg?dr=9640&refresh_token=b3f5fbe0&x-expires=1789545600&x-signature=jtdzYiVEWHbBH%2FlrOMkcxiRjLfU%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=5f8d3399&idc=useast5"]投稿者のアバターURL。ソーステキストのまま保持され、多くの場合 JSON のリスト文字列です。
biz_idビジネスIDstring1732075599219691674このレビューに紐づくビジネス識別子です。
comment_idコメントIDstring7634602945472333582この商品レビューの一意の識別子です。
comment_source_nameソース名string—ソースが返す場合のレビューソース名です。
comment_source_typeソース種別string—ソースが返す場合のレビューソース種別です。
comment_textレビュー本文stringSo I bought the zoom regular shoes last year, but they are too soft too spongy when you’re just walking around these are just right! Wide toe box Support you need support soft where you need it soft! I owned just about every air max and this is the best I’ve felt on my feet! Can’t say enough買い手が書いた公開レビュー本文です。
comment_time_textレビュー時刻テキストstring—ソースが返す場合のレビュー時刻の表示テキストです。
comment_typeレビュー種別string1ソーステキストとして返されるレビュー種別コードです。
comment_urlレビューURLstring—ソースが返す場合のこのレビューへのリンクです。
crawl_time収集時刻string2026-09-14T16:19:49ソースが返す収集時刻です。タイムゾーンは推定しません。
created_at作成時刻string1789373989528ソーステキストのまま保持されるレコード作成時刻です。
image_url_list画像一覧string[]レビュー画像URL。ソーステキストのまま保持され、多くの場合 JSON のリスト文字列です。
is_anonymous匿名booleanfalse投稿者が匿名とマークされているかどうかです。
is_diggedいいね済みbooleanfalseこのレビューがいいね済みとマークされているかどうかです。
is_owner販売者レビューbooleanfalseこのレビューが販売者による投稿とマークされているかどうかです。
is_updated編集済みbooleanfalseこのレビューが編集済みとマークされているかどうかです。
item_idアイテムIDstring1732075599219691674このレビューに紐づくアイテム識別子です。
like_countいいね数string—このレビューのいいね数。ソーステキストのまま保持されます。
parent_comment_id親コメントIDstring—この行が返信である場合の親レビュー識別子です。
product_id商品IDstring1732075599219691674このレビューに紐づく商品識別子です。
product_rating商品評価string5このレビューと一緒に返される商品評価。ソーステキストです。
publish_time公開時刻string2026-05-01T01:18:51ソースが返すレビュー公開時刻です。タイムゾーンは推定しません。
rating_score評価string5このレビューに付いた星評価。ソーステキストです。
ratings_url評価URLstring—ソースが返す場合の評価ページへのリンクです。
sku_idSKU IDstring1732075635013226650買い手が購入した SKU の識別子です。
sku_specificationSKU仕様stringUS M 13サイズなどの SKU 仕様テキストです。
spu_idSPU IDstring1732075599219691674このレビューに紐づく SPU 識別子です。
task_item照会商品string1732075599219691674この収集行が紐づく商品 ID または SPU です。
no_dataデータなしbooleanfalse通常のレビューではなく、結果なしマーカーの行かどうかです。
updated_at更新時刻string1789373989851ソーステキストのまま保持されるレコード更新時刻です。
user_idユーザーIDstring7435352589535626286投稿者のユーザー識別子です。
user_nameユーザー名stringO**s H**s投稿者の表示名。マスクされている場合があります。
user_profile_urlプロフィールURLstring—ソースが返す場合の投稿者プロフィールリンクです。

レコード Schema

出力はレコード単位で 1 件ずつ返されます。 detail.output.idFieldHint

output.schema
{
  "type": "object",
  "properties": {
    "avatar_url_list": {
      "type": "string",
      "title": "アバター一覧",
      "description": "投稿者のアバターURL。ソーステキストのまま保持され、多くの場合 JSON のリスト文字列です。",
      "prefill": "[\"https://p16-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/7b7cc85e68a43794946269620078f2ac~tplv-tiktokx-cropcenter:100:100.jpg?dr=9640&refresh_token=b3f5fbe0&x-expires=1789545600&x-signature=jtdzYiVEWHbBH%2FlrOMkcxiRjLfU%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=5f8d3399&idc=useast5\"]"
    },
    "biz_id": {
      "type": "string",
      "title": "ビジネスID",
      "description": "このレビューに紐づくビジネス識別子です。",
      "prefill": "1732075599219691674"
    },
    "comment_id": {
      "type": "string",
      "title": "コメントID",
      "description": "この商品レビューの一意の識別子です。",
      "prefill": "7634602945472333582"
    },
    "comment_source_name": {
      "type": "string",
      "title": "ソース名",
      "description": "ソースが返す場合のレビューソース名です。"
    },
    "comment_source_type": {
      "type": "string",
      "title": "ソース種別",
      "description": "ソースが返す場合のレビューソース種別です。"
    },
    "comment_text": {
      "type": "string",
      "title": "レビュー本文",
      "description": "買い手が書いた公開レビュー本文です。",
      "prefill": "So I bought the zoom regular shoes last year, but they are too soft too spongy when you’re just walking around these are just right! Wide toe box Support you need support soft where you need it soft! I owned just about every air max and this is the best I’ve felt on my feet! Can’t say enough"
    },
    "comment_time_text": {
      "type": "string",
      "title": "レビュー時刻テキスト",
      "description": "ソースが返す場合のレビュー時刻の表示テキストです。"
    },
    "comment_type": {
      "type": "string",
      "title": "レビュー種別",
      "description": "ソーステキストとして返されるレビュー種別コードです。",
      "prefill": "1"
    },
    "comment_url": {
      "type": "string",
      "title": "レビューURL",
      "description": "ソースが返す場合のこのレビューへのリンクです。"
    },
    "crawl_time": {
      "type": "string",
      "title": "収集時刻",
      "description": "ソースが返す収集時刻です。タイムゾーンは推定しません。",
      "prefill": "2026-09-14T16:19:49"
    },
    "created_at": {
      "type": "string",
      "title": "作成時刻",
      "description": "ソーステキストのまま保持されるレコード作成時刻です。",
      "prefill": "1789373989528"
    },
    "image_url_list": {
      "type": "string",
      "title": "画像一覧",
      "description": "レビュー画像URL。ソーステキストのまま保持され、多くの場合 JSON のリスト文字列です。",
      "prefill": "[]"
    },
    "is_anonymous": {
      "type": "boolean",
      "title": "匿名",
      "description": "投稿者が匿名とマークされているかどうかです。",
      "prefill": false
    },
    "is_digged": {
      "type": "boolean",
      "title": "いいね済み",
      "description": "このレビューがいいね済みとマークされているかどうかです。",
      "prefill": false
    },
    "is_owner": {
      "type": "boolean",
      "title": "販売者レビュー",
      "description": "このレビューが販売者による投稿とマークされているかどうかです。",
      "prefill": false
    },
    "is_updated": {
      "type": "boolean",
      "title": "編集済み",
      "description": "このレビューが編集済みとマークされているかどうかです。",
      "prefill": false
    },
    "item_id": {
      "type": "string",
      "title": "アイテムID",
      "description": "このレビューに紐づくアイテム識別子です。",
      "prefill": "1732075599219691674"
    },
    "like_count": {
      "type": "string",
      "title": "いいね数",
      "description": "このレビューのいいね数。ソーステキストのまま保持されます。"
    },
    "parent_comment_id": {
      "type": "string",
      "title": "親コメントID",
      "description": "この行が返信である場合の親レビュー識別子です。"
    },
    "product_id": {
      "type": "string",
      "title": "商品ID",
      "description": "このレビューに紐づく商品識別子です。",
      "prefill": "1732075599219691674"
    },
    "product_rating": {
      "type": "string",
      "title": "商品評価",
      "description": "このレビューと一緒に返される商品評価。ソーステキストです。",
      "prefill": "5"
    },
    "publish_time": {
      "type": "string",
      "title": "公開時刻",
      "description": "ソースが返すレビュー公開時刻です。タイムゾーンは推定しません。",
      "prefill": "2026-05-01T01:18:51"
    },
    "rating_score": {
      "type": "string",
      "title": "評価",
      "description": "このレビューに付いた星評価。ソーステキストです。",
      "prefill": "5"
    },
    "ratings_url": {
      "type": "string",
      "title": "評価URL",
      "description": "ソースが返す場合の評価ページへのリンクです。"
    },
    "sku_id": {
      "type": "string",
      "title": "SKU ID",
      "description": "買い手が購入した SKU の識別子です。",
      "prefill": "1732075635013226650"
    },
    "sku_specification": {
      "type": "string",
      "title": "SKU仕様",
      "description": "サイズなどの SKU 仕様テキストです。",
      "prefill": "US M 13"
    },
    "spu_id": {
      "type": "string",
      "title": "SPU ID",
      "description": "このレビューに紐づく SPU 識別子です。",
      "prefill": "1732075599219691674"
    },
    "task_item": {
      "type": "string",
      "title": "照会商品",
      "description": "この収集行が紐づく商品 ID または SPU です。",
      "prefill": "1732075599219691674"
    },
    "no_data": {
      "type": "boolean",
      "title": "データなし",
      "description": "通常のレビューではなく、結果なしマーカーの行かどうかです。",
      "prefill": false
    },
    "updated_at": {
      "type": "string",
      "title": "更新時刻",
      "description": "ソーステキストのまま保持されるレコード更新時刻です。",
      "prefill": "1789373989851"
    },
    "user_id": {
      "type": "string",
      "title": "ユーザーID",
      "description": "投稿者のユーザー識別子です。",
      "prefill": "7435352589535626286"
    },
    "user_name": {
      "type": "string",
      "title": "ユーザー名",
      "description": "投稿者の表示名。マスクされている場合があります。",
      "prefill": "O**s H**s"
    },
    "user_profile_url": {
      "type": "string",
      "title": "プロフィールURL",
      "description": "ソースが返す場合の投稿者プロフィールリンクです。"
    }
  },
  "required": [],
  "additionalProperties": false
}

連携方法

この App は MCP、API、SDK、ファイルエクスポートのいずれでも連携でき、どのチャネルも同じ能力と料金を共有します。すべてのリクエストは Authorization: Bearer ヘッダーで認証し、認証情報には API Key(長期有効。Data Hub コンソールで作成)を使用します。MCP クライアントは OAuth によるキー不要のログインにも対応しています。CLI や Skill など、さらに多くの連携方法も準備中です。

MCP(Model Context Protocol)を使うと、Claude や Cursor などの AI クライアントからこの App を直接呼び出せます。クライアントと認証方式を選び、下の設定をコピーしてください。

クライアント設定

Bearer の後の値を長期有効な API Key に置き換えてください。あらゆるクライアント、CI、ヘッドレス環境で利用できます。

mcpServers config
{
  "mcpServers": {
    "super_ig__tiktok-shop-comment": {
      "type": "http",
      "url": "https://mcp-v2.octoparse.com?pin=super_ig/tiktok-shop-comment",
      "headers": { "Authorization": "Bearer <YOUR_API_KEY>" }
    }
  }
}

AI に設定を任せる

設定を手作業で編集したくない場合は、インストールプロンプトをコピーして任意の AI クライアントに貼り付けてください。AI が自分のやり方でセットアップを完了します(プロンプトは AI があなたに API Key を尋ねる形になっているため、認証情報がチャット履歴や共有設定に残りません)。

detail.access.mcp.composeHint

料金

レビュー 30 件ごと

正常に返されたレコードの件数に応じて課金されます。失敗した実行には課金されません。 30 件を 1 つの課金単位とし、端数は 30 件に切り上げて課金されます。

$0.005/ 30 件
Per task submitted

返される件数にかかわらず、実行の送信 1 回ごとに課金されます。

$0.0001/ 回

複数の課金イベントはそれぞれ独立して累計されます。詳細は各項目をご覧ください。失敗した実行には課金されません。

Credits を確認

今すぐ試す

パラメータを入力して実行してください。結果は実際の呼び出しによるものです。

サンプル
パラメータは送信前に input.schema で検証されます
まず必須パラメータを入力してください
$0.005 / 30 件から