小红书 API

带货达人侧详情查询

POST

/ark/open_api/v3/common_controller

请求示例

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://ark.xiaohongshu.com/ark/open_api/v3/common_controller' \
--header 'Content-Type: application/json;charset=utf-8' \
--data-raw '{
    "orderId": "null"
}'

响应示例

{
  "cpsUserSettleDetails": [
    {
      "packageId": "null",
      "returnIds": [
        "string"
      ],
      "goodsId": "null",
      "goodsName": "null",
      "goodsTotal": "",
      "sellerId": "null",
      "kolUserId": "null",
      "kolUserName": "null",
      "dealTotalAmount": "",
      "returnTotalAmount": "",
      "taxTotalAmount": "",
      "carryingTotalAmount": "",
      "sellerRate": "",
      "kolUserShareRatio": "",
      "kolUserRate": "",
      "kolUserCommissionAmount": "",
      "settleStatus": "null",
      "orderTime": "",
      "finishTime": "",
      "canSettleTime": "",
      "settleTime": ""
    }
  ]
}

请求参数

Header 参数

Content-Type

string

可选

默认值:

application/json;charset=utf-8

Body 参数application/json

orderId

string

订单号

必需

示例

返回响应

🟢200成功

application/json

Body

cpsUserSettleDetails

array [object {21}]

订单结算明细列表

必需

packageId

string

订单号

可选

returnIds

array[string]

退款单号列表

可选

goodsId

string

商品id

可选

goodsName

string

商品名称

可选

goodsTotal

string

原始下单的商品数量

可选

sellerId

string

商家id

可选

kolUserId

string

推广达人id

可选

kolUserName

string

达人昵称

可选

dealTotalAmount

string

可选

商品实付金额，单位分

returnTotalAmount

string

可选

商品实退金额，单位分

taxTotalAmount

string

商品税金，单位分

可选

carryingTotalAmount

string

可选

带货金额=实付金额-实退金额-2B税金，单位分

sellerRate

string

可选

商家在推广计划中设置的cps推广佣金率，商家支付的佣金比率，单位万分比

kolUserShareRatio

string

可选

达人佣金分成比例，单位万分比，固定为8000，也就是80%

kolUserRate

string

可选

达人CPS佣金率=商家CPS佣金率*达人分成比例，单位万分比

kolUserCommissionAmount

string

可选

达人CPS佣金=带货金额*达人CPS佣金率，单位分

settleStatus

string

可选

待结算（WAIT_SETTLE）、已结算（SETTLED）（待结算订单只有在下单48小时后可查，因为下单48小时内可能离线归因未完成，导致CPS计算不准确）

orderTime

string

下单时间，单位ms

可选

finishTime

string

完成时间，单位ms

可选

canSettleTime

string

可选

可结算时间，单位ms

settleTime

string

可选

已结算时间，单位ms

由末级分类获取规格（旧）

查询月度结算单下载地址