> ## Documentation Index > Fetch the complete documentation index at: https://aisa.one/docs/llms.txt > Use this file to discover all available pages before exploring further. # Get PGY similar bloggers > Get PGY similar bloggers Get PGY similar bloggers **Pricing** — base \$0.029 per successful call (provider cost × 1.45; final charge scales by your plan multiplier). Charged only when the upstream response body `code` is `200`. Response structure is not yet fully documented — **refer to the actual API response**. ## Example ```bash theme={null} curl -X POST "https://api.aisa.one/apis/v1/tikhub/xiaohongshu/pgy/get_blogger_similar" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{}' # see request schema below ``` ## OpenAPI ````yaml openapi/tikhub.json POST /tikhub/xiaohongshu/pgy/get_blogger_similar openapi: 3.0.0 info: title: TikHub API description: >- Multi-platform social media data — Douyin, TikTok, Bilibili, Kuaishou, Weibo, Xiaohongshu, Zhihu, and commercial (Xingtu/Huahuo/Billboard) endpoints. version: 1.0.0 servers: - url: https://api.aisa.one/apis/v1 security: - bearerAuth: [] paths: /tikhub/xiaohongshu/pgy/get_blogger_similar: post: tags: - TikHub - Xiaohongshu summary: Get PGY similar bloggers description: >- Xiaohongshu (pgy). Pricing and billing notes describe the upstream provider. Use the AIsa price quote for gateway calls. ### 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) operationId: post_tikhub_xiaohongshu_pgy_get_blogger_similar requestBody: content: application/json: schema: $ref: '#/components/schemas/SimilarReq' required: true responses: '200': description: >- Successful response. The outer object follows `ResponseModel`; the endpoint-specific payload is in `data`. ### 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 ### 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 content: application/json: schema: $ref: '#/components/schemas/ResponseModel' components: schemas: SimilarReq: properties: user_id: type: string title: User Id description: Target blogger user ID example: 5c668b3e0000000012021605 page_num: type: integer maximum: 100 minimum: 1 title: Page Num description: Page default: 1 example: 1 page_size: type: integer maximum: 4 minimum: 1 title: Page Size description: |- Page size, 1-4 (web fixed at 4) Usage: **1-4** (fixed at 4 on the PGY web page) default: 4 example: 4 additionalProperties: false type: object required: - user_id title: SimilarReq ResponseModel: properties: code: type: integer title: Code description: HTTP status code default: 200 request_id: title: Request Id description: Unique request identifier nullable: true type: string message: type: string title: Message description: Response message (EN-US) default: Request successful. This request will incur a charge. message_zh: type: string title: Message Zh description: Response message (ZH-CN) default: 请求成功，本次请求将被计费。 support: type: string title: Support description: Support message default: 'Discord: https://discord.gg/aMEAS8Xsvz' time: type: string title: Time description: The time the response was generated time_stamp: type: integer title: Time Stamp description: The timestamp the response was generated time_zone: type: string title: Time Zone description: The timezone of the response time default: America/Los_Angeles docs: title: Docs description: Link to the API Swagger documentation for this endpoint nullable: true type: string cache_message: title: Cache Message description: Cache message (EN-US) default: >- This response is cached and accessible via the URL below for 24 hours at no extra cost. The cache is for request tracing only — it doesn't affect the API's data freshness and won't be returned through the API again. nullable: true type: string cache_message_zh: title: Cache Message Zh description: Cache message (ZH-CN) default: >- 本次响应已缓存，可通过下方 URL 直接查看，有效期 24 小时，访问缓存链接无额外费用。缓存仅用于请求溯源，不影响接口数据的时效性，也不会再次通过接口返回。 nullable: true type: string cache_url: title: Cache Url description: The URL to access the cached result nullable: true type: string router: type: string title: Router description: The endpoint that generated this response default: '' params: title: Params description: The parameters used in the request default: {} data: title: Data description: >- Endpoint-specific response payload. The official shared model does not declare a fixed type or field set. Use the operation's documented return fields or response example; an operation-specific schema, when present, describes the documented fields. Undocumented fields must be read from the actual response rather than assumed. nullable: true type: object title: ResponseModel securitySchemes: bearerAuth: type: http scheme: bearer description: AIsa API key. Get yours at https://aisa.one ````