GET /v1/xiaohongshu_pgy/user/kol_note_list_v1
Xiaohongshu Creator Marketplace Creator Notes Pro API (V1)
stable · 20 credits per success
Retrieve a paginated list of a Xiaohongshu creator-marketplace creator's notes, with advertising, sort-order and note-type controls. Use it to browse a creator's newest, most-read or most-engaged notes.
Request parameters
| Name | Type | In | Required | Description | Example |
|---|---|---|---|---|---|
| page | integer | query | no | 页码。 | 1 |
| kolId | string | query | yes | KOL ID。 | demo |
| adSwitch | string | query | yes | 广告过滤。 可用值： - `_1`: 全流量（所有笔记） - `_0`: 自然流量（自然笔记） | _1 |
| noteType | string | query | no | 笔记类型。 可用值： - `_1`: 图文笔记 - `_2`: 视频笔记 - `_3`: 合作笔记 - `_4`: 所有类型 | _4 |
| orderType | string | query | yes | 排序顺序。 可用值： - `_1`: 最新 - `_2`: 最多阅读 - `_3`: 最多互动 | _1 |
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 20 credits. Any failure — including a 200 that fails the quality gate — costs 0.