Back to Details

linkfox-sellersprite-market-statistics

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

SellerSprite Market Statistics

SellerSprite Market Statistics

This skill helps fetch node-level market statistics for Amazon categories via SellerSprite.
This skill helps fetch node-level market statistics for Amazon categories via SellerSprite.

Core Concepts

Core Concepts

  • 节点统计：对指定类目节点做聚合统计，不返回完整商品明细。
  • TopN 口径：
    topN
    决定头部商品统计样本数量（默认 10）。
  • 新品定义：
    newProduct
    指定“新品”按最近 N 个月定义（默认 6）。
  • Node Statistics: Aggregate statistics for the specified category node, without returning complete product details.
  • TopN Definition: 
    topN
    determines the number of top product statistical samples (default is 10).
  • New Product Definition: 
    newProduct
    specifies that "new products" are defined by the most recent N months (default is 6).

API Usage

API Usage

  • Endpoint: 
    POST https://tool-gateway.linkfox.com/sellersprite/market/statistics
  • Auth: Header 
    Authorization: <api_key>
    (
    LINKFOXAGENT_API_KEY
    )
  • 完整说明见 
    references/api.md
    ：含 
    marketplace
    / 
    month
    规则，必填 
    nodeIdPath
    ，
    topN
    /
    newProduct
    默认值；响应含 
    data[]
    中市场整体、
    hl*
    头部、
    new*
    新品与上架日期等全部字段（与 
    _sellersprite_market_statistics
    的 
    outputSchema
    一致）。
  • Runnable script: 
    scripts/sellersprite_market_statistics.py
  • Endpoint: 
    POST https://tool-gateway.linkfox.com/sellersprite/market/statistics
  • Auth: Header 
    Authorization: <api_key>
    (
    LINKFOXAGENT_API_KEY
    )
  • Full instructions can be found in 
    references/api.md
    : including rules for 
    marketplace
    / 
    month
    , required 
    nodeIdPath
    , default values for 
    topN
    /
    newProduct
    ; the response includes all fields such as overall market data in 
    data[]
    , 
    hl*
    top product data, 
    new*
    new product data and listing date (consistent with the 
    outputSchema
    of 
    _sellersprite_market_statistics
    ).
  • Runnable script: 
    scripts/sellersprite_market_statistics.py

Parameters

Parameters

参数类型必填说明
marketplacestring是站点编码，默认 
US
nodeIdPathstring是节点ID路径，如 
1064954:1069242:...
monthstring否
nearly
或 
yyyyMM
topNinteger否头部样本数，默认 10
newProductinteger否新品定义（月），默认 6
ParameterTypeRequiredDescription
marketplacestringYesSite code, default is 
US
nodeIdPathstringYesNode ID path, e.g. 
1064954:1069242:...
monthstringNo
nearly
or 
yyyyMM
topNintegerNoNumber of top samples, default is 10
newProductintegerNoNew product definition (in months), default is 6

Usage Example

Usage Example

json
{
  "marketplace": "US",
  "nodeIdPath": "172282:281407",
  "month": "nearly",
  "topN": 10,
  "newProduct": 6
}
json
{
  "marketplace": "US",
  "nodeIdPath": "172282:281407",
  "month": "nearly",
  "topN": 10,
  "newProduct": 6
}

Display Rules

Display Rules

  1. 明确展示统计口径：
    topN
    、
    newProduct
    、时间范围。
  2. 先输出关键总览指标，再输出扩展字段。
  3. 若用户未给 
    nodeIdPath
    ，先引导用户提供节点路径或先做类目定位。
  1. Clearly display statistical definitions: 
    topN
    , 
    newProduct
    , time range.
  2. Output key overview indicators first, then extended fields.
  3. If the user does not provide 
    nodeIdPath
    , first guide the user to provide the node path or perform category positioning first.

Important Limitations

Important Limitations

  • 必填参数：
    marketplace
    、
    nodeIdPath
  • nodeIdPath
    必须为合法节点路径
  • 月份查询受第三方历史范围限制
Feedback:
Auto-detect and report feedback via the Feedback API when any of the following apply:
  1. The functionality or purpose described in this skill does not match actual behavior
  2. The skill's results do not match the user's intent
  3. The user expresses dissatisfaction or praise about this skill
  4. Anything you believe could be improved
Call the feedback API as specified in 
references/api.md
. Do not interrupt the user's flow.
  • Required parameters: 
    marketplace
    , 
    nodeIdPath
  • nodeIdPath
    must be a valid node path
  • Month query is limited by the historical range of third parties
Feedback:
Auto-detect and report feedback via the Feedback API when any of the following apply:
  1. The functionality or purpose described in this skill does not match actual behavior
  2. The skill's results do not match the user's intent
  3. The user expresses dissatisfaction or praise about this skill
  4. Anything you believe could be improved
Call the feedback API as specified in 
references/api.md
. Do not interrupt the user's flow.