{
  "openapi": "3.0.0",
  "info": {
    "title": "Xiaohongshu Creator Marketplace (Pugongying) Content Square Notes API (V1)",
    "version": "1.0.0",
    "description": "Search Xiaohongshu Creator Marketplace (Pugongying) content square notes by business type, ranking metric, time range, and keyword."
  },
  "servers": [
    {
      "url": "https://api.justoneapi.com",
      "description": "prod-global (default)"
    },
    {
      "url": "http://47.117.133.51:30015",
      "description": "prod-cn (optional for Mainland China)"
    }
  ],
  "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 Creator Marketplace (Pugongying) content square notes by business type, ranking metric, time range, and keyword.",
        "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": {
              "*/*": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "string",
                      "enum": [
                        "0",
                        "100",
                        "101",
                        "202",
                        "300",
                        "301",
                        "302",
                        "303",
                        "400",
                        "500",
                        "600",
                        "601"
                      ]
                    },
                    "message": {
                      "type": "string"
                    },
                    "data": {
                      "type": "object"
                    },
                    "recordTime": {
                      "type": "string",
                      "format": "date-time"
                    }
                  }
                }
              }
            }
          }
        },
        "x-order": "13002350",
        "x-api-version": "v1",
        "x-highlights": []
      }
    }
  },
  "components": {}
}