{ "spec_version": "0.2", "namespace": "data_hunter", "app_name": "app-store-reviews", "app_id": "app_ac5a31d324f0", "status": "published", "open_to": "public", "accepting_runs": true, "source_locale": "zh-CN", "identity": { "app_name": "app-store-reviews", "name": "App Store 评论", "summary": "输入 App 和国家/地区，返回该 App 在 App Store 的用户评分与评论", "type": "data", "version": "0.1.1" }, "discovery": { "capability": "data-acquisition", "keywords": [ "App Store", "苹果应用评论", "iOS 评论", "用户评分", "竞品分析", "ASO" ], "boundary": "每次最多 10 个 App × 10 个国家/地区；每个 App 在每个国家/地区按一种排序最多返回约 500 条最近公开的评论，更早的评论取不到" }, "input": { "schema": { "type": "object", "properties": { "apps": { "type": "array", "title": "App ID 或 App Store 链接", "description": "要采集评论的 App，填纯数字 App ID（如 835599320）或 App Store 中该 App 的页面链接，1–10 个。", "items": { "type": "string", "title": "App", "description": "纯数字 App ID，或含 id 加数字的 App Store 链接", "pattern": "^(\\d{6,12}|https?://\\S*id\\d{6,12}\\S*)$" }, "minItems": 1, "maxItems": 10, "prefill": [ "835599320" ] }, "countries": { "type": "array", "title": "国家/地区", "description": "在哪些国家/地区的 App Store 采集评论，同一个 App 在不同国家的评论互不相同，最多选 10 个。不填默认美国。", "items": { "type": "string", "title": "国家/地区", "description": "App Store 国家/地区", "enum": [ "us", "cn", "hk", "tw", "mo", "jp", "kr", "sg", "my", "th", "vn", "id", "ph", "in", "pk", "lk", "np", "kh", "la", "mm", "mn", "kz", "uz", "au", "nz", "gb", "ie", "de", "fr", "it", "es", "pt", "nl", "be", "lu", "ch", "at", "se", "no", "dk", "fi", "is", "pl", "cz", "sk", "hu", "ro", "bg", "gr", "hr", "si", "rs", "ba", "ee", "lv", "lt", "ua", "ru", "md", "tr", "cy", "mt", "il", "ae", "sa", "qa", "kw", "bh", "om", "jo", "lb", "eg", "ma", "tn", "dz", "ng", "ke", "gh", "za", "tz", "ug", "ca", "mx", "br", "ar", "cl", "co", "pe", "ec", "uy", "py", "bo", "ve", "cr", "pa", "gt", "do", "sv", "hn", "jm" ], "suggested_values": [ "us", "cn", "jp", "kr", "gb", "de", "fr", "ca", "au", "br", "mx", "id", "th", "vn", "sa" ], "enum_titles": [ "美国", "中国大陆", "中国香港", "中国台湾", "中国澳门", "日本", "韩国", "新加坡", "马来西亚", "泰国", "越南", "印度尼西亚", "菲律宾", "印度", "巴基斯坦", "斯里兰卡", "尼泊尔", "柬埔寨", "老挝", "缅甸", "蒙古", "哈萨克斯坦", "乌兹别克斯坦", "澳大利亚", "新西兰", "英国", "爱尔兰", "德国", "法国", "意大利", "西班牙", "葡萄牙", "荷兰", "比利时", "卢森堡", "瑞士", "奥地利", "瑞典", "挪威", "丹麦", "芬兰", "冰岛", "波兰", "捷克", "斯洛伐克", "匈牙利", "罗马尼亚", "保加利亚", "希腊", "克罗地亚", "斯洛文尼亚", "塞尔维亚", "波黑", "爱沙尼亚", "拉脱维亚", "立陶宛", "乌克兰", "俄罗斯", "摩尔多瓦", "土耳其", "塞浦路斯", "马耳他", "以色列", "阿联酋", "沙特阿拉伯", "卡塔尔", "科威特", "巴林", "阿曼", "约旦", "黎巴嫩", "埃及", "摩洛哥", "突尼斯", "阿尔及利亚", "尼日利亚", "肯尼亚", "加纳", "南非", "坦桑尼亚", "乌干达", "加拿大", "墨西哥", "巴西", "阿根廷", "智利", "哥伦比亚", "秘鲁", "厄瓜多尔", "乌拉圭", "巴拉圭", "玻利维亚", "委内瑞拉", "哥斯达黎加", "巴拿马", "危地马拉", "多米尼加", "萨尔瓦多", "洪都拉斯", "牙买加" ] }, "minItems": 1, "maxItems": 10 }, "sort": { "type": "string", "title": "排序方式", "description": "按最新发布还是按最有用（获得有用票最多）取评论。不填默认最新。", "default": "most_recent", "enum": [ "most_recent", "most_helpful" ], "enum_titles": [ "最新", "最有用" ] }, "max_reviews": { "type": "integer", "title": "每个 App 每个国家最多条数", "description": "每个 App 在每个国家/地区最多取多少条评论，范围 1–500，不填默认 500。评论较少的 App 实际返回会更少。", "default": 500, "minimum": 1, "maximum": 500 } }, "required": [ "apps" ], "additionalProperties": false } }, "output": { "id_field": "review_id", "schema": { "type": "object", "properties": { "review_id": { "type": "string", "title": "评论 ID", "description": "App Store 为这条评论分配的唯一编号", "prefill": "14741690848" }, "app_id": { "type": "string", "title": "App ID", "description": "被评论 App 的数字编号", "prefill": "835599320" }, "app_name": { "type": "string", "title": "App 名称", "description": "App 在该国家/地区 App Store 中显示的名称", "prefill": "TikTok - Videos, Shop & LIVE" }, "country": { "type": "string", "title": "国家/地区", "description": "评论所在 App Store 的国家/地区代码，如 us 表示美国", "prefill": "us" }, "rating": { "type": "integer", "title": "评分", "description": "用户给出的星级，1 到 5", "prefill": 5 }, "title": { "type": "string", "title": "评论标题", "description": "用户填写的评论标题", "prefill": "doomscroll" }, "content": { "type": "string", "title": "评论内容", "description": "评论正文，保持用户原文的语言", "prefill": "TikTok is the best app in my entire life, I recommend this" }, "app_version": { "type": "string", "title": "评论时版本", "description": "用户写评论时使用的 App 版本号", "prefill": "47.5.0" }, "author_name": { "type": "string", "title": "评论者昵称", "description": "评论者在 App Store 显示的昵称", "prefill": "YESYAYAYAYAYAYAY" }, "author_url": { "type": "string", "title": "评论者主页", "description": "评论者在 App Store 的评论主页地址", "prefill": "https://itunes.apple.com/us/reviews/id1187906619" }, "published_at": { "type": "string", "title": "发布时间", "description": "评论发布或最后修改的时间，带时区的 ISO 8601 格式", "prefill": "2026-11-02T05:14:15-07:00" }, "helpful_votes": { "type": "integer", "title": "有用票数", "description": "其他用户认为这条评论有用的票数", "prefill": 0 }, "total_votes": { "type": "integer", "title": "总投票数", "description": "其他用户对这条评论投出的有用和没用票的总数", "prefill": 0 } }, "required": [], "additionalProperties": false } }, "execution": { "mode": "async", "timeout_seconds": 3600, "cancel_notify": false, "recovers_partial_on_cancel": false }, "knowledge": { "when_to_use": [ "需要某个 iOS App 在指定国家/地区的用户评分和评论原文，用于口碑分析、竞品对比或需求挖掘", "需要按版本号或时间观察一个 App 的评价变化" ], "when_not_to_use": [ "需要一个 App 的全部历史评论或超过 500 条的单一国家评论：本应用只能取到最近约 500 条", "需要安卓应用评论：本应用只覆盖苹果 App Store" ], "failure_handling": [ "App 在所选国家/地区不存在时该组合不返回评论；全部组合都不存在时运行失败，请核对 App ID 和国家/地区", "App Store 暂时无法访问时运行失败并标记为可重试，稍后重新运行即可", "评论数量少于上限属正常情况，说明该 App 在这个国家/地区的公开评论本身较少" ] }, "pricing": { "events": [ { "event": "record", "label": "条评论", "unit_price": 0.0003, "qty_from": "", "unit_size": null } ] }, "examples": [ { "id": "tiktok-us-latest", "goal": "取 TikTok 美国区最新的评论", "input": { "apps": [ "835599320" ], "countries": [ "us" ], "max_reviews": 50 }, "use_as_test": true }, { "id": "wechat-multi-country", "goal": "对比微信在中国大陆和日本的最有用评论", "input": { "apps": [ "https://apps.apple.com/cn/app/wechat/id414478124" ], "countries": [ "cn", "jp" ], "sort": "most_helpful" }, "use_as_test": false } ], "published_at": "2026-11-04T00:10:52.877919+00:00", "publisher": { "id": "data_hunter", "name": "data_hunter" }, "maintainers": [ { "id": "data_hunter", "name": "data_hunter" } ], "trust_tier": "community", "readme": "给出一个或多个 iOS App 和想看的国家/地区，就能拿到这些 App 在当地 App Store 的用户评论：每条包括星级、标题、正文、评论者、发布时间、评论时用的 App 版本，以及其他用户给它投的有用票。\n\n同一个 App 在不同国家/地区的评论完全不同，一次就能把多个市场的用户声音放在一起看。出海团队可以用它了解目标市场用户在抱怨什么、夸什么，产品和运营团队可以追踪新版本上线后评价的变化，也能拿竞品的差评找需求和机会。\n\n## 数据说明\n\n评论来自 App Store 各国家/地区公开展示的用户评论，正文保持用户原文的语言，不做翻译。\n\n每个 App 在每个国家/地区、每种排序方式下，只能取到最近公开的一批评论（约 500 条）；更早的历史评论取不到。想看更多，可以换另一种排序方式，或者加选其他国家/地区。\n\n「发布时间」是评论发布或最后修改的时间，带时区。「评论时版本」是用户写评论时安装的版本，不一定是当前最新版本。「有用票数」和「总投票数」是其他用户的反馈，新评论通常都是 0。\n\n## 结果长什么样\n\n每条结果是一条用户评论。\n\n| App 名称 | 国家/地区 | 评分 | 评论标题 | 评论内容 | 评论时版本 |\n|---|---|---|---|---|---|\n| TikTok - Videos, Shop & LIVE | us | 5 | doomscroll | TikTok is the best app in my entire life, I recommend this | 47.5.0 |\n| TikTok - Videos, Shop & LIVE | us | 1 | fix ur app | my fav comments js went down from 1050 to 992 lock in | 47.5.0 |\n\n## 应用场景\n\n- 版本口碑追踪：按「评论时版本」分组统计「评分」的平均值和差评占比，判断新版本是否带来体验问题。\n- 竞品差评挖掘：筛出竞品「评分」为 1–2 星的评论，对「评论标题」和「评论内容」做关键词归类，找到用户最常抱怨的功能点。\n- 多市场对比：同一个 App 选多个国家/地区，按「国家/地区」比较评分分布，找出口碑偏弱的市场。\n- 高价值反馈筛选：按「有用票数」从高到低排序，优先阅读被最多用户认可的评论。\n", "favorite_count": 0, "labels": { "industry": [ { "slug": "general", "label": "通用" } ], "platform": [], "content": [ { "slug": "review", "label": "评论评价" } ] }, "display_locale": "zh-CN", "translation_origin": null, "version": "0.1.1" }