Back to Details

linkfox-sorftime-product-detail

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Sorftime Product Detail

Sorftime 产品详情查询技能

This skill guides you on how to query Amazon product detail and historical trend data by ASIN via Sorftime, helping Amazon sellers analyze product performance, pricing strategy, and competitive positioning.
本技能将指导你如何通过Sorftime按ASIN查询亚马逊产品详情与历史趋势数据，帮助亚马逊卖家分析产品表现、定价策略及竞争定位。

Core Concepts

核心概念

Sorftime Product Detail provides comprehensive product-level data by ASIN, with historical trend data going back to 2021. It covers sales volume & revenue trends, price & promotion tracking, multi-level BSR ranking history, and real-time profit analysis with FBA fee breakdown.
Key differentiator: This tool returns trend/time-series data for individual products. If you need to search/filter products across a category, brand, or seller, use the Sorftime Product Search skill instead.
Sorftime 产品详情查询功能通过ASIN提供全面的产品级数据，历史趋势数据可追溯至2021年。涵盖销量与销售额趋势、价格与促销追踪、多维度BSR排名历史，以及包含FBA费用明细的实时利润分析。
核心差异点：本工具返回单个产品的趋势/时间序列数据。如果你需要按品类、品牌或卖家搜索/筛选产品，请使用Sorftime产品搜索技能。

Data Fields

数据字段

FieldAPI NameDescriptionExample
Product TitletitleProduct listing titleAnker Portable Charger...
BrandbrandBrand nameAnker
ASINasinAmazon Standard Identification NumberB0088PUEPK
Parent ASINparentAsinParent ASIN if has variations, null otherwiseB0088PUEPK
CategorycategoryMain category [name, NodeId]["Cell Phones", "2811119011"]
Sub-category RankingsbsrCategorySub-category rank list with nodeId, name, rank, date[{nodeId, name, rank, date}]
Listing DateavailableDateListing date (yyyy-MM-dd)2022-03-15
Days OnlineonlineDaysDays since listing850
Sale PricepriceSale price after Coupon, local currency (e.g., USD)25.99
Couponcoupon>0 = discount amount (500=$5); <0 = percentage (-10=10% off)-15
Platform FeeplatformFeePlatform commission, local currency3.90
FBA FeesfbaFeesFBA fulfillment fee, local currency5.40
FBA DetailfbaDetailFBA breakdown: [delivery fee, month:storage fee, ...][475, "1-9:5", "10-12:15"]
ProfitprofitAmountSale price - FBA - commission, local currency16.69
Profit RateprofitRateProfit margin, e.g., 25.83 = 25.83%25.83
BSR RanksalesRankBest Seller Rank in main category1523
BSR TrendrankTrendMain category rank history, interleaved [date, rank, ...][20250101, 1523, ...]
Sub-BSR TrendbsrRankTrendSub-category rank history per node[{NodeId, Rank: [...]}]
RatingratingCurrent rating (0.0-5.0)4.70
Rating CountratingsNumber of ratings12580
Star DistributionfiveStarRatings / fourStar... / oneStar...Star percentage, e.g., 57.7 = 57.7%57.7
Daily Sales TrendlistingSalesVolumeOfDailyTrendInterleaved [date, volume, ...]; -1 = cannot estimate[20250101, 150, ...]
Monthly Sales TrendlistingSalesVolumeOfMonthTrendInterleaved [date, volume, ...]; -1 = cannot estimate[20250101, 4500, ...]
Daily Revenue TrendlistingSalesOfDailyTrendInterleaved [date, revenue, ...]; unit = cents; -1 = N/A[20250101, 38985, ...]
Monthly Revenue TrendlistingSalesOfMonthTrendInterleaved [date, revenue, ...]; unit = cents; -1 = N/A[20250101, 1169550, ...]
Price TrendpriceTrendSale price history; unit = cents; -1 = no price that day[20250101, 2599, ...]
List Price TrendlistPriceTrendStrikethrough price history; unit = cents; -1 = N/A[20250101, 3999, ...]
Buybox SellerbuyboxSellerBuybox winning seller nameAnkerDirect
Seller CountrybuyboxSellerAddressSeller country code (CN, US, etc.); null if Amazon-operatedCN
FBA StatusisFBAWhether Buybox seller uses FBAtrue
Seller CountsellerNumNumber of sellers on this listing3
A+ ContentaPlusHas A+ contenttrue
VideohasVideoHas video on listingtrue
Brand StorehasBrandStoreHas brand storefronttrue
WeightweightWeight in grams350
SizesizeDimensions in cm [longest, 2nd, shortest][18.5, 8.2, 3.1]
FieldAPI NameDescriptionExample
Product Titletitle商品Listing标题Anker Portable Charger...
Brandbrand品牌名称Anker
ASINasin亚马逊标准识别码B0088PUEPK
Parent ASINparentAsin若存在变体则为父ASIN，否则为nullB0088PUEPK
Categorycategory主品类 [名称, NodeId]["Cell Phones", "2811119011"]
Sub-category RankingsbsrCategory子品类排名列表，包含nodeId、名称、排名、日期[{nodeId, name, rank, date}]
Listing DateavailableDate上架日期（yyyy-MM-dd）2022-03-15
Days OnlineonlineDays上架天数850
Sale Priceprice优惠券后售价，本地货币（如USD）25.99
Couponcoupon>0 = 折扣金额（500=$5）；<0 = 折扣比例（-10=10%优惠）-15
Platform FeeplatformFee平台佣金，本地货币3.90
FBA FeesfbaFeesFBA履约费用，本地货币5.40
FBA DetailfbaDetailFBA费用明细：[配送费, 月度仓储费, ...][475, "1-9:5", "10-12:15"]
ProfitprofitAmount售价 - FBA费用 - 佣金，本地货币16.69
Profit RateprofitRate利润率，如25.83=25.83%25.83
BSR RanksalesRank主品类畅销排名1523
BSR TrendrankTrend主品类排名历史，交错格式 [日期, 排名, ...][20250101, 1523, ...]
Sub-BSR TrendbsrRankTrend各节点子品类排名历史[{NodeId, Rank: [...]}]
Ratingrating当前评分（0.0-5.0）4.70
Rating Countratings评分数量12580
Star DistributionfiveStarRatings / fourStar... / oneStar...星级占比，如57.7=57.7%57.7
Daily Sales TrendlistingSalesVolumeOfDailyTrend交错格式 [日期, 销量, ...]；-1=无法估算[20250101, 150, ...]
Monthly Sales TrendlistingSalesVolumeOfMonthTrend交错格式 [日期, 销量, ...]；-1=无法估算[20250101, 4500, ...]
Daily Revenue TrendlistingSalesOfDailyTrend交错格式 [日期, 销售额, ...]；单位=分；-1=无数据[20250101, 38985, ...]
Monthly Revenue TrendlistingSalesOfMonthTrend交错格式 [日期, 销售额, ...]；单位=分；-1=无数据[20250101, 1169550, ...]
Price TrendpriceTrend售价历史；单位=分；-1=当日无价格数据[20250101, 2599, ...]
List Price TrendlistPriceTrend划线价历史；单位=分；-1=无数据[20250101, 3999, ...]
Buybox SellerbuyboxSeller赢得BuyBox的卖家名称AnkerDirect
Seller CountrybuyboxSellerAddress卖家国家代码（CN、US等）；若为亚马逊自营则为nullCN
FBA StatusisFBABuyBox卖家是否使用FBAtrue
Seller CountsellerNum该Listing的卖家数量3
A+ ContentaPlus是否拥有A+内容true
VideohasVideoListing是否带有视频true
Brand StorehasBrandStore是否拥有品牌旗舰店true
Weightweight重量（克）350
Sizesize尺寸（厘米）[最长边, 次长边, 最短边][18.5, 8.2, 3.1]

Supported Marketplaces

支持站点

US (United States), GB (United Kingdom), DE (Germany), FR (France), IN (India), CA (Canada), JP (Japan), ES (Spain), IT (Italy), MX (Mexico), AE (United Arab Emirates), AU (Australia), BR (Brazil), SA (Saudi Arabia)
Default marketplace is US. Use 
us
when the user doesn't specify a marketplace.
Note: Sorftime uses lowercase codes (e.g., 
us
, 
gb
, 
de
), and UK is coded as 
gb
(not 
uk
).
美国（US）、英国（GB）、德国（DE）、法国（FR）、印度（IN）、加拿大（CA）、日本（JP）、西班牙（ES）、意大利（IT）、墨西哥（MX）、阿联酋（AE）、澳大利亚（AU）、巴西（BR）、沙特阿拉伯（SA）
默认站点为美国（US）。若用户未指定站点，使用
us
。
注意：Sorftime使用小写站点代码（如
us
、
gb
、
de
），英国的代码为
gb
（而非
uk
）。

API Usage

API 使用说明

This tool calls the LinkFox tool gateway API. See 
references/api.md
for calling conventions, request parameters, and response structure. You can also execute 
scripts/sorftime_product_detail.py
directly to run queries.
本工具调用LinkFox工具网关API。调用规范、请求参数及响应结构请参考
references/api.md
。你也可以直接执行
scripts/sorftime_product_detail.py
来运行查询。

How to Build Queries

查询构建方法

The key parameters are 
asin
and 
marketplace
(both required), plus optional trend date range controls.
关键参数为
asin
和
marketplace
（均为必填项），此外还有可选的趋势日期范围控制参数。

Principles for Building Queries

查询构建原则

  1. Always specify the marketplace: Use lowercase site codes, e.g., 
    us
    , 
    de
    , 
    jp
  2. Choose trend inclusion carefully: Default includes trends (last 15 days). Set 
    includeTrend: 2
    if only basic product info is needed — this saves cost and speeds up response
  3. Specify date range for historical analysis: Use 
    queryTrendStartDate
    and 
    queryTrendEndDate
    (yyyy-MM-dd) when users need trends beyond the default 15 days. Be aware this costs double
  4. Batch ASINs when comparing: Up to 10 ASINs can be queried at once, comma-separated — use this for competitive comparison rather than calling one at a time
  1. 务必指定站点：使用小写站点代码，如
    us
    、
    de
    、
    jp
  2. 谨慎选择是否包含趋势数据：默认包含最近15天的趋势数据。若仅需基础产品信息，设置
    includeTrend: 2
    ——这将节省成本并加快响应速度
  3. 为历史分析指定日期范围：当用户需要默认15天以外的趋势数据时，使用
    queryTrendStartDate
    和
    queryTrendEndDate
    （格式为yyyy-MM-dd）。请注意此操作成本翻倍
  4. 对比时批量查询ASIN：一次最多可查询10个ASIN，用逗号分隔——此方式适用于竞品对比，而非逐个查询

Query Examples for Common Scenarios

常见场景查询示例

1. Quick product check (default 15-day trend)
asin: B00FLYWNYQ, marketplace: us
2. Long-range trend analysis (specify dates)
asin: B00FLYWNYQ, marketplace: us
queryTrendStartDate: 2025-01-01, queryTrendEndDate: 2025-03-31
3. Batch ASIN comparison
asin: B0088PUEPK,B00U26V4VQ,B0CVM8TXHP, marketplace: us
4. Product info only, no trends
asin: B0088PUEPK, marketplace: us, includeTrend: 2
5. BSR ranking history (German market)
asin: B00FLYWNYQ, marketplace: de
queryTrendStartDate: 2024-06-01, queryTrendEndDate: 2025-01-01
1. 快速产品查询（默认15天趋势）
asin: B00FLYWNYQ, marketplace: us
2. 长期趋势分析（指定日期）
asin: B00FLYWNYQ, marketplace: us
queryTrendStartDate: 2025-01-01, queryTrendEndDate: 2025-03-31
3. 批量ASIN对比
asin: B0088PUEPK,B00U26V4VQ,B0CVM8TXHP, marketplace: us
4. 仅查询产品信息，不含趋势数据
asin: B0088PUEPK, marketplace: us, includeTrend: 2
5. BSR排名历史（德国站点）
asin: B00FLYWNYQ, marketplace: de
queryTrendStartDate: 2024-06-01, queryTrendEndDate: 2025-01-01

Trend Data Interpretation

趋势数据解读

Trend arrays use an interleaved format: even indices are dates, odd indices are values.
[20250101, 150, 20250102, 180, 20250103, 165, ...]
 ^date     ^val ^date     ^val ^date     ^val
  • Sales volume/revenue trends: value of 
    -1
    means "cannot estimate" (e.g., category changed to Amazon Renewed)
  • Price trends: units are in local currency smallest unit (cents for USD); 
    -1
    means no available price that day
  • BSR rank trends: for 
    bsrRankTrend
    , format is 
    [{NodeId: xxx, Rank: [date, rank, ...]}]
    per sub-category
趋势数组采用交错格式：偶数索引为日期，奇数索引为对应数值。
[20250101, 150, 20250102, 180, 20250103, 165, ...]
 ^date     ^val ^date     ^val ^date     ^val
  • 销量/销售额趋势：值为
    -1
    表示“无法估算”（例如，品类变更为Amazon Renewed）
  • 价格趋势：单位为本地货币最小单位（美元为分）；
    -1
    表示当日无可用价格数据
  • BSR排名趋势：
    bsrRankTrend
    的格式为每个子品类对应
    [{NodeId: xxx, Rank: [date, rank, ...]}]

Display Rules

展示规则

  1. Present data only: Show query results in clear tables without subjective business advice
  2. Ranking clarification: When showing ranking data, remind users that lower values mean better rankings
  3. Price unit awareness: Trend data uses smallest currency unit (cents for USD). Convert to standard currency when displaying to users
  4. Sales estimation caveat: Values of 
    -1
    in sales/revenue fields mean "cannot estimate" — explain this to the user rather than showing -1 directly
  5. Trend visualization: When showing trend data, present key data points in a readable table rather than dumping raw arrays
  6. Error handling: When a query fails, explain the reason based on the 
    msg
    field and suggest adjusting query criteria
  1. 仅展示数据：以清晰表格展示查询结果，不提供主观商业建议
  2. 排名说明：展示排名数据时，提醒用户数值越小排名越靠前
  3. 价格单位注意：趋势数据使用货币最小单位（美元为分）。向用户展示时需转换为标准货币单位
  4. 销量估算说明：销量/销售额字段中的
    -1
    表示“无法估算”——需向用户解释，而非直接显示-1
  5. 趋势可视化：展示趋势数据时，将关键数据点整理为易读表格，而非直接输出原始数组
  6. 错误处理：查询失败时，根据
    msg
    字段解释原因，并建议调整查询条件

Important Limitations

重要限制

  • Max 10 ASINs per query
  • Trend cost: Default returns last 15 days; querying > 15 days costs double
  • Non-structured data: Results do not support secondary analysis via 
    _dataQuery_executeDynamicQuery
  • Sales estimation: Products in non-standard categories (e.g., Amazon Renewed) may return -1 for sales fields
  • 每次查询最多支持10个ASIN
  • 趋势数据成本：默认返回最近15天数据；查询超过15天的数据成本翻倍
  • 非结构化数据：查询结果不支持通过
    _dataQuery_executeDynamicQuery
    进行二次分析
  • 销量估算限制：非标准品类的产品（如Amazon Renewed）的销量字段可能返回-1

User Expression & Scenario Quick Reference

用户表达与场景速查

Applicable - Product detail and trend queries by ASIN:
User SaysScenario
"查一下这个ASIN的销量走势"Sales trend
"这个产品最近价格变化如何"Price history
"帮我看看这个产品的利润空间"Profit analysis
"这个ASIN的BSR排名趋势"Ranking history
"对比一下这几个ASIN的数据"Multi-ASIN comparison
"这个产品的FBA费用是多少"FBA fee breakdown
"产品上架多久了，评分怎么样"Basic product info
Not applicable - Needs beyond single-product detail:
  • Searching/filtering products across a category or brand (use Sorftime Product Search)
  • ABA search term ranking data (use ABA Data Explorer)
  • Advertising / PPC strategy
  • Product reviews content analysis
  • Patent or trademark checks
Boundary judgment: When users say "product analysis" or "competitor comparison", if it boils down to checking specific ASINs' detail data and trend curves, then this skill applies. If they're asking to discover or filter products across a market, it does not apply.
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.
For more high-quality, professional cross-border e-commerce skills, visit LinkFox Skills.
适用场景 - 按ASIN查询产品详情及趋势：
用户表述场景
"查一下这个ASIN的销量走势"销量趋势查询
"这个产品最近价格变化如何"价格历史查询
"帮我看看这个产品的利润空间"利润分析
"这个ASIN的BSR排名趋势"排名历史查询
"对比一下这几个ASIN的数据"多ASIN对比
"这个产品的FBA费用是多少"FBA费用明细查询
"产品上架多久了，评分怎么样"基础产品信息查询
不适用场景 - 超出单个产品详情的需求：
  • 按品类或品牌搜索/筛选产品（请使用Sorftime产品搜索技能）
  • ABA搜索词排名数据（请使用ABA数据探索工具）
  • 广告/PPC策略
  • 产品评论内容分析
  • 专利或商标查询
边界判断：当用户提及“产品分析”或“竞品对比”时，若核心需求是查询特定ASIN的详情数据及趋势曲线，则适用本技能；若需求是在整个市场中发掘或筛选产品，则不适用。
反馈机制：
当出现以下任一情况时，自动检测并通过反馈API提交反馈：
  1. 本技能描述的功能或用途与实际行为不符
  2. 本技能的结果与用户意图不符
  3. 用户对本技能表达不满或赞扬
  4. 任何你认为可以改进的内容
按照
references/api.md
中的指定方式调用反馈API，请勿打断用户的操作流程。
如需更多高质量、专业的跨境电商技能，请访问LinkFox Skills。