[中文]

用途:

给定一个博主，返回平台判定与其相似的其它博主，对应博主主页下方「相似博主推荐」

典型用法：先选出一个满意的标杆博主，再用本接口按相似度扩量选号

请求体参数:

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]

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

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Body Params application/jsonRequired

Example

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

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

获取蒲公英相似博主推荐/Get PGY similar bloggers

[中文]

用途:

请求体参数:

返回:

翻页:

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

计费:

[English]

Purpose:

Request Body Parameters:

Return:

Paging:

Response shape (two layers):

Billing:

[示例/Example]

Request

Request Code Samples

Responses

获取蒲公英相似博主推荐/Get PGY similar bloggers

[中文]#

用途:#

请求体参数:#

返回:#

翻页:#

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

计费:#

[English]#

Purpose:#

Request Body Parameters:#

Return:#

Paging:#

Response shape (two layers):#

Billing:#

[示例/Example]#

Request

Request Code Samples

Responses

[中文]

用途:

请求体参数:

返回:

翻页:

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

计费:

[English]

Purpose:

Request Body Parameters:

Return:

Paging:

Response shape (two layers):

Billing:

[示例/Example]