Back to Details

linkfox-sorftime-product-search

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Sorftime Product Search

Sorftime产品搜索

This skill guides you on how to search and filter Amazon products via Sorftime across multiple dimensions, helping Amazon sellers discover products, analyze competitors, and explore market opportunities.
本技能将指导您如何通过Sorftime进行多维度的亚马逊产品搜索与筛选，帮助亚马逊卖家发掘产品、分析竞品并探索市场机会。

Core Concepts

核心概念

Sorftime Product Search supports multi-dimensional product retrieval with 16 query types, single or multi-condition AND combinations, and historical monthly snapshot lookback from January 2024. Data covers pricing, BSR rankings, monthly sales, FBA fees, and profit analysis.
Key differentiator: This tool is for searching and filtering across products. If you need detailed trend data (sales/price/BSR history) for a specific ASIN, use the Sorftime Product Detail skill instead.
Sorftime产品搜索支持多维度产品检索，包含16种查询类型，支持单条件或多条件AND组合，以及2024年1月起的历史月度快照回看。数据涵盖定价、BSR排名、月销量、FBA费用及利润分析。
核心差异：本工具用于跨产品的搜索与筛选。若需查询特定ASIN的详细趋势数据（销量/价格/BSR历史），请使用Sorftime产品详情技能。

Data Fields

数据字段

FieldAPI NameDescriptionExample
ASINasinAmazon Standard Identification NumberB0CVM8TXHP
Product TitletitleProduct listing titleAnker Portable Charger...
BrandbrandBrand nameAnker
Current PricepricePrice before Coupon, local currency (e.g., USD)29.99
Sale PricesalesPriceActual selling price after Coupon, local currency25.99
Strikethrough PriceoldPriceOriginal list price, local currency39.99
Couponcoupon>0 = discount amount (500=$5); <0 = percentage (-10=10% off)-15
BSR RanksalesRankBest Seller Rank in main category1523
Monthly SalesmonthlySalesUnits30-day sales volume (Listing level); -1 = cannot estimate4500
Monthly RevenuemonthlySalesRevenueEstimated monthly revenue, local currency; -1 = N/A116955.00
Daily SaleslistingSalesVolumeOfDailyDaily sales volume; -1 = cannot estimate150
Daily RevenuelistingSalesOfDailyDaily revenue, local currency; -1 = N/A3898.50
RatingratingCurrent rating (0.0-5.0)4.70
Rating CountratingsNumber of ratings12580
Listing DateavailableDateListing date (yyyy-MM-dd)2022-03-15
Days OnlineonlineDaysDays since listing850
FBA FeesfbaFeesFBA fulfillment fee, local currency5.40
Platform FeeplatformFeePlatform commission, local currency3.90
ProfitprofitAmountSale price - FBA - commission, local currency16.69
Profit RateprofitRateProfit margin, e.g., 25.83 = 25.83%25.83
FBA StatusisFBAWhether Buybox seller uses FBAtrue
Buybox SellerbuyboxSellerBuybox winning seller nameAnkerDirect
Seller CountrybuyboxSellerAddressSeller country code (CN, US); null if Amazon-operatedCN
Seller IDbuyBoxSellerIdBuybox seller IDA294P4X9EWVXLJ
CategorycategoryMain category [name, NodeId]["Cell Phones", "2811119011"]
Sub-categorybsrCategorySub-category rankings list[{nodeId, name, rank, date}]
VariationsvariationNumNumber of variations5
Parent ASINparentAsinParent ASIN if has variations, null otherwiseB0088PUEPK
WeightweightWeight in grams350
SizesizeDimensions in cm [longest, 2nd, shortest][18.5, 8.2, 3.1]
Main ImageimageUrlMain product image URLhttps://...
Listing URLasinUrlAmazon product page URLhttps://www.amazon.com/dp/...
字段API名称说明示例
ASINasin亚马逊标准识别码B0CVM8TXHP
产品标题title产品Listing标题Anker Portable Charger...
品牌brand品牌名称Anker
当前价格price优惠券前价格，本地货币（如USD）29.99
促销价salesPrice优惠券后实际售价，本地货币25.99
划线价oldPrice原始标价，本地货币39.99
优惠券coupon>0=折扣金额（500=$5）；<0=折扣百分比（-10=10% off）-15
BSR排名salesRank主类目畅销排名1523
月销量monthlySalesUnits30天销量（Listing层级）；-1=无法估算4500
月销售额monthlySalesRevenue预估月销售额，本地货币；-1=无数据116955.00
日销量listingSalesVolumeOfDaily日销量；-1=无法估算150
日销售额listingSalesOfDaily日销售额，本地货币；-1=无数据3898.50
评分rating当前评分（0.0-5.0）4.70
评分数量ratings评分总数12580
Listing上架日期availableDate上架日期（yyyy-MM-dd）2022-03-15
在线天数onlineDays上架至今天数850
FBA费用fbaFeesFBA配送费，本地货币5.40
平台佣金platformFee平台佣金，本地货币3.90
利润profitAmount促销价 - FBA费用 - 佣金，本地货币16.69
利润率profitRate利润率，如25.83=25.83%25.83
FBA状态isFBA购物车卖家是否使用FBAtrue
购物车卖家buyboxSeller赢得购物车的卖家名称AnkerDirect
卖家国家buyboxSellerAddress卖家国家代码（CN、US）；亚马逊自营则为nullCN
卖家IDbuyBoxSellerId购物车卖家IDA294P4X9EWVXLJ
主类目category主类目[名称, NodeId]["Cell Phones", "2811119011"]
子类目排名bsrCategory子类目排名列表[{nodeId, name, rank, date}]
变体数量variationNum产品变体数量5
父ASINparentAsin若有变体则为父ASIN，否则为nullB0088PUEPK
重量weight重量（克）350
尺寸size尺寸（厘米）[最长边, 次长边, 最短边][18.5, 8.2, 3.1]
主图链接imageUrl产品主图URLhttps://...
Listing链接asinUrl亚马逊产品页面URLhttps://www.amazon.com/dp/...

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_search.py
directly to run queries.
本工具调用LinkFox工具网关API。调用规范、请求参数及响应结构请参考
references/api.md
。您也可直接执行
scripts/sorftime_product_search.py
来运行查询。

How to Build Queries

查询构建方法

The key parameters are 
marketplace
(required), 
queryMode
, 
queryType
, and 
queryValue
. The query system has two modes and 16 filter types that can be combined flexibly.
核心参数为
marketplace
（必填）、
queryMode
、
queryType
和
queryValue
。查询系统包含两种模式和16种筛选类型，可灵活组合。

Principles for Building Queries

查询构建原则

  1. Always specify the marketplace: Use lowercase site codes, e.g., 
    us
    , 
    de
    , 
    jp
  2. Choose the right query mode: Use 
    queryMode=1
    for a single filter; use 
    queryMode=2
    to combine multiple filters with AND logic
  3. Match queryType with queryValue format: Each queryType expects a specific format — see the table below. Mismatched formats will cause errors
  4. Mind price units: Price filters (queryType=8) use smallest currency unit (cents for USD), so $19.99 = 
    1999
  5. Use open ranges when appropriate: Omit one end for open range — 
    ,1000
    means "up to 1000"; 
    100,
    means "100 or more"
  6. Use queryMonth for historical comparison: Format 
    yyyy-MM
    ; compare with a second call without queryMonth to see changes over time
  1. 必须指定站点：使用小写站点代码，如
    us
    、
    de
    、
    jp
  2. 选择正确的查询模式：单筛选条件使用
    queryMode=1
    ；多条件AND组合使用
    queryMode=2
  3. 匹配queryType与queryValue格式：每种queryType对应特定格式——详见下表。格式不匹配会导致错误
  4. 注意价格单位：价格筛选（queryType=8）使用最小货币单位（美元为美分），因此$19.99需传入
    1999
  5. 合理使用开放区间：省略一端表示开放区间——
    ,1000
    表示“最高1000”；
    100,
    表示“100及以上”
  6. 使用queryMonth进行历史对比：格式为
    yyyy-MM
    ；通过不带queryMonth的第二次调用，可查看数据变化

Query Types (queryType, for queryMode=1)

查询类型（queryType，适用于queryMode=1）

queryTypeNamequeryValue FormatExample
1ASIN SimilarASIN
B0CVM8TXHP
2CategoryNodeId
3743561
3BrandBrand name
Anker
4Seller NameStore name
AnkerDirect
5Seller IDSellerId
A294P4X9EWVXLJ
6ABA KeywordKeyword
Power Bank
7Title/Attribute MatchKeywords
10,000mAh 30W
8Price Range
min,max
(in cents)
1,1000
(=$0.01~$10)
9Monthly Sales Range
min,max
100,1000
10Seasonal ProductsMonth list
1,2,3
(peak in Jan-Mar)
11Listing Date Range
start,end
(yyyy-MM-dd)
2024-06-01,2024-12-01
12Rating Range
min,max
3,5
13Review Count Range
min,max
10,500
14Rank Range
bsr_min,bsr_max;sub_min,sub_max
500,5000;1,100
15Fulfillment
FBA
/ 
FBM
FBA,FBM
16Variation Count
min,max
1,50
Important: queryType=1 (ASIN Similar) finds products similar to the given ASIN, not the ASIN itself. To query a single product's detail, use the Sorftime Product Detail skill.
queryType名称queryValue格式示例
1ASIN相似款ASIN
B0CVM8TXHP
2类目NodeId
3743561
3品牌品牌名称
Anker
4卖家名称店铺名称
AnkerDirect
5卖家IDSellerId
A294P4X9EWVXLJ
6ABA关键词关键词
Power Bank
7标题/属性匹配关键词
10,000mAh 30W
8价格区间
min,max
（美分）
1,1000
（=$0.01~$10）
9月销量区间
min,max
100,1000
10季节性产品月份列表
1,2,3
（1-3月为旺季）
11Listing上架日期区间
start,end
（yyyy-MM-dd）
2024-06-01,2024-12-01
12评分区间
min,max
3,5
13评论数量区间
min,max
10,500
14排名区间
bsr_min,bsr_max;sub_min,sub_max
500,5000;1,100
15配送方式
FBA
/ 
FBM
FBA,FBM
16变体数量区间
min,max
1,50
重要提示：queryType=1（ASIN相似款）用于查找与指定ASIN相似的产品，而非ASIN本身。若需查询单个产品的详情，请使用Sorftime产品详情技能。

Historical Snapshots (queryMonth)

历史快照（queryMonth）

Set 
queryMonth
(format 
yyyy-MM
) to query a past month's product data snapshot. This lets users compare historical prices, rankings, and sales with current data.
  • Supported range: January 2024 to present (~2 years)
  • US, GB, DE support full "unlimited" lookback mode
  • Other sites support Top 100 products only in lookback
  • AU, BR, IN do not support lookback
设置
queryMonth
（格式
yyyy-MM
）可查询过去某一月的产品数据快照。用户可借此对比历史价格、排名及销量与当前数据。
  • 支持范围：2024年1月至今（约2年）
  • 美国、英国、德国支持完整的“无限制”回看模式
  • 其他站点仅支持回看Top 100产品
  • 澳大利亚、巴西、印度不支持回看

Query Examples for Common Scenarios

常见场景查询示例

1. Find competitors of a given ASIN
queryMode: 1, queryType: 1, queryValue: B0CVM8TXHP, marketplace: us
2. Browse a category's top products
queryMode: 1, queryType: 2, queryValue: 3743561, marketplace: us
3. Analyze a brand's product portfolio
queryMode: 1, queryType: 3, queryValue: Anker, marketplace: us
4. Search by ABA keyword
queryMode: 1, queryType: 6, queryValue: Power Bank, marketplace: us
5. Discover seasonal products (Q4 peak)
queryMode: 1, queryType: 10, queryValue: 10,11,12, marketplace: us
6. Compare historical vs current data
queryMonth: 2024-11, queryMode: 1, queryType: 2, queryValue: 3743561, marketplace: us
→ Compare with current data (no queryMonth) to see price/sales changes
7. Multi-condition: new FBA products with good sales
queryMode: 2
queryValue: [{"QueryType":11,"Content":"2024-06-01,"},{"QueryType":9,"Content":"300,"},{"QueryType":15,"Content":"FBA"}]
marketplace: us
8. Find low-price high-sales products
queryMode: 2
queryValue: [{"QueryType":8,"Content":",2000"},{"QueryType":9,"Content":"500,"}]
marketplace: us
9. Check a seller's product portfolio
queryMode: 1, queryType: 4, queryValue: AnkerDirect, marketplace: us
1. 查找指定ASIN的竞品
queryMode: 1, queryType: 1, queryValue: B0CVM8TXHP, marketplace: us
2. 浏览类目前端产品
queryMode: 1, queryType: 2, queryValue: 3743561, marketplace: us
3. 分析品牌产品组合
queryMode: 1, queryType: 3, queryValue: Anker, marketplace: us
4. 通过ABA关键词搜索
queryMode: 1, queryType: 6, queryValue: Power Bank, marketplace: us
5. 发掘季节性产品（Q4旺季）
queryMode: 1, queryType: 10, queryValue: 10,11,12, marketplace: us
6. 对比历史与当前数据
queryMonth: 2024-11, queryMode: 1, queryType: 2, queryValue: 3743561, marketplace: us
→ 与当前数据（不带queryMonth）对比，查看价格/销量变化
7. 多条件筛选：销量良好的新品FBA产品
queryMode: 2
queryValue: [{"QueryType":11,"Content":"2024-06-01,"},{"QueryType":9,"Content":"300,"},{"QueryType":15,"Content":"FBA"}]
marketplace: us
8. 查找低价高销量产品
queryMode: 2
queryValue: [{"QueryType":8,"Content":",2000"},{"QueryType":9,"Content":"500,"}]
marketplace: us
9. 查看卖家的产品组合
queryMode: 1, queryType: 4, queryValue: AnkerDirect, marketplace: us

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. Pagination notice: Search results return max 100 products per page, up to 200 pages. If results are large, show highlights and remind users to paginate
  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. Error handling: When a query fails, explain the reason based on the 
    msg
    field and suggest adjusting query criteria
  1. 仅展示数据：以清晰表格呈现查询结果，不提供主观商业建议
  2. 排名说明：展示排名数据时，提醒用户数值越小排名越靠前
  3. 分页提示：搜索结果每页最多返回100个产品，最多200页。若结果数量大，展示重点内容并提醒用户分页查看
  4. 销量估算说明：销量/销售额字段中的
    -1
    表示“无法估算”——需向用户说明，而非直接显示-1
  5. 错误处理：查询失败时，根据
    msg
    字段解释原因并建议调整查询条件

Important Limitations

重要限制

  • Pagination: Max 100 products per page, max 200 pages
  • Historical lookback: Only from January 2024; AU, BR, IN not supported
  • Non-structured data: Results do not support secondary analysis via 
    _dataQuery_executeDynamicQuery
  • Sales estimation: Products in non-standard categories may return -1 for sales fields
  • ABA keyword search (queryType=6): Currently only supports ABA keywords, not arbitrary search terms
  • 分页限制：每页最多100个产品，最多200页
  • 历史回看限制：仅支持2024年1月至今；澳大利亚、巴西、印度不支持
  • 非结构化数据：结果不支持通过
    _dataQuery_executeDynamicQuery
    进行二次分析
  • 销量估算限制：非标准类目的产品可能在销量字段返回-1
  • ABA关键词搜索（queryType=6）：目前仅支持ABA关键词，不支持任意搜索词

User Expression & Scenario Quick Reference

用户表述与场景速查

Applicable - Product search and filtering on Amazon:
User SaysScenario
"找一下这个类目下卖得好的产品"Category exploration
"Anker品牌有哪些热销产品"Brand analysis
"这个ASIN的竞品有哪些"Competitor discovery
"帮我找一些季节性产品"Seasonal product discovery
"新品中月销量超过500的有哪些"Filtered product discovery
"去年双十一这个类目的价格快照"Historical snapshot comparison
"这个卖家还卖了什么产品"Seller portfolio
"帮我筛选利润率高于30%的FBA产品"Profit-focused filtering
"月销量1000以上，评分4星以上的产品"Multi-condition filtering
"标题包含wireless charger的产品"Title keyword search
Not applicable - Needs beyond product search:
  • Detailed trend/history data for a specific ASIN (use Sorftime Product Detail)
  • 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 "competitor analysis" or "market research", if they need to discover and compare products across dimensions (category, brand, price range, etc.), this skill applies. If they need historical trend curves for a specific ASIN, use the Product Detail skill. If they need keyword search volume data, use ABA Data Explorer.
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.
适用场景 - 亚马逊产品搜索与筛选：
用户表述场景
"找一下这个类目下卖得好的产品"类目探索
"Anker品牌有哪些热销产品"品牌分析
"这个ASIN的竞品有哪些"竞品发掘
"帮我找一些季节性产品"季节性产品发掘
"新品中月销量超过500的有哪些"精准筛选产品
"去年双十一这个类目的价格快照"历史快照对比
"这个卖家还卖了什么产品"卖家产品组合分析
"帮我筛选利润率高于30%的FBA产品"利润导向筛选
"月销量1000以上，评分4星以上的产品"多条件筛选
"标题包含wireless charger的产品"标题关键词搜索
不适用场景 - 超出产品搜索的需求：
  • 特定ASIN的详细趋势/历史数据（使用Sorftime产品详情技能）
  • ABA搜索词排名数据（使用ABA数据探索工具）
  • 广告/PPC策略
  • 产品评论内容分析
  • 专利或商标查询
边界判断：当用户提及“竞品分析”或“市场调研”时，若需求为跨维度（类目、品牌、价格区间等）发掘和对比产品，适用本技能；若需求为特定ASIN的历史趋势曲线，使用产品详情技能；若需求为关键词搜索量数据，使用ABA数据探索工具。
反馈：
当出现以下任意情况时，自动检测并通过反馈API提交反馈：
  1. 本技能描述的功能或用途与实际行为不符
  2. 技能结果与用户意图不符
  3. 用户表达了对本技能的不满或赞扬
  4. 任何您认为可改进的内容
请按照
references/api.md
中的指定方式调用反馈API，不要打断用户流程。
如需更多优质专业的跨境电商技能，请访问LinkFox Skills。