{ "openapi": "3.1.0", "info": { "title": "小红书蒲公英内容广场笔记 API (V1)", "version": "v0", "description": "按关键词搜索或浏览所有小红书蒲公英内容广场笔记，支持商业类别、排序、时间窗口和分页控制。用于发现高表现的活动内容。" }, "servers": [ { "url": "https://api.justoneapi.com", "description": "全球生产 API（默认）" } ], "tags": [ { "name": "小红书蒲公英", "description": "小红书蒲公英创作者市场资料、受众洞察、内容表现和活动分析。", "x-platform-id": "xiaohongshu-creator-marketplace-pugongying", "x-platform-aliases": [ "Xiaohongshu Pugongying", "Pugongying", "小红书蒲公英", "蒲公英" ], "x-platform-detection-aliases": [ "Xiaohongshu Pugongying", "Pugongying", "小红书蒲公英", "蒲公英" ] } ], "paths": { "/api/xiaohongshu-pgy/api/pgy/content_square/search_note_v2/v1": { "get": { "tags": [ "小红书蒲公英" ], "summary": "内容广场笔记", "description": "按关键词搜索或浏览所有小红书蒲公英内容广场笔记，支持商业类别、排序、时间窗口和分页控制。用于发现高表现的活动内容。", "operationId": "getApiXiaohongshuPgyApiPgyContentSquareSearchNoteV2V1", "parameters": [ { "name": "token", "in": "query", "description": "用户鉴权令牌。", "required": true, "schema": { "type": "string" } }, { "name": "searchWord", "in": "query", "description": "笔记搜索关键词。空字符串搜索所有笔记。", "required": false, "schema": { "type": "string", "default": "" } }, { "name": "pageNum", "in": "query", "description": "结果页码。", "required": false, "schema": { "type": "integer", "format": "int32", "default": 1 } }, { "name": "bizType", "in": "query", "description": "业务类别。\n\n可选值：\n- `XIAOHONGSHU_HOT`：小红书热门\n- `PRODUCT_SEEDING`：产品种草\n- `ECOMMERCE_PROMOTION`：电商推广\n- `PUGONGYING_COOPERATION`：蒲公英合作\n- `LEAD_COLLECTION`：线索收集\n- `ECOMMERCE_HOT`：电商热门\n- `SEEDING_DIRECT`：直接种草\n- `APP_PROMOTION`：App推广", "required": false, "schema": { "type": "string", "default": "XIAOHONGSHU_HOT", "description": "业务类别。", "enum": [ "XIAOHONGSHU_HOT", "PRODUCT_SEEDING", "ECOMMERCE_PROMOTION", "PUGONGYING_COOPERATION", "LEAD_COLLECTION", "ECOMMERCE_HOT", "SEEDING_DIRECT", "APP_PROMOTION" ] } }, { "name": "orderBy", "in": "query", "description": "排名指标。\n\n可选值：\n- `premium_imp_num`：曝光量\n- `premium_good_read_rate`：阅读率\n- `premium_read_num`：阅读量\n- `premium_engage_num`：互动量\n- `premium_engage_rate`：互动率\n- `premium_like_num`：点赞量\n- `premium_fav_num`：收藏量\n- `premium_cmt_num`：评论量", "required": false, "schema": { "type": "string", "default": "premium_imp_num", "description": "排名指标。", "enum": [ "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" ] } }, { "name": "nd", "in": "query", "description": "时间范围（天）。\n\n可选值：\n- `DAY_3`：最近3天\n- `DAY_7`：最近7天\n- `DAY_14`：最近14天\n- `DAY_30`：最近30天", "required": false, "schema": { "type": "string", "default": "DAY_7", "description": "时间范围（天）。", "enum": [ "DAY_3", "DAY_7", "DAY_14", "DAY_30" ] } } ], "responses": { "200": { "description": "好的", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32", "enum": [ 0, 100, 101, 202, 300, 301, 302, 303, 400, 404, 500, 503, 600, 601, 602 ] }, "message": { "type": [ "string", "null" ] }, "data": {}, "recordTime": { "type": [ "string", "null" ] }, "requestId": { "type": "string" } }, "required": [ "code", "data", "message", "recordTime" ] } } } }, "400": { "description": "请求参数或请求体无效", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32", "enum": [ 0, 100, 101, 202, 300, 301, 302, 303, 400, 404, 500, 503, 600, 601, 602 ] }, "message": { "type": [ "string", "null" ] }, "data": {}, "recordTime": { "type": [ "string", "null" ] }, "requestId": { "type": "string" } }, "required": [ "code", "data", "message", "recordTime" ] } } } }, "401": { "description": "访问令牌无效或未激活", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32", "enum": [ 0, 100, 101, 202, 300, 301, 302, 303, 400, 404, 500, 503, 600, 601, 602 ] }, "message": { "type": [ "string", "null" ] }, "data": {}, "recordTime": { "type": [ "string", "null" ] }, "requestId": { "type": "string" } }, "required": [ "code", "data", "message", "recordTime" ] } } } }, "403": { "description": "权限不足", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32", "enum": [ 0, 100, 101, 202, 300, 301, 302, 303, 400, 404, 500, 503, 600, 601, 602 ] }, "message": { "type": [ "string", "null" ] }, "data": {}, "recordTime": { "type": [ "string", "null" ] }, "requestId": { "type": "string" } }, "required": [ "code", "data", "message", "recordTime" ] } } } }, "429": { "description": "请求速率或每日配额已超限", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32", "enum": [ 0, 100, 101, 202, 300, 301, 302, 303, 400, 404, 500, 503, 600, 601, 602 ] }, "message": { "type": [ "string", "null" ] }, "data": {}, "recordTime": { "type": [ "string", "null" ] }, "requestId": { "type": "string" } }, "required": [ "code", "data", "message", "recordTime" ] } } } }, "500": { "description": "服务器内部错误", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32", "enum": [ 0, 100, 101, 202, 300, 301, 302, 303, 400, 404, 500, 503, 600, 601, 602 ] }, "message": { "type": [ "string", "null" ] }, "data": {}, "recordTime": { "type": [ "string", "null" ] }, "requestId": { "type": "string" } }, "required": [ "code", "data", "message", "recordTime" ] } } } }, "503": { "description": "服务暂时不可用", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32", "enum": [ 0, 100, 101, 202, 300, 301, 302, 303, 400, 404, 500, 503, 600, 601, 602 ] }, "message": { "type": [ "string", "null" ] }, "data": {}, "recordTime": { "type": [ "string", "null" ] }, "requestId": { "type": "string" } }, "required": [ "code", "data", "message", "recordTime" ] } } } } }, "x-order": "13002350", "x-api-version": "v1", "x-search-aliases": [ "Xiaohongshu Pugongying Content Square", "Pugongying note discovery", "Xiaohongshu campaign content search", "小红书蒲公英内容广场", "蒲公英笔记发现", "小红书投放内容搜索" ], "x-highlights": [], "x-endpoint-family": "xiaohongshu_pgy_api_pgy_content_square_search_note_v2" } } } }