Tmall Product Reviews

Collect public Tmall reviews for one product SPU and return the original review payload, publish times, and shop context

原文 · en-US訳文に戻す

データ収集 E-commerce & Retail Tmall Reviews & Ratings

開発者

super_ig

料金

$0.03 / 20 件から

最終更新

2026-10-13

概要

Public Tmall product reviews capture how buyers describe quality, after-sales experience, and the SKU they actually purchased. This Data App turns the public review area of one Tmall product SPU into a consistent set of records covering the original review payload, publish times, shop and category context, and collection timestamps.

The result is built for repeatable reputation analysis instead of scrolling a product page. Each review keeps its source wording inside Comment data and stays linked to the Product SPU, SKU, and shop, so praise and complaints can be compared across collection runs with the same fields.

Data notes

The data covers publicly visible Tmall product reviews for the supplied Product SPU at collection time, stopping at the review cutoff time. Each normal record is identified by its Comment ID, which removes duplicates across collected pages. Private, deleted, and non-public reviews are outside the coverage.

Comment data keeps the original review payload as source text, including buyer nicknames, ratings, photos, and body text when the source supplies them that way. Comment type, Parent ID, and SKU ID are source codes, not rewritten labels. Comment time, Published at, Collected at, Created at, and Updated at preserve the source timestamps without inferring a timezone. Source product SPU and No data retain the collection outcome when a product has no public review result.

What the results look like

Each normal record represents one publicly visible review of the selected Tmall product.

Comment ID	Business ID	Comment type	Published at	Collected at	SPU ID
45a19df1788dadb35bc37062c6732310	1076118072642	1	2026-08-22T16:45:00	2026-10-13T12:42:52	1076118072642
7c21b0ae9d4f18c06a5e2b91c8d03417	1076118072642	1	2026-08-18T11:20:00	2026-10-13T12:42:52	1076118072642

Additional values include Comment data, Shop name, Brand name, Category path, and No data.

Use cases

Read Comment data to locate quality complaints, then group by Comment type.
Compare Published at with Collected at to see how recently the review was captured.
Split records by SPU ID and Business ID when comparing more than one collected product.
Use No data with Source product SPU to distinguish an empty listing from a failed collection.

適用範囲と境界

Each run accepts one Tmall product SPU, a review cutoff time, and a maximum of 1 to 2000 public reviews. Only publicly visible Tmall reviews are covered.

適している用途
When you need public Tmall review payloads, publish times, and shop context for one product SPU
When you need category, brand, and collection timestamps for Tmall reputation analysis

適さない用途
When you need reviews from a marketplace other than Tmall
When you need real-time monitoring of newly posted reviews instead of one collection snapshot
When you need private, deleted, or otherwise non-public reviews

失敗時の処理

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

1If no reviews are returned, verify the Product SPU, the review cutoff time, and use No data to distinguish an empty listing from a failed job
2A partial success still returns the reviews that were completed; submit a new collection after failure or expiry
3If authentication fails, a task context does not match, or the job times out, check the credential in the execution environment and submit a new collection instead of reusing the old job
4When the submission outcome is unknown, avoid immediate repeated submissions that could create duplicate tasks

入力

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

Product SPUproduct_spu必須string
The Tmall product SPU whose public reviews will be collected. Enter one identifier, 1 to 512 characters.
例1071060010572
Maximum reviews to collectcomment_count必須string
The maximum number of public reviews to collect, from 1 to 2000. The result will not exceed this number and may be lower if the product has fewer reviews before the cutoff time.
例1
Review cutoff timecutoff_time必須string
Unix millisecond timestamp as a 10 to 13 digit string. Collection stops after reaching this comment time. This value is required.
例1791789622000

出力

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

Source APIapistring
The source API name carried on the review record
Business IDbiz_idstring
The business identifier linking the review record to the collected product
例1076118072642
Brand IDbrand_idstring
The brand identifier associated with the reviewed product
Brand namebrand_namestring
The brand name associated with the reviewed product

サンプルデータ

output.schema から生成したサンプルです。サンプル値のないフィールドには構造上のプレースホルダーを使用しています。

output.example

{
  "api": "<api>",
  "biz_id": "1076118072642",
  "brand_id": "<brand_id>",
  "brand_name": "<brand_name>",
  "cat_id": "<cat_id>",
  "cat_name": "<cat_name>",
  "cat_path": "<cat_path>",
  "comment_data": "{\"auctionSku\": \"净含量:60g[【专攻脂肪粒⭐轻度适用】]\", \"avatar\": \"https://gw.alicdn.com/imgextra/i3/O1CN01YXMxVW1ng5k8sZ6L3_!!6000000005118-0-tps-160-160.jpg_Q75.jpg_.webp\", \"commentTime\": null, \"comment_id\": null, \"comment_text\": null, \"comment_time\": null, \"content\": null, \"days\": null, \"displayUserNick\": \"t***0\", \"fullUserNick\": null, \"id\": \"45a19df1788dadb35bc37062c6732310\", \"likeCount\": \"1\", \"originCommentContent\": null, \"originCommentTime\": null, \"originCommentUser\": null, \"pics\": [\"//img.alicdn.com/imgextra/i3/4611686018427383849/O1CN01HJNU3xUTNeB2I0G4_!!4611686018427383849-0-rate.jpg_40x40.jpg\", \"//img.alicdn.com/imgextra/i2/4611686018427387741/O1CN01JubAws7NS4H2I0G4_!!4611686018427387741-0-rate.jpg_40x40.jpg\"], \"rate\": \"1\", \"rateContent\": \"眼下和眼皮上长了好几颗脂肪粒，化妆的时候卡粉卡得特别厉害，粉底一涂上去就1块1块的，用这个眼霜重点涂了颗粒的位置，每天早晚坚持，大概2周颗粒就小了，摸上去平了很多，化妆也顺畅了，第2盒半价果断又囤了2盒\", \"rateDate\": \"2026-08-22 16:45:00\", \"sku_id\": null, \"videoList\": []}",
  "comment_id": "45a19df1788dadb35bc37062c6732310",
  "comment_time": "2026-08-22T16:45:00",
  "comment_type": "1",
  "crawl_time": "2026-10-13T12:42:52",
  "created_at": "{\"$numberLong\":\"1791866572389\"}",
  "insert_timestamp": "<insert_timestamp>",
  "no_data": false,
  "old_comment_id": "2832491419252369",
  "order_id": "<order_id>",
  "origin_comment_id": "45a19df1788dadb35bc37062c6732310",
  "origin_comment_self_id": "<origin_comment_self_id>",
  "pid": "0",
  "plat": "<plat>",
  "product_title": "<product_title>",
  "publish_time": "2026-08-22T16:45:00",
  "seller_id": "<seller_id>",
  "shop_id": "<shop_id>",
  "shop_name": "<shop_name>",
  "shop_type": "<shop_type>",
  "sign_url": "<sign_url>",
  "sku_id": "<sku_id>",
  "source_product_spu": "1071060010572",
  "spu_id": "1076118072642",
  "updated_at": "{\"$numberLong\":\"1791866640634\"}"
}

連携方法

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

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

クライアント設定

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

mcpServers config

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

自分の API Keys を表示 →

AI に設定を任せる

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

detail.access.mcp.composeHint

料金

Submit one review collection

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

$0.0001/ 回

Return 20 review

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

$0.03/ 20 件

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

Credits を確認

今すぐ試す

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

サンプル

パラメータは送信前に input.schema で検証されます

Product SPUproduct_spu*The Tmall product SPU whose public reviews will be collected. Enter one identifier, 1 to 512 characters.

Maximum reviews to collectcomment_count*The maximum number of public reviews to collect, from 1 to 2000. The result will not exceed this number and may be lower if the product has fewer reviews before the cutoff time.

Review cutoff timecutoff_time*Unix millisecond timestamp as a 10 to 13 digit string. Collection stops after reaching this comment time. This value is required.