# Xiaohongshu PGY content square leaderboards

Replica of PGY "Learn Content → Inspiration → Content Square": no ID required, directly answers "what content is hot right now". Needs biz type. Served by TikHub.

Purpose:
- Replica of PGY "Learn Content → Inspiration → Content Square": **no ID required**,
  directly answers "what content is hot right now"
- Opposite direction from every other endpoint — this one is an entry point; take the
  blogger IDs from the returned notes and drill down with the blogger endpoints

1. Full Parameter List
| Param | Required | Default | Description |
|---|---|---|---|
| `biz_type` | ✅ | — | Leaderboard, see section 3 |
| `page_num` | | `1` | Page, 1-100 |
| `page_size` | | `34` | **1-34** (fixed at 34 on the web page) |
| `search_word` | | `""` | Keyword; empty = whole board. Comma-separated for batch search |
| `order_by` | | per board | Sort field, see section 5; empty = board default |
| `date_range` | | `7` | Window in days: `3` / `7` / `14` / `30` |
| `sub_biz_type` | | `3` | **Board 8 only**, see section 6 |
| `category` | | — | **Board 1 only**, see section 4 |
| `industry` | | — | **Boards 2/3/4/5/6/7/8**, see section 4 |
| `note_type` / `content_type` / `theme` | | — | See section 6 |
| `author_type` / `placement` / `marketing_target` | | — | See section 6 |
| `price` / `fans` | | — | **Board 4 only**, see section 6 |

Omitted filters mean "no limit". **Do not send unused fields as empty strings or 0** —
they would be treated as a real filter.

2. Paging
Change `page_num` only and keep every other parameter identical.

**Each board holds exactly 100 items** (`total` is always 100) — this is a leaderboard,
not a full search; upstream only exposes the Top 100. With `page_size=34` you reach the
end at page 3, and page 4 returns an empty arra

- Tool ID: `tikhub/xiaohongshu-pgy-get-content-square`
- Name in the catalog: Xiaohongshu, PGY content square leaderboards
- 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": {
    "biz_type": {
      "type": "integer",
      "enum": [
        1,
        2,
        3,
        4,
        5,
        6,
        7,
        8
      ],
      "title": "Biz Type",
      "description": "榜单 1=小红书热门 2=产品种草 3=电商推广 4=蒲公英合作 5=客资收集 6=电商热门 7=种草直达 8=应用推广/Leaderboard"
    },
    "page_num": {
      "type": "integer",
      "maximum": 100,
      "minimum": 1,
      "title": "Page Num",
      "description": "页码；每个榜固定只有 100 条/Page; each board has only 100 items",
      "default": 1
    },
    "page_size": {
      "type": "integer",
      "maximum": 34,
      "minimum": 1,
      "title": "Page Size",
      "description": "每页数量，1-34（网页固定 34）/Page size, 1-34",
      "default": 34
    },
    "search_word": {
      "type": "string",
      "maxLength": 100,
      "title": "Search Word",
      "description": "关键词，留空=看整榜；支持英文逗号分隔批量搜/Keyword, comma-separated for batch",
      "default": ""
    },
    "order_by": {
      "type": "string",
      "maxLength": 64,
      "title": "Order By",
      "description": "排序字段，留空=用该榜默认排序/Sort field, empty=board default",
      "default": ""
    },
    "date_range": {
      "type": "integer",
      "enum": [
        3,
        7,
        14,
        30
      ],
      "title": "Date Range",
      "description": "统计窗口：近 3/7/14/30 日/Date window in days",
      "default": 7
    },
    "sub_biz_type": {
      "anyOf": [
        {
          "type": "integer",
          "enum": [
            1,
            2,
            3
          ]
        },
        {
          "type": "null"
        }
      ],
      "title": "Sub Biz Type",
      "description": "【仅榜 8】1=应用下载 2=小程序推广 3=应用唤起(默认)/Board 8 only"
    },
    "category": {
      "anyOf": [
        {
          "type": "string",
          "maxLength": 64
        },
        {
          "type": "null"
        }
      ],
      "title": "Category",
      "description": "【仅榜 1】类目，格式「一级#二级」，如 \"内容类目#美妆\"/Board 1 only"
    },
    "industry": {
      "anyOf": [
        {
          "type": "string",
          "maxLength": 64
        },
        {
          "type": "null"
        }
      ],
      "title": "Industry",
      "description": "【榜 2/3/4/5/6/7/8】所属行业名，取值集因榜而异/Industry, values differ per board"
    },
    "note_type": {
      "anyOf": [
        {
          "type": "integer",
          "enum": [
            1,
            2
          ]
        },
        {
          "type": "null"
        }
      ],
      "title": "Note Type",
      "description": "内容类型 1=图文 2=视频/Content type"
    },
    "content_type": {
      "anyOf": [
        {
          "type": "integer",
          "enum": [
            1,
            2,
            3,
            5,
            6,
            11,
            -1
          ]
        },
        {
          "type": "null"
        }
      ],
      "title": "Content Type",
      "description": "内容来源 1=博主合作 2=明星合作 3=员工 5=买手 6=专业号 11=主理人 -1=用户/Content source"
    },
    "theme": {
      "anyOf": [
        {
          "type": "string",
          "maxLength": 64
        },
        {
          "type": "null"
        }
      ],
      "title": "Theme",
      "description": "【榜 2/4/5/7/8】题材名/Theme"
    },
    "author_type": {
      "anyOf": [
        {
          "type": "integer",
          "enum": [
            1,
            2
          ]
        },
        {
          "type": "null"
        }
      ],
      "title": "Author Type",
      "description": "【仅榜 4】1=蒲公英博主 2=明星/Board 4 only"
    },
    "placement": {
      "anyOf": [
        {
          "type": "integer",
          "enum": [
            1,
            2,
            3
          ]
        },
        {
          "type": "null"
        }
      ],
      "title": "Placement",
      "description": "【榜 2/3/5/7/8】流量场域 1=发现 2=搜索 3=视频内流/Traffic placement"
    },
    "marketing_target": {
      "anyOf": [
        {
          "type": "integer",
          "enum": [
            3,
            8
          ]
        },
        {
          "type": "null"
        }
      ],
      "title": "Marketing Target",
      "description": "【仅榜 3】3=商品推广 8=直播推广/Board 3 only"
    },
    "price": {
      "anyOf": [
        {
          "properties": {
            "kind": {
              "type": "integer",
              "enum": [
                1,
                2
              ],
              "title": "Kind",
              "description": "报价口径：1=图文笔记 2=视频笔记"
            },
            "range": {
              "properties": {
                "min": {
                  "anyOf": [
                    {
                      "type": "integer",
                      "maximum": 9999999,
                      "minimum": 0
                    },
                    {
                      "type": "null"
                    }
                  ],
                  "title": "Min",
                  "description": "最小值（含）"
                },
                "max": {
                  "anyOf": [
                    {
                      "type": "integer",
                      "maximum": 9999999,
                      "minimum": 0
                    },
                    {
                      "type": "null"
                    }
                  ],
                  "title": "Max",
                  "description": "最大值（含）；省略=不限"
                }
              },
              "additionalProperties": false,
              "type": "object",
              "title": "RangeFilter",
              "description": "数值区间。两端可省略其一，至少给一个。"
            }
          },
          "additionalProperties": false,
          "type": "object",
          "required": [
            "kind",
            "range"
          ],
          "title": "PriceFilter",
          "description": "网页「创作者报价」：图文和视频是两个独立口径，必须先选一个。"
        },
        {
          "type": "null"
        }
      ],
      "description": "【仅榜 4】创作者报价/Creator price, board 4 only"
    },
    "fans": {
      "anyOf": [
        {
          "properties": {
            "min": {
              "anyOf": [
                {
                  "type": "integer",
                  "maximum": 9999999,
                  "minimum": 0
                },
                {
                  "type": "null"
                }
              ],
              "title": "Min",
              "description": "最小值（含）"
            },
            "max": {
              "anyOf": [
                {
                  "type": "integer",
                  "maximum": 9999999,
                  "minimum": 0
                },
                {
                  "type": "null"
                }
              ],
              "title": "Max",
              "description": "最大值（含）；省略=不限"
            }
          },
          "additionalProperties": false,
          "type": "object",
          "title": "RangeFilter",
          "description": "数值区间。两端可省略其一，至少给一个。"
        },
        {
          "type": "null"
        }
      ],
      "description": "【仅榜 4】创作者粉丝量区间/Creator fans range, board 4 only"
    }
  },
  "required": [
    "biz_type"
  ],
  "additionalProperties": false
}
```

## Published example

This is the provider tool’s published example. Replace example values with the user’s requested inputs, respecting the schema; do not execute an example merely to test a connection.


```json
{
  "tool_id": "tikhub/xiaohongshu-pgy-get-content-square",
  "input": {
    "biz_type": 1,
    "page_num": 1,
    "page_size": 34,
    "search_word": "",
    "order_by": "",
    "date_range": 7
  }
}
```

## 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_content_square_api_v1_xiaohongshu_pgy_get_content_square_post)

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

---

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