{ "openapi": "3.1.0", "info": { "title": "Xiaohongshu Creator Marketplace (Pugongying) Content Square Notes API (V1)", "version": "v0", "description": "Search Xiaohongshu Pugongying Content Square notes by keyword or browse all notes, with business-category, ranking, time-window, and page controls. Use it to discover high-performing campaign content." }, "servers": [ { "url": "https://api.justoneapi.com", "description": "Global production API (default)" } ], "tags": [ { "name": "Xiaohongshu Creator Marketplace (Pugongying)", "description": "Xiaohongshu creator marketplace profiles, audience insights, content performance, and campaign analytics.", "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": [ "Xiaohongshu Creator Marketplace (Pugongying)" ], "summary": "Content Square Notes", "description": "Search Xiaohongshu Pugongying Content Square notes by keyword or browse all notes, with business-category, ranking, time-window, and page controls. Use it to discover high-performing campaign content.", "operationId": "getApiXiaohongshuPgyApiPgyContentSquareSearchNoteV2V1", "parameters": [ { "name": "token", "in": "query", "description": "User authentication token.", "required": true, "schema": { "type": "string" } }, { "name": "searchWord", "in": "query", "description": "Keyword for note search. Empty string searches all notes.", "required": false, "schema": { "type": "string", "default": "" } }, { "name": "pageNum", "in": "query", "description": "Page number for results.", "required": false, "schema": { "type": "integer", "format": "int32", "default": 1 } }, { "name": "bizType", "in": "query", "description": "Business category.\n\nAvailable Values:\n- `XIAOHONGSHU_HOT`: Xiaohongshu hot\n- `PRODUCT_SEEDING`: Product seeding\n- `ECOMMERCE_PROMOTION`: E-commerce promotion\n- `PUGONGYING_COOPERATION`: Pugongying cooperation\n- `LEAD_COLLECTION`: Lead collection\n- `ECOMMERCE_HOT`: E-commerce hot\n- `SEEDING_DIRECT`: Seeding direct\n- `APP_PROMOTION`: App promotion", "required": false, "schema": { "type": "string", "default": "XIAOHONGSHU_HOT", "description": "Content square business category", "enum": [ "XIAOHONGSHU_HOT", "PRODUCT_SEEDING", "ECOMMERCE_PROMOTION", "PUGONGYING_COOPERATION", "LEAD_COLLECTION", "ECOMMERCE_HOT", "SEEDING_DIRECT", "APP_PROMOTION" ] } }, { "name": "orderBy", "in": "query", "description": "Ranking metric.\n\nAvailable Values:\n- `premium_imp_num`: Exposure\n- `premium_good_read_rate`: Read rate\n- `premium_read_num`: Read count\n- `premium_engage_num`: Engagement count\n- `premium_engage_rate`: Engagement rate\n- `premium_like_num`: Like count\n- `premium_fav_num`: Favorite count\n- `premium_cmt_num`: Comment count", "required": false, "schema": { "type": "string", "default": "premium_imp_num", "description": "Content square ranking metric", "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": "Time range in days.\n\nAvailable Values:\n- `DAY_3`: Last 3 days\n- `DAY_7`: Last 7 days\n- `DAY_14`: Last 14 days\n- `DAY_30`: Last 30 days", "required": false, "schema": { "type": "string", "default": "DAY_7", "description": "Content square time range", "enum": [ "DAY_3", "DAY_7", "DAY_14", "DAY_30" ] } } ], "responses": { "200": { "description": "OK", "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": "Invalid request parameters or body", "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": "Invalid or inactive access token", "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": "Permission denied", "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": "Request rate or daily quota limit exceeded", "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": "Internal server error", "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": "Service temporarily unavailable", "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" } } } }