Just One APIPugongyingAdvertising

Search Pugongying Content Square notes by keyword

justoneapi.x.xiaohongshu-pgypgy-content-square-search-note-v2-v1

Search Xiaohongshu Pugongying Content Square notes by keyword or browse all notes, with business-category, ranking, time-window, and page controls.

Price: $0.02214/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-pgypgy-content-square-search-note-v2-v1?nd=DAY_7&bizType=XIAOHONGSHU_HOT&orderBy=premium_imp_num&pageNum=1&searchWord=coffee

Preview

Try onlineComing soonProvider docs ↗

Uses platform quota
Synchronous response
Reads public data

Parameters

Parameter	Type	Required	Description	Example
Query parameters
`nd`	string	Optional	Time range in days. Available Values: - `DAY_3`: Last 3 days - `DAY_7`: Last 7 days - `DAY_14`: Last 14 days - `DAY_30`: Last 30 days One of: DAY_3, DAY_7, DAY_14, DAY_30.	`DAY_7`
`bizType`	string	Optional	Business category. Available Values: - `XIAOHONGSHU_HOT`: Xiaohongshu hot - `PRODUCT_SEEDING`: Product seeding - `ECOMMERCE_PROMOTION`: E-commerce promotion - `PUGONGYING_COOPERATION`: Pugongying cooperation - `LEAD_COLLECTION`: Lead collection - `ECOMMERCE_HOT`: E-commerce hot - `SEEDING_DIRECT`: S One of: XIAOHONGSHU_HOT, PRODUCT_SEEDING, ECOMMERCE_PROMOTION, PUGONGYING_COOPERATION, LEAD_COLLECTION, ECOMMERCE_HOT, SEEDING_DIRECT, APP_PROMOTION.	`XIAOHONGSHU_HOT`
`orderBy`	string	Optional	Ranking metric. Available Values: - `premium_imp_num`: Exposure - `premium_good_read_rate`: Read rate - `premium_read_num`: Read count - `premium_engage_num`: Engagement count - `premium_engage_rate`: Engagement rate - `premium_like_num`: Like count - `premium_fav_num`: Favorite count - `premium_cmt One of: premium_imp_num, premium_good_read_rate, premium_read_num, premium_engage_num, premium_engage_rate, premium_like_num, premium_fav_num, premium_cmt_num.	`premium_imp_num`
`pageNum`	integer	Optional	Page number for results.	`1`
`searchWord`	string	Optional	Keyword for note search. Empty string searches all notes.

Query parameters
ndstringOptional
Time range in days. Available Values: - `DAY_3`: Last 3 days - `DAY_7`: Last 7 days - `DAY_14`: Last 14 days - `DAY_30`: Last 30 days One of: DAY_3, DAY_7, DAY_14, DAY_30.
Example: DAY_7
bizTypestringOptional
Business category. Available Values: - `XIAOHONGSHU_HOT`: Xiaohongshu hot - `PRODUCT_SEEDING`: Product seeding - `ECOMMERCE_PROMOTION`: E-commerce promotion - `PUGONGYING_COOPERATION`: Pugongying cooperation - `LEAD_COLLECTION`: Lead collection - `ECOMMERCE_HOT`: E-commerce hot - `SEEDING_DIRECT`: S One of: XIAOHONGSHU_HOT, PRODUCT_SEEDING, ECOMMERCE_PROMOTION, PUGONGYING_COOPERATION, LEAD_COLLECTION, ECOMMERCE_HOT, SEEDING_DIRECT, APP_PROMOTION.
Example: XIAOHONGSHU_HOT
orderBystringOptional
Ranking metric. Available Values: - `premium_imp_num`: Exposure - `premium_good_read_rate`: Read rate - `premium_read_num`: Read count - `premium_engage_num`: Engagement count - `premium_engage_rate`: Engagement rate - `premium_like_num`: Like count - `premium_fav_num`: Favorite count - `premium_cmt One of: premium_imp_num, premium_good_read_rate, premium_read_num, premium_engage_num, premium_engage_rate, premium_like_num, premium_fav_num, premium_cmt_num.
Example: premium_imp_num
pageNumintegerOptional
Page number for results.
Example: 1
searchWordstringOptional
Keyword for note search. Empty string searches all notes.

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-pgypgy-content-square-search-note-v2-v1?nd=DAY_7&bizType=XIAOHONGSHU_HOT&orderBy=premium_imp_num&pageNum=1&searchWord=coffee' \
  -H "X-Toolswitch-Key: $TOOLSWITCH_KEY"

import os
import requests

response = requests.request(
    "GET",
    "https://toolswitch.dev/v1/tools/justoneapi.x.xiaohongshu-pgypgy-content-square-search-note-v2-v1?nd=DAY_7&bizType=XIAOHONGSHU_HOT&orderBy=premium_imp_num&pageNum=1&searchWord=coffee",
    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-pgypgy-content-square-search-note-v2-v1?nd=DAY_7&bizType=XIAOHONGSHU_HOT&orderBy=premium_imp_num&pageNum=1&searchWord=coffee", {
  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.02214/success, including the service fee.