日本化妆品排行榜 @cosme Top 50 评分与价格

它做什么： 选一个 @cosme（日本最大美妆点评网站）的分类排行，一次拿到整个 Top 50 的评分、点评数与价格汇总。

你输入： 一个排行分类，如 item/1069（卸妆液），或直接粘贴排行页网址。

你得到： 上榜 50 款的全部：评分典型值与区间（0–7 分制）；含税标价（取最便宜规格）的典型值与区间；点评数中位数与最大值；品牌数；上升 / 下降 / 新上榜的产品数；排行更新日与统计期间。可选：每个产品一行。绝不采集点评正文。

价格： 每个分类 $0.02（输入的每个分类都会计费）；如需逐条明细，另加每条产品 $0.002（默认关闭）。无结果不收费。

示例： 输入 item/1069 → 50 个产品 · 评分典型值 5.1（区间 3.7–6.9）· 含税标价典型值 ¥1,760（区间 ¥352–7,260，取自标有价格的 42 款）· 42 个品牌 · 上升 8、下降 19、新上榜 2。

In English: Pick a category on @cosme, Japan's biggest beauty review site, and get its whole top-50 ranking as one summary. You get typical rating and range, typical list price and range, review-count median and max, number of brands, rank movement counts and the ranking date with the period it covers.

非官方工具 / Unofficial — 与 @cosme 无关联，仅读取公开网页。Not affiliated with @cosme; reads public pages only.

中文说明

这是给谁用的（Who this is for）

日本化妆品是日本对中国最大的消费品类之一——从美妆代购、跨境电商选品到国内品牌做竞品对标，链路上每个人都在问同一个问题：现在日本人到底在买什么、买在什么价位、口碑落在哪一档。而这个问题在中文圈里有一个默认答案：看 @cosme（アットコスメ）的排行。它是日本占绝对主导地位的美妆点评平台，它的分类排行榜就是中文买家引用的那把尺子，但它没有公开 API。

这个 Actor 把一张排行榜变成一条可以直接进选品表的行情记录：

• rating —— 评分的最低值、中间 50% 区间、中位数与最高值（@cosme 的 0–7 分制），看清一个品类是清一色 5.1 分的混战，还是头部真的拉开了质量差距。
• priceJpy —— 同样的价格区间，按每款产品最便宜的那个规格算，并附美元换算。这个品类现在赢在哪个价位段？
• reviewCount —— 点评数的中位数与最大值。一款 2002 年的常青款 8,727 条点评，和一款 2026 年新品 17 条点评，排名只差三位——这个差别只有点评数能说出来。
• brandTop / brandCount / topBrandShare —— 品牌集中度：这个品类是被一家吃掉，还是 42 个品牌在混战。
• rankMovement —— 上榜产品里有多少在上升、持平、下滑或是新入榜。构成比告诉你这个品类是在换血还是已经固化。
• bestCosmeCount（ベストコスメ 获奖数）、variantsPerProductMedian，以及排行榜自身的 rankingUpdatedOn（更新日）与 aggregationPeriod（统计区间）。
• 可选：每一款上榜产品（名次、名次升降、品牌、评分、点评数、全部规格与价格、发售日、最佳美妆标记、产品链接）。

无需登录、无需 API key、运行之间不存储任何数据。

本 Actor 是英文版 @cosme Japan Beauty Ranking — Top 50 Ratings & Prices 的中文语言包：读取的页面与算出的数字完全相同，只有标题、商店说明、文档和输入项标签改写成中文。

⚠️ 本 Actor 刻意不采集的东西

@cosme 是点评站，所以这一点必须说明白：

点评正文、点评者昵称、点评者主页与点评图片——绝不采集，这是设计决定，且永久有效。

不采集	为什么
点评正文（用户写的文字）	那是用户创作的个人内容。做统计不需要它
点评者昵称、年龄、肤质、个人主页	那是与本产品无关的个人的个人数据
点评图片	同上——用户上传的个人内容
点评永久链接与产品页的 /review/ 标签页链接	给出链接就等于给出指针。任何一条记录里都不会出现 .../review/ 链接——url 永远是产品页

真正被采集的是点评的「条数」——一个数字，以及聚合后的评分值。这就是本 Actor 在点评侧的全部足迹。

这不是一句文案上的承诺，而是写进代码里的：src/main.py 带有 DELIBERATE EXCLUSION 段落和一个可执行的守卫函数 review_text_leaks(record)，它会扫描每条输出记录的所有值，找出点评标记（review-body、review-text、reviewer-desc、/reviewer/、/review/、/reviews/）。测试套件断言它对每一种输出记录形状都返回 []。 将来若有人改动导致整块产品 HTML 被剥标签复制、或把点评标签页链接带了进来，标记会一起进来，构建随即失败。

概览 Overview

每个分类返回一条 category_summary 汇总记录：评分的中位数与中间 50% 区间、价格的中位数与中间 50% 区间、点评数中位数与最大值、品牌集中度、名次升降构成、最佳美妆获奖数、排行更新日与统计区间、汇率。开启单品输出后，另外为每一款上榜产品返回一条记录。

输入 Input

字段	示例	说明
categories	["item/1069"]	<axis>/<id>，axis ∈ item / effect / skin / age / pickup——两半都要从地址里抄，id 在每个 axis 下各自编号。粘贴完整排行链接也会被自动规范化。常用排行的 id 见下表。读不了的分类会被跳过并写明原因，列表里其余分类照常运行。每个分类 $0.02
pagesPerCategory	5	每页 10 款；排行只到第 50 名，所以 5 就是全部，也是上限。只看 Top 10 就调低
includeIndividualItems	false	开启后输出每一款上榜产品的记录（默认关闭，+$0.002/款）
convertToUsd	true	按当前汇率附上美元统计

{
    "categories": ["item/1069"],
    "pagesPerCategory": 5,
    "includeIndividualItems": false,
    "convertToUsd": true
}

怎么找分类 id

在浏览器里打开任意一张 @cosme 排行榜，复制地址：https://www.cosme.net/categories/item/1069/ranking/ → item/1069。item 轴是品类排行（卸妆、精华、口红…）；effect、skin、age、pickup 是 @cosme 的其他排行轴，用法完全一样。

axis 和 id 要一起从地址里抄。 id 在每个 axis 下是各自编号的，所以 effect/1069 不是「同一个榜按效果排」，而是另一张真实存在的排行（实测 2026-08-18：香水类），它会作为一条正常记录返回并计费。如果 categoryName 和你预期的不一样，先检查 axis。

站点只有日文，所以这里给出最常用排行的 id（2026-08-18 从 @cosme 自己的分类链接读到）：

排行	代码	排行	代码
洁面（洗顔料）	item/900	粉底液（ファンデーション）	item/916
卸妆（クレンジング）	item/901	妆前乳（化粧下地）	item/917
化妆水（化粧水）	item/902	蜜粉（フェイスパウダー）	item/918
乳液（乳液）	item/1004	气垫粉底（クッションファンデ）	item/1200
精华（美容液）	item/1006	BB 霜（BBクリーム）	item/1201
面霜（フェイスクリーム）	item/1005	CC 霜（CCクリーム）	item/1202
面膜（シートマスク・パック）	item/1007	口红（口紅）	item/1015
眼唇护理（目元・口元ケア）	item/905	唇釉（リキッドルージュ）	item/1221
卸妆油（オイルクレンジング）	item/1002	睫毛膏（マスカラ）	item/911
卸妆膏（クレンジングバーム）	item/1192	眼线（アイライナー）	item/910
卸妆水（リキッドクレンジング）	item/1069	眼影（アイシャドウ）	item/912
防晒（日焼け対策）	item/801	腮红（チーク）	item/914
洗发护发（シャンプー）	item/920	香水（香水・フレグランス）	item/804
护手霜（ハンドクリーム）	item/1035	指甲油（マニキュア）	item/1023

想要更宽的大类：护肤 item/800、彩妆 item/802、底妆 item/803、洗护发 item/805、身体与口腔护理 item/806、美容仪 item/808、保健食品 item/809。

effect 轴：美白 effect/1005、毛孔 effect/1003、痘痘 effect/1004、保湿 effect/1002、抗老 effect/1008、角质护理 effect/1062、有机自然派 effect/1087。

2026-08-18 实测：item/900、item/916、item/804、effect/1005 都返回了完整一页的排行商品。

只读取主排行。如果你粘贴的是 ranking-rise（急上昇）、ranking-age（年代）、ranking-skin（肌質）或 ranking-search（お好み）链接，运行会明确报错，而不是悄悄按主排行给你计费——那是统计区间与结果集都不同的另一张榜。

输出 Output

字段名保持英文，这是 API 接口。

实测于 2026-08-01（@cosme 真实页面，分类 item/1069 リキッドクレンジング / 卸妆液）

{
  "type": "category_summary",
  "category": "item/1069",
  "categoryName": "リキッドクレンジング",
  "rankingUpdatedOn": "2026-07-31",
  "aggregationPeriod": { "from": "2026-04-30", "to": "2026-07-29", "raw": "2026/4/30〜2026/7/29" },
  "productsRanked": 50,
  "totalListingsFound": 50,
  "pagesFetched": 5,
  "ratingScale": 7,
  "rating":   { "min": 3.7, "q1": 4.9,  "median": 5.1,  "q3": 5.4,  "max": 6.9,  "count": 50 },
  "priceJpy": { "min": 352, "q1": 1463, "median": 1760, "q3": 3242, "max": 7260, "count": 42 },
  "reviewCount": { "median": 186, "max": 8727, "count": 50 },
  "brandTop": [["ビオデルマ", 4], ["Chacott COSMETICS(チャコット・コスメティクス)", 2], ["ビフェスタ", 2]],
  "brandCount": 42,
  "topBrandShare": 0.08,
  "rankMovement": { "up": 8, "stay": 21, "down": 19, "new": 2, "unknown": 0 },
  "bestCosmeCount": 2,
  "variantsPerProductMedian": 1,
  "checkedAt": "2026-08-01T05:41:12.884Z",
  "sourceUrl": "https://www.cosme.net/categories/item/1069/ranking/",
  "priceUsd": { "min": 2.3, "q1": 9.55, "median": 11.49, "q3": 21.17, "max": 47.41 },
  "exchangeRateJpyUsd": 0.00653
}

q1 与 q3 是中间 50% 的两端：50 款里有一半评分在 4.9–5.4 之间，标价的 42 款里有一半落在 ¥1,463–¥3,242。

可选的单品记录（type: "product"，同一次 2026-08-01 实测）——注意 url 是产品页，而且每一组规格/价格都被保留：

{
  "type": "product",
  "category": "item/1069",
  "categoryName": "リキッドクレンジング",
  "rank": 1,
  "rankMovement": "stay",
  "rankMovementJa": "順位変わらず",
  "productId": "2892367",
  "name": "サンシビオ エイチツーオー D",
  "brand": "ビオデルマ",
  "brandId": "4680",
  "ratingScale": 7,
  "rating": 5.4,
  "reviewCount": 8727,
  "minPriceJpy": 1463,
  "priceVariants": [
    { "size": "100ml", "priceJpy": 1463 },
    { "size": "250ml", "priceJpy": 3069 },
    { "size": "500ml", "priceJpy": 3810 },
    { "size": "850ml", "priceJpy": 5060 }
  ],
  "priceVariantCount": 6,
  "priceLabelJa": "税込価格",
  "releaseDate": "2002-07-05",
  "releaseDateRaw": "2002/7/5",
  "bestCosme": true,
  "url": "https://www.cosme.net/products/2892367/"
}

每项统计的口径（basis）

• 评分是 0–7 分制，不是 0–5 分制。 @cosme 用七分制，所以 5.4 分是一款很强的产品，而不是一个不可能的数字。每条记录都带 ratingScale: 7，就是为了防止你不小心拿它去和别的站的五星评分直接比。（换算成五分制：rating / 7 * 5。）
• 统计区间是答案的一部分。 @cosme 用大约 3 个月的滚动窗口重算每张榜，并把两个日期写在页头；它们以 rankingUpdatedOn 和 aggregationPeriod 出现在每条记录上。两张榜只有窗口可比时才可比——没有窗口的快照是无法解释的，所以这两项绝不省略。
• 排行只有 50 名深，而且 50 款全部读取——这不是抽样。 productsRanked 正常情况下恰好是 50（每页 10 × 5 页），所以中位数与中间 50% 区间描述的是上榜集合本身，而不是对它的估计。没有第 6 页。
• 一款产品，多个价格。 日本化妆品常常在同一行里列出多个规格（「税込価格：100ml・1,463円 / 250ml・3,069円 / 500ml・3,810円」）。全部规格都会被解析；minPriceJpy——最便宜的那个规格——是进入 priceJpy 的代表价，因为一款同时卖 850ml 大瓶的产品并不比只卖 100ml 的「更贵」。priceVariantCount 告诉你一共有几个规格。
• 不是每款都有价格。 开放价格（「オープン価格」）与仅有替换装的产品会带一个没有日元金额的规格；它们保持 priceJpy: null 并被排除在 priceJpy 之外——这就是为什么上例中 priceJpy.count（42）小于 productsRanked（50）。缺口不会被任何编造的数字填上。
• 价格是 @cosme 公布的含税建议零售价（priceLabelJa 记录站方自己的标签），不是店铺售价，更不是成交价。
• 名次升降取自 @cosme 自己的图标：up（含「10位以上順位アップ」）、stay、down、new（ランキング初登場）。不认识的图标报为 unknown，绝不并进 stay。
• 品牌名只从品牌链接读取。 有付费合作的品牌会多出一个链接，其文字是广告告知；该链接被排除，所以一个品牌在 brandTop 里始终是一个条目。
• 编码：@cosme 输出 Shift_JIS，代码显式解码。日文品牌名、产品名与分类名完整无损。

本 Actor 不做什么

• 永远不采集点评正文。 见上文——这是产品的硬约束，不是一项功能缺失。
• 默认不逐条输出产品明细。 汇总本身就是产出，单品输出是可选项且单独计费。
• 不访问需要登录的数据，也不请求任何 /api/ 路径。 全部来自公开排行页；@cosme 在 robots.txt 里禁止的路径一次也没有被请求过。
• 运行之间不保存任何数据。 每次运行都实时读取页面。
• 不开浏览器。 纯 HTTP，256 MB，一次运行稳稳在 120 秒以内。

价格 Pricing —— 每个分类 $0.02

计费事件	价格	何时发生
分类汇总	$0.02	每个有产品返回的分类一次，列表里的每个分类都会计费
单品记录	$0.002	仅当开启「输出单品记录」时（默认关闭）

默认运行（1 个分类、完整 Top 50、只要汇总）花费 $0.02。开启单品输出后是 $0.02 + 50 × $0.002 = $0.12。按分类计费，没有月费。零结果的分类绝不收费。

注意事项 Notes & limits

• 请求限速 1.5 秒，并有 95 秒的软性总时长预算，保证多分类运行不超时。每个分类的第 1 页一定会跑，所以每个分类都会产出汇总；如果预算截断了后续页，受影响的汇总会带 truncatedForTimeLimit: true 和更小的 pagesFetched——Top 10 绝不会被当成完整 Top 50 端出来。若所有分类都失败，运行会明确失败，而不是返回一个空的「成功」。
• 与株式会社アイスタイル / @cosme 无任何关联。数据用于市场调研，重要决策前请自行核实。
• 页面结构变化时明确报错，而不是返回看似正常的空结果。

用途 Use cases

• 跨境选品 —— 排行代表的是在日本真正卖得动的东西，本 Actor 给出它卖在什么价位、口碑在哪一档。
• 品牌对标 —— 自家产品的名次、评分与价格，放进整个品类的价格区间与评分区间里看，而不是只看一个绝对值。
• 趋势监控 —— 按周跑同一个分类，用 rankMovement 与统计区间看这个品类是在换血还是已经固化。

---

English

Overview

Rating, review-count and price figures for any @cosme (cosme.net) ranking category. One row per category covers the whole top 50: the typical rating and the middle 50% range on @cosme's 0–7 scale, the same for price (each product's cheapest listed size), review-count median and maximum, brand concentration, rank-movement mix, best-cosme count, and the ranking's own update date and the period it covers. Optionally every ranked product as its own row.

This listing is the Chinese-language package of our English Actor @cosme Japan Beauty Ranking — Top 50 Ratings & Prices. It reads the same pages and works out the same numbers; only the documentation, store copy and input labels are written for Chinese-speaking beauty buyers, cross-border resellers and brand teams (日本化妆品 / 日妆排行 / 日本美妆代购).

Review text, reviewer names, reviewer profiles and review photos are never collected, and no record ever contains a .../review/ URL — see the Chinese section above for the full statement and the executable guard that enforces it.

Input

Field	Example	Notes
categories	["item/1069"]	<axis>/<id>, axis ∈ item / effect / skin / age / pickup — copy both halves from the URL, the ids are numbered per axis. Common ids: face wash item/900, cleanser item/901, toner item/902, serum item/1006, foundation item/916, lipstick item/1015, sunscreen item/801, perfume item/804. $0.02 each
pagesPerCategory	5	10 products per page; the ranking is only 50 deep, so 5 is the whole thing and the maximum
includeIndividualItems	false	Turn on to also get each ranked product as its own row (+$0.002 each)
convertToUsd	true	Adds USD prices at the current exchange rate

Output

One type: "category_summary" row per category (rating, priceJpy, reviewCount, brandTop, brandCount, topBrandShare, rankMovement, bestCosmeCount, rankingUpdatedOn, aggregationPeriod, USD conversion) — see the JSON example in the Chinese section — plus optionally one product row per ranked product, whose url is always the product page.

Pricing

What you pay for	Price
Category summary	$0.02
Individual product row	$0.002 each

Individual products are OFF by default, so a default run is a flat $0.02 per category. You pay per category; there is no monthly fee. A category that returns nothing is never charged.

Notes & limits

• The rating scale is 0–7, not 0–5. Every record carries ratingScale: 7. To rescale: rating / 7 * 5.
• The ranking is 50 deep and all 50 are read, so the median and the middle 50% range describe the whole ranked set, not an estimate of it.
• Open-price products carry priceJpy: null and are excluded from priceJpy, which is why priceJpy.count can be lower than productsRanked.
• minPriceJpy (the cheapest listed size) is the representative price; every size/price pair is kept on the product record.
• Prices are @cosme's published tax-included list prices, not shop prices and not sold prices.
• Read-only and throttled (1.5 s), Shift_JIS decoded explicitly, no login, no /api/ paths, nothing stored between runs. Not affiliated with istyle Inc. / @cosme.

---

日本語

概要 Overview

@cosme（アットコスメ）のカテゴリランキングを1コールで統計化します。カテゴリごとに category_summary を1件返し、トップ50全体の評価（0〜7点）の中央値と中間50%の幅、価格の中央値と中間50%の幅（各製品の最安サイズ基準）、クチコミ件数の中央値と最大値、ブランド集中度、順位変動の内訳、ベストコスメ数、そしてランキング自身の更新日と集計期間を含みます。中国語圏の利用者（日本化妆品 / 日妆排行 / 日本美妆代购）向けに中国語で書き直したパッケージで、英語版は @cosme Japan Beauty Ranking — Top 50 Ratings & Prices（取得・集計処理は同一）。

クチコミ本文・投稿者名・投稿者ページ・クチコミ写真は一切取得しません（レコードに .../review/ のURLが入ることもありません）。取得するのはクチコミの件数という数値のみです。

入力 Input

categories（<axis>/<id> 形式、ランキングURL貼付も可）／pagesPerCategory（既定 5＝トップ50全体、最大5）／includeIndividualItems（既定 OFF）／convertToUsd（既定 ON）。

出力 Output

カテゴリごとに category_summary を1件（rating / priceJpy / reviewCount / brandTop / brandCount / topBrandShare / rankMovement / bestCosmeCount / rankingUpdatedOn / aggregationPeriod / USD換算）。includeIndividualItems が ON のときは、ランクインした各製品の明細（順位・変動・ブランド・評価・クチコミ件数・全サイズ/価格・発売日・ベストコスメ・製品URL）も出力します。

料金 Pricing

カテゴリサマリー（category-analyzed）$0.02／個別製品レコード（product-scraped）$0.002 / 件。個別明細は既定 OFF なので既定実行はカテゴリあたり $0.02 固定です。0件のカテゴリには課金されません。 使った分だけの従量課金です。

注意 Notes

評価は7点満点（ratingScale: 7）です。ランキングは50位までで、その50件すべてを読むので、中央値も中間50%の幅も推定ではありません。オープン価格の製品は priceJpy: null として価格統計から除外されるため priceJpy.count が productsRanked より小さくなることがあります。価格は @cosme 掲載の税込価格（priceLabelJa）であり、店頭価格でも実売価格でもありません。集計期間が異なるランキング同士は比較できないため、rankingUpdatedOn と aggregationPeriod は常に付与します。リクエストは1.5秒間隔、Shift_JIS を明示デコード、ログイン不要・/api/ 不使用・実行間の保存なし。株式会社アイスタイル／@cosme とは無関係です。

出问题了怎么办

• 数字不对，或者运行失败了？ 请在 Issues 标签页提交。每一条我都会看，2 个工作日内回复（日本时间）。
• 绝不会返回假的「空结果」。 网站读不到的时候，运行会失败并说明原因。
• 没有结果就不计费。 你只为真正拿到的结果付费。
• 每周自检。 自动测试每周运行一次；网站有变化我会修。
• 只读公开页面。 不登录、不涉及个人信息，访问也很克制。

同一作者的其他工具

• 日本二手书店 BookOff 二手书·漫画·CD·游戏价格 — 二手价与库存
• 日本二手乐器 Digimart 吉他·乐器价格 — 二手价与成色
• 藤屋相机 Fujiya Camera 日本二手相机·镜头价格 — 按成色分级
• 日本高达模型·手办 HobbyLink Japan 价格 — 现货还是预订
• 日本二手手机店 Iosys 二手 iPhone·手机价格 — 按成色分级
• 万代书店 Mandarake 日本二手手办·漫画价格 — 在售价与售罄价
• 游游亭 Yuyu-tei 日本卡牌单卡价格 — 售价与回收价
• BookOff Japan Used Manga, Books, CDs — Price & Stock

本工具的其他语言版本：English · 한국어

全部工具（日本二手交易平台、房产、招聘、赛事、预测市场）：https://apify.com/jpmarketdata

免责声明

非官方的独立工具 — 与 @cosme 没有从属、认可或赞助关系。商品名称与标识归各自所有者所有，在这里只用于说明数据来自哪里。数据读取自公开页面，供市场调研使用；据此行动前请自行核实。