Just One APIPugongyingAdvertising

Pugongying creator notes by creator id

justoneapi.x.xiaohongshu-pgy-get-kol-note-list-v1

Retrieve a paginated Xiaohongshu Pugongying creator note list with advertisement, sort-order, and note-type controls.

Price: $0.0738/successAt provider cost
Success rate: —No success-rate data yetNo success-rate data yet
Latency p50: ——
Last verified: Jul 28, 2026Verified working

GEThttps://toolswitch.dev/v1/tools/justoneapi.x.xiaohongshu-pgy-get-kol-note-list-v1?page=1&kolId=59f7c2e011be103389935c87&adSwitch=_1&noteType=_4&orderType=_1

Preview

Try onlineProvider docs ↗

Uses platform quota
Synchronous response
Reads public data

Parameters

Parameter	Type	Required	Description	Example
Query parameters
`page`	integer	Optional	Page number.	`1`
`kolId`	string	Required	KOL ID.	`59f7c2e011be103389935c87`
`adSwitch`	string	Required	Ad filter. Available Values: - `_1`: Full traffic (All notes) - `_0`: Natural traffic (Organic notes) One of: _1, _0.	`_1`
`noteType`	string	Optional	Note type. Available Values: - `_1`: Photo and Text notes - `_2`: Video notes - `_3`: Cooperation notes - `_4`: All types One of: _1, _2, _3, _4.	`_4`
`orderType`	string	Required	Sorting order. Available Values: - `_1`: Latest - `_2`: Most read - `_3`: Most interactions One of: _1, _2, _3.	`_1`

Query parameters
pageintegerOptional
Page number.
Example: 1
kolIdstringRequired
KOL ID.
Example: 59f7c2e011be103389935c87
adSwitchstringRequired
Ad filter. Available Values: - `_1`: Full traffic (All notes) - `_0`: Natural traffic (Organic notes) One of: _1, _0.
Example: _1
noteTypestringOptional
Note type. Available Values: - `_1`: Photo and Text notes - `_2`: Video notes - `_3`: Cooperation notes - `_4`: All types One of: _1, _2, _3, _4.
Example: _4
orderTypestringRequired
Sorting order. Available Values: - `_1`: Latest - `_2`: Most read - `_3`: Most interactions One of: _1, _2, _3.
Example: _1

Code samples

Replace $TOOLSWITCH_KEY with the key you created in the console.

Preview

curl -X GET 'https://toolswitch.dev/v1/tools/justoneapi.x.xiaohongshu-pgy-get-kol-note-list-v1?page=1&kolId=59f7c2e011be103389935c87&adSwitch=_1&noteType=_4&orderType=_1' \
  -H "X-Toolswitch-Key: $TOOLSWITCH_KEY"

import os
import requests

response = requests.request(
    "GET",
    "https://toolswitch.dev/v1/tools/justoneapi.x.xiaohongshu-pgy-get-kol-note-list-v1?page=1&kolId=59f7c2e011be103389935c87&adSwitch=_1&noteType=_4&orderType=_1",
    headers={"X-Toolswitch-Key": os.environ["TOOLSWITCH_KEY"]},
)
response.raise_for_status()
print(response.text)

const response = await fetch("https://toolswitch.dev/v1/tools/justoneapi.x.xiaohongshu-pgy-get-kol-note-list-v1?page=1&kolId=59f7c2e011be103389935c87&adSwitch=_1&noteType=_4&orderType=_1", {
  method: "GET",
  headers: {
    "X-Toolswitch-Key": process.env.TOOLSWITCH_KEY ?? "",
  },
});
if (!response.ok) throw new Error(`Request failed: ${response.status}`);
console.log(await response.text());

This gateway API is in preview; its URL and authentication may change. The example parameters are sample data. Calls are billed at $0.0738/success, including the service fee.