POST /v1/xiaohongshu/pgy/content_square
PGY Content Square
stable · 26 credits per success
PGY content leaderboards, switched by biz_type: platform-wide hits, industry sponsored notes, e-commerce promotions and more. Filterable by category, industry, date range, sort field and quote range.
Request parameters
| Name | Type | In | Required | Description | Example |
|---|---|---|---|---|---|
| fans | object | body | no | 粉丝筛选对象 | demo |
| price | object | body | no | 报价筛选对象，如 kind、range.min、range.max | demo |
| theme | string | body | no | 内容主题 | demo |
| biz_type | integer | body | yes | 榜单类型：1 全平台热门、3 电商推广、4 行业合作笔记 | 1 |
| category | string | body | no | 内容类目，如 内容类目#美妆 | demo |
| industry | string | body | no | 行业，如 母婴 | demo |
| order_by | string | body | no | 排序字段，如 premium_engage_rate | demo |
| page_num | integer | body | no | 页码，从 1 开始 | demo |
| note_type | integer | body | no | 笔记类型：1 图文、2 视频 | demo |
| page_size | integer | body | no | 每页条数 | demo |
| placement | integer | body | no | 投放场域 | demo |
| date_range | integer | body | no | 时间范围（天）：7 / 30 | demo |
| author_type | integer | body | no | 作者类型 | demo |
| search_word | string | body | no | 搜索词 | demo |
| content_type | integer | body | no | 内容类型 | demo |
| sub_biz_type | integer | body | no | 子榜单类型 | demo |
| marketing_target | integer | body | no | 营销目标 | demo |
Response fields
Field dictionary coming soon — the executable panel shows the live shape.
Errors
| code | HTTP | Meaning | Billed |
|---|---|---|---|
| 40001 | 400 | Invalid parameters | no |
| 40102 | 401 | Invalid or revoked API Key | no |
| 40201 | 402 | Insufficient credits | no |
| 40402 | 404 | Resource not found | no |
| 42201 | 422 | Quality gate failed | no |
| 42901 | 429 | Rate limit exceeded | no |
| 50401 | 504 | Upstream timeout | no |
| 50201 | 502 | Upstream error | no |
Billing
Success costs 26 credits. Any failure — including a 200 from upstream that fails the quality gate — costs 0.