[中文]

用途:

• 给定一个博主，返回平台判定与其相似的其它博主，对应博主主页下方「相似博主推荐」
• 典型用法：先选出一个满意的标杆博主，再用本接口按相似度扩量选号

请求体参数:

• user_id: 必填，目标博主用户ID
• page_num: 页码，从 1 开始
• page_size: 每页数量，1-4（蒲公英网页固定 4，不能更大）

返回:

• 结构与「笔记博主广场」完全一致 —— 同样的 kols[] + total，可直接复用解析代码
• 相似博主总数通常只有个位数到几十，total 即为上限

翻页:

• 只改 page_num，user_id 保持不变；翻到返回空数组即没有更多

响应结构（取数要剥两层）:

• resp["data"] 是蒲公英原样信封（含 code/msg/success），业务数据还在它里面一层
• 正确取法：data = resp["data"]["data"]；下面「返回」列的字段都在这一层下

计费:

• HTTP 200 → 计费。包含「查无结果」（data 为 null，如 ID 不存在或筛选无命中）—— 请求已送达蒲公英，同样扣费，不要因为拿不到数据就重试
• HTTP 400 → 不计费（参数格式非法，或上游资源不足/异常）

[English]

Purpose:

• Given one blogger, return similar bloggers ("Similar Bloggers" on the blogger page)
• Typical use: pick one good benchmark blogger, then expand by similarity

Request Body Parameters:

• user_id: required, target blogger user ID
• page_num: page number from 1
• page_size: 1-4 (fixed at 4 on the PGY web page)

Return:

• Same shape as the note blogger square (kols[] + total), parsing code is reusable
• Similar bloggers usually number from a few to a few dozen; total is the cap

Paging:

• Change page_num only; an empty array means no more data

Response shape (two layers):

• resp["data"] is PGY's raw envelope (with code/msg/success); the payload is one level deeper
• Correct access: data = resp["data"]["data"] — every field listed under "Return" lives here

Billing:

• HTTP 200 → charged, including "no result" (data is null, e.g. ID not found or filters matched nothing): the request did reach PGY, so retrying on empty data just burns quota
• HTTP 400 → not charged (malformed params, or upstream unavailable/error)

[示例/Example]

// ① 第一页（每页最多 4 个，这是蒲公英网页的固定值）
{"user_id": "5c668b3e0000000012021605", "page_num": 1, "page_size": 4}

// ② 翻页：只改 page_num
{"user_id": "5c668b3e0000000012021605", "page_num": 2, "page_size": 4}

想「找相似 + 再按粉丝量/报价筛一遍」，用 /get_blogger_list 的 similar_user_id 参数 —— 那条链路支持叠加全部筛选；本接口只按相似度返回、不支持筛选。

To combine similarity with other filters, use similar_user_id on /get_blogger_list instead.

{
  "user_id": "5c668b3e0000000012021605",
  "page_num": 1,
  "page_size": 4
}