使用场景
将 AliExpress 评价导入您的 WooCommerce 店铺
您的商品在 AliExpress 上有成千上万条评价，而在您的店铺里却一条都没有。以 JSON 获取这些评价，只需几行 PHP 即可创建 WooCommerce 原生评价。
为什么不用插件？
抓取 AliExpress 的评价导入插件在页面改版时就会失效，而且许多插件把评价存放在自己的数据表中，因此您的主题、结构化数据和星级评分都会忽略这些评价。
WooCommerce 评价其实就是类型为 review、带有 rating 元数据的 WordPress 评论。如果您用干净的 JSON 自行创建它们，它们会出现在普通评价会出现的所有位置：商品标签页、平均评分、结构化数据和评价小部件。
使用方式
- 找到 AliExpress 商品 ID：即链接中的数字，例如
aliexpress.com/item/1005006123456789.html。 - 选择评价：仅 5 星（
filter=5）、仅带图评价（filter=image），或来自您客户所在国家的评价（filter=local&country=US）。 - 使用
lang翻译评价（es_ES、fr_FR、de_DE……），使其与您店铺的语言一致。 - 将评价插入为 WooCommerce 评价，并保留 AliExpress 评价 ID，这样再次运行时就不会产生重复。
示例：从 AliExpress 到 WooCommerce 评价
请通过 WP-CLI 脚本或计划任务运行。它会读取某个 AliExpress 商品的 5 星评价，并将其创建为 WooCommerce 商品的评价。请将 $wc_product_id 替换为您店铺中该商品的 ID。
<?php
// Create WooCommerce reviews from the 5-star reviews of an AliExpress product.
// Run it with WP-CLI (wp eval-file import-reviews.php) or from a scheduled task.
$wc_product_id = 123; // your WooCommerce product
$response = wp_remote_get('https://api.aliexpress-reviews.com/v1/reviews/1005006123456789?filter=5&pageSize=20', [
'headers' => ['x-api-key' => getenv('REVIEWS_API_KEY')],
'timeout' => 30,
]);
if (is_wp_error($response) || wp_remote_retrieve_response_code($response) !== 200) {
exit('Request failed');
}
$reviews = json_decode(wp_remote_retrieve_body($response), true)['data'];
foreach ($reviews as $r) {
// Skip reviews imported on a previous run.
$exists = get_comments([
'post_id' => $wc_product_id,
'meta_key' => 'aliexpress_review_id',
'meta_value' => $r['id'],
'count' => true,
]);
if ($exists) continue;
wp_insert_comment([
'comment_post_ID' => $wc_product_id,
'comment_author' => $r['author'],
'comment_content' => $r['content'],
'comment_type' => 'review',
'comment_approved' => 1,
'comment_date' => $r['date'] . ' 12:00:00',
'comment_meta' => ['rating' => $r['rating'], 'aliexpress_review_id' => $r['id']],
]);
}
WC_Comments::clear_transients($wc_product_id);值得注意的细节
- 将 API key 保留在服务器端。请通过 PHP、WP-CLI 或 cron 运行导入，切勿在浏览器的 JavaScript 中运行。
- 去重。将 AliExpress 的
id存为评论元数据，并跳过已导入的评价。 - 照片（
filter=image，Max 套餐）：每条评价都包含图片 URL。如果希望在 AliExpress 删除图片后仍能保留，请将其下载到媒体库。 - 刷新评分。批量导入后，调用
WC_Comments::clear_transients( $wc_product_id )，以便重新计算平均评分。
诚实地使用评价
请如实标注这些评价：它们是 AliExpress 买家对该商品的评价，而非您的客户。在欧盟，消费者保护法要求您说明评价的来源，而清楚说明也正是建立信任的方式。
常见问题
这些评价会显示在 WooCommerce 评分和结构化数据中吗？
会，只要您像示例中那样将它们创建为 WooCommerce 评价（带有评分、类型为 review 的评论）。它们和其他评价一样会计入平均评分。
可以定时运行以保持评价最新吗？
可以。使用 WP-Cron 或服务器 cron 任务运行脚本，并跳过已导入的 ID。
我可以获取多少条评价？
Free 套餐每次请求最多 20 条，Pro 和 Max 最多 100 条，并可通过分页获取全部评价。根据套餐不同，配额为每天 100、1,000 或 10,000 次请求。
该 API 与 AliExpress 有关联吗？
没有。它返回 AliExpress 在商品页面上展示的公开评价，但它是一项独立的服务。
用您自己的商品试一试
每天 100 次免费请求，无需银行卡。在控制台的测试工具中粘贴商品 ID，即可查看 JSON。