# Xiaohongshu PGY blogger note cases

Paginated note list of a blogger ("Note Data → Note Cases" on the PGY blogger page). Needs user id. Served by TikHub.

Purpose:
- Paginated note list of a blogger ("Note Data → Note Cases" on the PGY blogger page)
- To inspect sponsored posts only, set note_type=3
Request Body Parameters:
- user_id: **required**, blogger user ID
- page_number: page number from 1 (note: this endpoint uses page_number, not page_num)
- page_size: **1-8** (fixed at 8 on the PGY web page, cannot be larger)
- note_type: 4=all (default), 3=sponsored, 1=image-text, 2=video
  **Warning**: the same parameter means something else in /get_blogger_notes_rate
  and /get_blogger_core_data (1=image-text, 2=video, 3=both). Copying note_type=3
  across silently switches "sponsored" to "image-text+video" with no error
- order_type: 1=newest (default), 2=most read, 3=most engaged
- advertise_switch: 1=all traffic incl. sponsored (default), 0=organic only
- feature_tag: filter by feature tag, e.g. "韩系" (see featureTags in blogger detail)
- content_tag: filter by content category, e.g. "美妆" (see contentTags in blogger detail)
- is_third_platform: 1=cross-platform sponsored notes only, 0=no limit (default)
Return:
- list[]: notes with noteId / title / imgUrl (cover) / date (publish date) / isVideo
- Metrics: readNum / likeNum / collectNum / thirdReadUserNum (off-site readers)
- Sponsorship: isAdvertise / brandName
- total: match count (varies with filters — use it to compute page count)
- Feed noteId into /get_note_detail for full body, media and engagement data
- **Note**: cover key here is `imgUrl`; `/get_blogger_notes_v2` uses `imageUrl`
Paging:
- Change page_number only, keep other params identical; an empty array means no mo

- Tool ID: `tikhub/xiaohongshu-pgy-get-blogger-notes`
- Variant: API v1
- Name in the catalog: Xiaohongshu, Get PGY blogger note cases
- Provider: [TikHub](/providers/tikhub.md)
- Capability: [Xiaohongshu posts](/tools/xiaohongshu/posts.md)
- Price: $0.02 per call
- Authentication: an authorised Agentik workspace is required for execution, including zero-price tools.

## Pricing contract

The provider’s price, with no markup. Billed for measured usage.


```json
{
  "model": "per_call",
  "amountUsd": 0.02
}
```

Pricing source: [https://api.tikhub.io/api/v1/tikhub/user/get_all_endpoints_info](https://api.tikhub.io/api/v1/tikhub/user/get_all_endpoints_info). Official per-success route price USD 0.02; daily upstream discounts may reduce provider cost. No discount invented for the customer. 10/second.

Price verification date: 2026-10-05.

## Complete input schema


```json
{
  "type": "object",
  "properties": {
    "user_id": {
      "type": "string",
      "title": "User Id",
      "description": "博主用户ID/Blogger user ID"
    },
    "page_number": {
      "type": "integer",
      "maximum": 1000,
      "minimum": 1,
      "title": "Page Number",
      "description": "页码，从 1 开始/Page number, from 1",
      "default": 1
    },
    "page_size": {
      "type": "integer",
      "maximum": 8,
      "minimum": 1,
      "title": "Page Size",
      "description": "每页数量，1-8（蒲公英网页固定 8）/Page size, 1-8 (fixed at 8 on PGY web)",
      "default": 8
    },
    "note_type": {
      "type": "integer",
      "enum": [
        1,
        2,
        3,
        4
      ],
      "title": "Note Type",
      "description": "笔记类型 4=全部类型(默认) 3=合作笔记 1=图文 2=视频/Note type",
      "default": 4
    },
    "order_type": {
      "type": "integer",
      "enum": [
        1,
        2,
        3
      ],
      "title": "Order Type",
      "description": "排序 1=最新发布(默认) 2=阅读最多 3=互动最多/Sort",
      "default": 1
    },
    "advertise_switch": {
      "type": "integer",
      "enum": [
        0,
        1
      ],
      "title": "Advertise Switch",
      "description": "流量类型 1=全部(含商业合作) 0=仅自然流量/Traffic type",
      "default": 1
    },
    "feature_tag": {
      "type": "string",
      "maxLength": 64,
      "title": "Feature Tag",
      "description": "按内容特征筛选，如 韩系；取值见博主详情的 featureTags/Filter by feature tag",
      "default": ""
    },
    "content_tag": {
      "type": "string",
      "maxLength": 64,
      "title": "Content Tag",
      "description": "按内容类目筛选，如 美妆；取值见博主详情的 contentTags/Filter by content tag",
      "default": ""
    },
    "is_third_platform": {
      "type": "integer",
      "enum": [
        0,
        1
      ],
      "title": "Is Third Platform",
      "description": "1=只看跨域合作笔记 0=不限(默认)/Cross-platform notes only",
      "default": 0
    }
  },
  "required": [
    "user_id"
  ],
  "additionalProperties": false
}
```

## Published example

No example input is published for this tool. Ask for the inputs required by its schema.

## Execute and retrieve

Inspect again before execution, explain the price and obtain the required authority. Use MCP run_tool or POST /v1/run with this tool ID, valid input and an idempotency key. Save the returned run ID and follow the actual state. If Agentik answers that the tool is temporarily unavailable, do not retry it blindly; use discovery to propose an alternative.

A partial or uncertain result can still have consumed provider resources. Consult [billing](/docs/billing.md), [idempotency](/docs/idempotency.md) and [asynchronous results](/docs/async.md).

[Provider documentation](https://api.tikhub.io/#/Xiaohongshu-PGY-API/get_blogger_notes_api_v1_xiaohongshu_pgy_get_blogger_notes_post)

[REST inspection](https://api.agentik.cc/v1/tools/tikhub/xiaohongshu-pgy-get-blogger-notes) · [OpenAPI](/openapi.json) · [Connection guide](/connect.md)

---

[HTML page](/providers/tikhub/xiaohongshu-pgy-get-blogger-notes) · [Agent index](/llms.txt)