biz_typeintegerrequired
Leaderboard
Possible values: 1, 2, 3, 4, 5, 6, 7, 8
Xiaohongshu PGY content square leaderboards
https://api.sandbase.ai/v1/api/xiaohongshu/pgy/content-squarePGY content square leaderboards on Xiaohongshu. Returns the platform data as structured JSON.
- Price
- $0.02USD / call
- Method
- POST
- Response
- JSON
- Parameters
- 1 required · 16 optional
Playground
Input
Leaderboard Allowed values: 1, 2, 3, 4, 5, 6, 7, 8.
Page; each board has only 100 items
Page size, 1-34
Keyword, comma-separated for batch
Sort field, empty=board default
7/14/Date window in days Allowed values: 3, 7, 14, 30.
Board 8 only Allowed values: 1, 2, 3.
Board 1 only
3/4/5/6/7/Industry, values differ per board
Content type Allowed values: 1, 2.
Content source Allowed values: 1, 2, 3, 5, 6, 11, -1.
4/5/7/Theme
3/5/7/Traffic placement Allowed values: 1, 2, 3.
Board 3 only Allowed values: 3, 8.
Creator price, board 4 only
Creator fans range, board 4 only
OutputReady
Your output will appear here
Complete the inputs, then click Run.
API README
Xiaohongshu PGY content square leaderboards API
PGY content square leaderboards on Xiaohongshu. Returns the platform data as structured JSON.
Request
curl -X POST "https://api.sandbase.ai/v1/api/xiaohongshu/pgy/content-square" \
-H "Authorization: Bearer $SANDBASE_API_KEY" \
-H "Content-Type: application/json" \
-d '{"biz_type": 1, "page_num": 1, "page_size": 20, "date_range": 7}'
The result is returned in outputs[0].data.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
biz_type | integer | Yes | Leaderboard |
author_type | integer | No | Board 4 only |
category | string | No | Board 1 only |
content_type | integer | No | Content source |
date_range | integer | No | 7/14/Date window in days |
fans | object | No | Creator fans range, board 4 only |
industry | string | No | 3/4/5/6/7/Industry, values differ per board |
marketing_target | integer | No | Board 3 only |
note_type | integer | No | Content type |
order_by | string | No | Sort field, empty=board default |
page_num | integer | No | Page; each board has only 100 items |
page_size | integer | No | Page size, 1-34 |
placement | integer | No | 3/5/7/Traffic placement |
price | object | No | Creator price, board 4 only |
search_word | string | No | Keyword, comma-separated for batch |
sub_biz_type | integer | No | Board 8 only |
theme | string | No | 4/5/7/Theme |
Pricing
Flat price per call. Failed calls, including lookups whose target does not exist, are not charged.
Start building
Send your first request
Platform API endpoint with unified authentication and usage tracking.
# The quoted heredoc keeps Unicode and shell metacharacters unchanged.
result=$(curl --fail-with-body --silent \
-X POST "https://api.sandbase.ai/v1/api/xiaohongshu/pgy/content-square" \
-H "Authorization: Bearer $SANDBASE_API_KEY" \
-H "Content-Type: application/json" \
--data-binary @- <<'SANDBASE_JSON'
{
"biz_type": 1,
"page_num": 1,
"page_size": 20,
"date_range": 7
}
SANDBASE_JSON
)
printf '%s\n' "$result"2. Authentication
Set your SandBase API key in your server environment. Requests use Bearer authentication.
export SANDBASE_API_KEY="YOUR_API_KEY"Keep your key on the server. Do not expose it in browser code.
3. Parameters
page_numinteger
Page; each board has only 100 items
Default: 1
page_sizeinteger
Page size, 1-34
Default: 34
search_wordstring
Keyword, comma-separated for batch
order_bystring
Sort field, empty=board default
date_rangeinteger
7/14/Date window in days
Default: 7
Possible values: 3, 7, 14, 30
sub_biz_typeinteger
Board 8 only
Possible values: 1, 2, 3
categorystring
Board 1 only
industrystring
3/4/5/6/7/Industry, values differ per board
note_typeinteger
Content type
Possible values: 1, 2
content_typeinteger
Content source
Possible values: 1, 2, 3, 5, 6, 11, -1
themestring
4/5/7/Theme
author_typeinteger
Board 4 only
Possible values: 1, 2
placementinteger
3/5/7/Traffic placement
Possible values: 1, 2, 3
marketing_targetinteger
Board 3 only
Possible values: 3, 8
priceobject
Creator price, board 4 only
fansobject
Creator fans range, board 4 only
4. Response
Saved example response for this API; no live request is made when viewing it.
No saved response has been published. Run the API in Playground to inspect its response.
Explore more
Related APIs
| API | Price | Response |
|---|---|---|
Xiaohongshu | $0.02 per call | JSON |
Xiaohongshu | $0.02 per call | JSON |
Xiaohongshu | $0.02 per call | JSON |
Xiaohongshu | $0.02 per call | JSON |
Xiaohongshu | $0.02 per call | JSON |
Xiaohongshu | $0.02 per call | JSON |
Questions
FAQ
How do I use the Xiaohongshu PGY content square leaderboards API?
Send a POST request to https://api.sandbase.ai/v1/api/xiaohongshu/pgy/content-square with your SandBase API key in the Authorization header (Bearer) and the parameters as a JSON body. You can also try it in the Playground on this page without writing code.
How much does the Xiaohongshu PGY content square leaderboards API cost?
$0.02 per call, billed from your SandBase balance. You are only charged for calls you make; there is no subscription.
What parameters does the Xiaohongshu PGY content square leaderboards API accept?
Required: biz_type (one of 1, 2, 3, 4, 5, 6, 7, 8). Optional: page_num (integer), page_size (integer), search_word (string), order_by (string), date_range (one of 3, 7, 14, 30) and sub_biz_type (one of 1, 2, 3) and 10 more. The Parameters table and the Playground on this page list every field.
What does the Xiaohongshu PGY content square leaderboards API return?
A JSON response returned in the same HTTP request (synchronous).
Do I need a Xiaohongshu developer account or API key?
No. Xiaohongshu PGY content square leaderboards runs through SandBase, so one SandBase API key covers this endpoint and every other API and model in the catalog. You do not need to apply for Xiaohongshu API access separately.