小红书蒲公英内容广场笔记 API (V1)
GET
/api/xiaohongshu-pgy/api/pgy/content_square/search_note_v2/v1
接口健康状态
健康 可用 少量可用 基本不可用 暂无数据
正在加载健康状态…
按业务类型、排名指标、时间范围和关键词搜索小红书蒲公英内容广场笔记。
请求参数
| 参数名 | 位置 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|---|
token | query | string | 是 | - | 用户鉴权令牌。 |
searchWord | query | string | 否 | `` | 笔记搜索关键词。空字符串搜索所有笔记。 |
pageNum | query | integer | 否 | 1 | 结果页码。 |
bizType | query | string | 否 | XIAOHONGSHU_HOT | 业务类别。 可选值： - XIAOHONGSHU_HOT：小红书热门- PRODUCT_SEEDING：产品种草- ECOMMERCE_PROMOTION：电商推广- PUGONGYING_COOPERATION：蒲公英合作- LEAD_COLLECTION：线索收集- ECOMMERCE_HOT：电商热门- SEEDING_DIRECT：直接种草- APP_PROMOTION：App推广 |
orderBy | query | string | 否 | premium_imp_num | 排名指标。 可选值： - 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：评论量 |
nd | query | string | 否 | DAY_7 | 时间范围（天）。 可选值： - DAY_3：最近3天- DAY_7：最近7天- DAY_14：最近14天- DAY_30：最近30天 |
代码示例
💡 环境说明
默认使用 https://api.justoneapi.com；中国大陆用户也可以改用 http://47.117.133.51:30015。
bash
curl -X GET "https://api.justoneapi.com/api/xiaohongshu-pgy/api/pgy/content_square/search_note_v2/v1?token=YOUR_API_KEY"text
我想使用 Just One API 提供的“内容广场笔记 (V1)”接口。
接入地址: 默认使用 https://api.justoneapi.com；中国大陆用户也可以改用 http://47.117.133.51:30015。
接口路径: /api/xiaohongshu-pgy/api/pgy/content_square/search_note_v2/v1?token=YOUR_API_KEY
接口地址: BASE_URL + /api/xiaohongshu-pgy/api/pgy/content_square/search_note_v2/v1?token=YOUR_API_KEY
HTTP 方法: GET
身份验证: 在 URL 后添加查询参数“?token=您的API密钥”。
OpenAPI 定义: https://docs.justoneapi.com/openapi/xiaohongshu-creator-marketplace-pugongying/content-square-notes-v1-zh.json
请求参数说明:
- token (query): 用户鉴权令牌。 (必填)
- searchWord (query): 笔记搜索关键词。空字符串搜索所有笔记。
- pageNum (query): 结果页码。
- bizType (query): 业务类别。
可选值：
- `XIAOHONGSHU_HOT`：小红书热门
- `PRODUCT_SEEDING`：产品种草
- `ECOMMERCE_PROMOTION`：电商推广
- `PUGONGYING_COOPERATION`：蒲公英合作
- `LEAD_COLLECTION`：线索收集
- `ECOMMERCE_HOT`：电商热门
- `SEEDING_DIRECT`：直接种草
- `APP_PROMOTION`：App推广
- orderBy (query): 排名指标。
可选值：
- `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`：评论量
- nd (query): 时间范围（天）。
可选值：
- `DAY_3`：最近3天
- `DAY_7`：最近7天
- `DAY_14`：最近14天
- `DAY_30`：最近30天
返回格式: JSON
响应处理与错误码：
1. 需通过返回体中的 "code" 字段判断业务结果（code 为 0 表示成功）。
2. 超时建议：建议将请求超时时间设置为至少 60 秒。
3. 业务码说明：
- 0: 成功
- 100: Token 无效或已失效
- 301: 采集失败，请重试
- 302: 超出速率限制
- 303: 超出每日配额
- 400: 参数错误
- 500: 内部服务器错误
- 600: 权限不足
- 601: 余额不足
请帮我用我擅长的编程语言写一个脚本来调用这个接口，并处理返回结果。python
import requests
BASE_URL = "https://api.justoneapi.com" # 大陆用户可改为 "http://47.117.133.51:30015"
url = BASE_URL + "/api/xiaohongshu-pgy/api/pgy/content_square/search_note_v2/v1?token=YOUR_API_KEY"
response = requests.get(url)
print(response.json())js
const BASE_URL = "https://api.justoneapi.com"; // 大陆用户可改为 "http://47.117.133.51:30015"
const url = BASE_URL + "/api/xiaohongshu-pgy/api/pgy/content_square/search_note_v2/v1?token=YOUR_API_KEY";
const response = await fetch(url, {
method: "GET"
});
const data = await response.json();
console.log(data);java
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
public class Main {
public static void main(String[] args) throws Exception {
final String BASE_URL = "https://api.justoneapi.com"; // 大陆用户可改为 "http://47.117.133.51:30015"
final String url = BASE_URL + "/api/xiaohongshu-pgy/api/pgy/content_square/search_note_v2/v1?token=YOUR_API_KEY";
HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create(url))
.method("GET", HttpRequest.BodyPublishers.noBody())
.build();
HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
}
}go
package main
import (
"fmt"
"io"
"net/http"
)
const BASE_URL = "https://api.justoneapi.com" // 大陆用户可改为 "http://47.117.133.51:30015"
func main() {
client := &http.Client{}
url := BASE_URL + "/api/xiaohongshu-pgy/api/pgy/content_square/search_note_v2/v1?token=YOUR_API_KEY"
req, _ := http.NewRequest("GET", url, nil)
resp, _ := client.Do(req)
defer resp.Body.Close()
body, _ := io.ReadAll(resp.Body)
fmt.Println(string(body))
}php
<?php
$BASE_URL = "https://api.justoneapi.com"; // 大陆用户可改为 "http://47.117.133.51:30015"
$url = $BASE_URL . "/api/xiaohongshu-pgy/api/pgy/content_square/search_note_v2/v1?token=YOUR_API_KEY";
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "GET");
$response = curl_exec($ch);
curl_close($ch);
echo $response;响应结果示例
正在加载最新成功示例…