linkfox-sif-keyword-overview

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

SIF Keyword Overview

SIF关键词概览

This skill guides you on how to query and analyze keyword-level competition data on Amazon, helping sellers assess market competitiveness and supply-demand dynamics for specific keywords.

本技能将指导您如何查询和分析亚马逊平台上的关键词级竞争数据，帮助卖家评估特定关键词的市场竞争力和供需动态。

Core Concepts

核心概念

The SIF Keyword Overview tool provides a comprehensive snapshot of competition metrics for a given keyword on Amazon. It returns the number of competing products across different placement types (organic, sponsored, video ads, brand ads, etc.), estimated weekly search volume, keyword popularity ranking, and the supply-demand ratio.

Supply-demand ratio: Calculated as

total search result product count / monthly search volume

. A lower ratio indicates less competition and greater opportunity. This is a key metric for identifying blue-ocean keywords.

Keyword popularity ranking: Represents where this keyword ranks among all keywords on the marketplace by monthly search volume. A smaller number means higher search popularity (rank 1 is the most popular). When a user says "ranking improved," it means the numeric value decreased; "ranking dropped" means the value increased.

SIF关键词概览工具可针对亚马逊上的某一关键词提供全面的竞争指标快照。它会返回不同展示类型（自然搜索、赞助广告、视频广告、品牌广告等）下的竞品数量、估算周搜索量、关键词热度排名以及供需比。

供需比：计算公式为

搜索结果商品总数 / 月搜索量

。比值越低，说明竞争越小，机会越大。这是识别蓝海关键词的核心指标。

关键词热度排名：代表该关键词在平台所有关键词中按月搜索量的排名。数值越小，搜索热度越高（排名1为最热门）。当用户说“排名上升”时，意味着数值降低；“排名下降”则意味着数值升高。

Data Fields

数据字段

Field	API Name	Description
Keyword	keyword	The queried keyword text
Keyword Popularity Rank	keywordPopularityRank	Monthly search volume rank among all keywords (lower = more popular)
Estimated Weekly Search Volume	estimatedWeeklySearchVolume	Estimated weekly search count on Amazon
Supply-Demand Ratio	supplyDemandRatio	Product count / monthly search volume (lower = less competition)
Total Search Result Products	totalSearchResultProductCount	Total products shown under this keyword (organic + ads + recommendations)
Natural Search Products	naturalSearchProductCount	Products in organic search results (excluding ads)
Sponsored Products (SP) Count	sponsoredProductsCount	Products running Sponsored Products ads
Brand Ad Products	brandAdProductCount	Products running Brand Ads
Video Ad Products	videoAdProductCount	Products running Video Ads
Total Paid Advertising Products	paidAdvertisingProductCount	All PPC ad products combined (SP + Brand + Video, etc.)
Amazon's Choice Products	amazonChoiceProductCount	Products with the Amazon's Choice badge
Top Rated Products	topRatedProductCount	Products in the Top Rated recommendation section
Search Recommendation Products	searchRecommendationProductCount	Products recommended by Amazon during search
Editorial Recommendations Products	editorialRecommendationsProductCount	Products in Editorial Recommendations section
Recommendation Non-ad Products	recNonadProductCount	Products in recommendation slots classified as non-ad (organic recommendations)
Recommendation Ad Products	recAdProductCount	Products in recommendation slots classified as ads
SIF-Tracked Exposed ASINs	trackedAsinTotalCount	Deduplicated count of ASINs that SIF tracked with any exposure score (natural/ad/recommendation) — upstream field `totalAsinNum`
Total Marketplace Keywords	totalMarketplaceKeywordCount	Total number of keywords in the marketplace
Data Period Start Date	dataPeriodStartDate	ABA week start date for the returned data (yyyy-MM-dd)
Data Period End Date	dataPeriodEndDate	ABA week end date for the returned data (yyyy-MM-dd)
Data Update Time	keywordDataUpdateTime	Last update timestamp for this keyword's data

字段	API名称	描述
Keyword	keyword	查询的关键词文本
Keyword Popularity Rank	keywordPopularityRank	在所有关键词中按月搜索量的排名（数值越小越热门）
Estimated Weekly Search Volume	estimatedWeeklySearchVolume	亚马逊平台上的估算周搜索量
Supply-Demand Ratio	supplyDemandRatio	商品数量 / 月搜索量（比值越低竞争越小）
Total Search Result Products	totalSearchResultProductCount	该关键词下展示的所有商品总数（自然搜索+广告+推荐）
Natural Search Products	naturalSearchProductCount	自然搜索结果中的商品（不含广告）
Sponsored Products (SP) Count	sponsoredProductsCount	投放Sponsored Products广告的商品
Brand Ad Products	brandAdProductCount	投放品牌广告的商品
Video Ad Products	videoAdProductCount	投放视频广告的商品
Total Paid Advertising Products	paidAdvertisingProductCount	所有PPC广告商品的总和（SP+品牌+视频等）
Amazon's Choice Products	amazonChoiceProductCount	带有Amazon's Choice标识的商品
Top Rated Products	topRatedProductCount	Top Rated推荐板块中的商品
Search Recommendation Products	searchRecommendationProductCount	搜索过程中亚马逊推荐的商品
Editorial Recommendations Products	editorialRecommendationsProductCount	Editorial Recommendations板块中的商品
Recommendation Non-ad Products	recNonadProductCount	推荐位中被归类为非广告的商品（自然推荐）
Recommendation Ad Products	recAdProductCount	推荐位中被归类为广告的商品
SIF-Tracked Exposed ASINs	trackedAsinTotalCount	SIF追踪到的有曝光量（自然/广告/推荐）的去重ASIN数量 — 上游字段 `totalAsinNum`
Total Marketplace Keywords	totalMarketplaceKeywordCount	平台中的关键词总数
Data Period Start Date	dataPeriodStartDate	返回数据对应的ABA周开始日期（yyyy-MM-dd）
Data Period End Date	dataPeriodEndDate	返回数据对应的ABA周结束日期（yyyy-MM-dd）
Data Update Time	keywordDataUpdateTime	该关键词数据的最后更新时间戳

Supported Marketplaces

支持的站点

13 marketplaces: US (United States), UK (United Kingdom), DE (Germany), CA (Canada), JP (Japan), FR (France), ES (Spain), IT (Italy), MX (Mexico), AU (Australia), AE (United Arab Emirates), BR (Brazil), SA (Saudi Arabia).

Default marketplace is US. Use US when the user does not specify a marketplace. Codes outside this list will be rejected by the API pattern.

Important: The

keyword

parameter should ideally be in the language of the target marketplace. For example, use German keywords for DE, Japanese for JP, etc. If the user provides keywords in a different language, translate them to the marketplace's local language before querying.

13个站点：US（美国）、UK（英国）、DE（德国）、CA（加拿大）、JP（日本）、FR（法国）、ES（西班牙）、IT（意大利）、MX（墨西哥）、AU（澳大利亚）、AE（阿联酋）、BR（巴西）、SA（沙特阿拉伯）。

默认站点为US。当用户未指定站点时，使用US。不在此列表中的代码会被API规则拒绝。

重要提示：

keyword

参数最好使用目标站点的语言。例如，DE站点使用德语关键词，JP站点使用日语关键词等。如果用户提供的关键词语言不同，需先将其翻译成站点本地语言再进行查询。

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/sif_keyword_overview.py

directly to run queries.

本工具调用LinkFox工具网关API。调用规范、请求参数和响应结构请查看

references/api.md

。您也可以直接执行

scripts/sif_keyword_overview.py

来运行查询。

Parameter Guide

参数指南

keyword (required): The search keyword to analyze. Should be translated to the target marketplace's language for best results. Maximum length: 1000 characters.
country (optional): The Amazon marketplace code. Defaults to
```
US
```
. See Supported Marketplaces above for valid codes.
last7d (optional, boolean, default
```
true
```
): Use the latest 7 days. When
```
false
```
, the API uses
```
startDate
```
/
```
endDate
```
.
startDate (optional,
```
yyyy-MM-dd
```
): Start date for a custom window. Takes effect when
```
last7d=false
```
.
endDate (optional,
```
yyyy-MM-dd
```
): End date paired with
```
startDate
```
.

keyword（必填）：要分析的搜索关键词。为获得最佳结果，应翻译成目标站点的语言。最大长度：1000字符。
country（可选）：亚马逊站点代码。默认值为
```
US
```
。有效代码请参考上方“支持的站点”。
last7d（可选，布尔类型，默认
```
true
```
）：使用最近7天的数据。当设为
```
false
```
时，API将使用
```
startDate
```
/
```
endDate
```
参数。
startDate（可选，格式
```
yyyy-MM-dd
```
）：自定义时间窗口的开始日期。仅当
```
last7d=false
```
时生效。
endDate（可选，格式
```
yyyy-MM-dd
```
）：与
```
startDate
```
配对的结束日期。

Usage Examples

使用示例

1. Basic keyword competition check Query: "How competitive is the keyword 'wireless charger' on Amazon US?"

json

{"keyword": "wireless charger", "country": "US"}

2. Check competition in a non-US marketplace Query: "How many competitors are there for 'Handyhulle' on Amazon Germany?"

json

{"keyword": "Handyhulle", "country": "DE"}

3. Supply-demand analysis for product research Query: "What's the supply-demand ratio for 'yoga mat' in the US?"

json

{"keyword": "yoga mat", "country": "US"}

4. Advertising competition assessment Query: "How many sellers are running ads on 'dog leash' in the UK?"

json

{"keyword": "dog leash", "country": "UK"}

5. Multi-marketplace comparison (multiple calls) Query: "Compare the competition for 'bluetooth speaker' across US, UK, and DE"

Call 1:

{"keyword": "bluetooth speaker", "country": "US"}

Call 2:

{"keyword": "bluetooth speaker", "country": "UK"}

Call 3:

{"keyword": "Bluetooth Lautsprecher", "country": "DE"}

6. Specific date range Query: "Competition for 'yoga mat' between 2026-03-08 and 2026-03-14"

json

{"keyword": "yoga mat", "country": "US", "last7d": false, "startDate": "2026-03-08", "endDate": "2026-03-14"}

1. 基础关键词竞争度查询 查询：“亚马逊美国站点上‘wireless charger’这个关键词的竞争度如何？”

json

{"keyword": "wireless charger", "country": "US"}

2. 查询非美国站点的竞争情况 查询：“亚马逊德国站点上‘Handyhulle’的竞品数量有多少？”

json

{"keyword": "Handyhulle", "country": "DE"}

3. 用于选品的供需比分析 查询：“美国站点上‘yoga mat’的供需比是多少？”

json

{"keyword": "yoga mat", "country": "US"}

4. 广告竞争评估 查询：“英国站点上‘dog leash’有多少卖家在投放广告？”

json

{"keyword": "dog leash", "country": "UK"}

5. 多站点对比（需多次调用） 查询：“对比美国、英国和德国站点上‘bluetooth speaker’的竞争情况”

调用1：

{"keyword": "bluetooth speaker", "country": "US"}

调用2：

{"keyword": "bluetooth speaker", "country": "UK"}

调用3：

{"keyword": "Bluetooth Lautsprecher", "country": "DE"}

6. 特定日期范围查询 查询：“2026-03-08至2026-03-14期间‘yoga mat’的竞争情况”

json

{"keyword": "yoga mat", "country": "US", "last7d": false, "startDate": "2026-03-08", "endDate": "2026-03-14"}

Display Rules

展示规则

Present data clearly: Show query results in a well-structured table format. Include all relevant metrics the user asked about.
Highlight key metrics: When showing results, emphasize the supply-demand ratio, keyword popularity rank, and total product count as these are the most actionable metrics.
Ranking clarification: When displaying keyword popularity rank, remind users that lower values mean higher search popularity.
Supply-demand interpretation: When showing the supply-demand ratio, provide context: values below 1 suggest high demand relative to supply (opportunity); values above 5 suggest a saturated market.
Ad competition breakdown: When users ask about advertising competition, break down the total paid advertising count into its components (SP, Brand, Video) for a more detailed view.
Error handling: When a query fails, explain the reason based on the
```
msg
```
field and suggest adjusting query parameters (e.g., check keyword spelling, try a different marketplace).
Data freshness & period: Always surface
```
keywordDataUpdateTime
```
(last refresh) plus
```
dataPeriodStartDate
```
~
```
dataPeriodEndDate
```
(the ABA week the counts describe). Do not present product counts without naming the period.
No subjective advice: Present data objectively without making business recommendations unless specifically asked.

清晰呈现数据：以结构清晰的表格形式展示查询结果，包含用户询问的所有相关指标。
突出核心指标：展示结果时，重点强调供需比、关键词热度排名和商品总数，这些是最具实操性的指标。
排名说明：展示关键词热度排名时，提醒用户数值越小代表搜索热度越高。
供需比解读：展示供需比时，提供上下文说明：比值低于1表示需求相对供给较高（存在机会）；比值高于5表示市场饱和。
广告竞争细分：当用户询问广告竞争情况时，将付费广告总数拆分为各组成部分（SP、品牌、视频），提供更详细的视图。
错误处理：当查询失败时，根据
```
msg
```
字段解释原因，并建议调整查询参数（例如检查关键词拼写、尝试其他站点）。
数据时效性与周期：始终显示
```
keywordDataUpdateTime
```
（最后更新时间）以及
```
dataPeriodStartDate
```
~
```
dataPeriodEndDate
```
（统计数据对应的ABA周）。展示商品数量时必须说明统计周期。
不提供主观建议：客观呈现数据，除非用户明确要求，否则不提供商业建议。

Important Limitations

重要限制

Single keyword per request: Each API call queries one keyword at a time. For multi-keyword comparisons, make separate calls.
Single record response: The API typically returns one data record per keyword (
```
total
```
is usually 1).
Marketplace coverage: 13 Amazon marketplaces — IN / NL / SE / PL / TR / SG are no longer supported. Keywords not found in the queried marketplace will return empty results.
Time window: Defaults to the latest 7 days. Pass
```
last7d=false
```
plus
```
startDate
```
/
```
endDate
```
for a custom ABA week range.
Keyword language: For best accuracy, keywords should be in the local language of the target marketplace.

每次请求单个关键词：每个API调用一次仅查询一个关键词。如需多关键词对比，请进行多次调用。
单条记录响应：API通常每个关键词返回一条数据记录（
```
total
```
值通常为1）。
站点覆盖范围：支持13个亚马逊站点 — IN/NL/SE/PL/TR/SG不再受支持。若查询的关键词在目标站点不存在，将返回空结果。
时间窗口：默认使用最近7天的数据。若需自定义ABA周范围，请传递
```
last7d=false
```
并搭配
```
startDate
```
/
```
endDate
```
参数。
关键词语言：为保证准确性，关键词应使用目标站点的本地语言。

User Expression & Scenario Quick Reference

用户表述与场景速查

Applicable -- Keyword-level competition and market assessment:

User Says	Scenario
"How competitive is XX keyword"	Competition intensity check
"How many products are there for XX"	Search result product count
"What's the supply-demand ratio for XX"	Supply-demand analysis
"How many sellers are advertising on XX"	Ad competition assessment
"Is XX keyword a blue ocean"	Market opportunity evaluation
"Search volume for XX keyword"	Search popularity estimation
"How popular is XX keyword on Amazon"	Keyword popularity ranking
"Compare competition across marketplaces"	Multi-market competition comparison
"How many SIF-tracked ASINs are active on this keyword"	Deduplicated tracked-ASIN count ( `trackedAsinTotalCount` )
"Competition for this keyword in a specific week"	Custom date range via `startDate` / `endDate`

Not applicable -- Needs beyond keyword competition overview:

Historical keyword ranking trends over time (use ABA Data Explorer instead)
Click share and conversion share by ASIN (use ABA Data Explorer instead)
Advertising bid strategy and PPC optimization
Product reviews, listing optimization
ASIN-level sales estimation
Detailed keyword search trend analysis over weeks/months

Feedback:

Auto-detect and report feedback via the Feedback API when any of the following apply:

The functionality or purpose described in this skill does not match actual behavior
The skill's results do not match the user's intent
The user expresses dissatisfaction or praise about this skill
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, set LinkFox Skills.

适用场景 — 关键词级竞争与市场评估：

用户表述	场景
“XX关键词的竞争度如何”	竞争强度查询
“XX关键词下有多少商品”	搜索结果商品数量查询
“XX关键词的供需比是多少”	供需分析
“XX关键词上有多少卖家在投放广告”	广告竞争评估
“XX关键词是不是蓝海词”	市场机会评估
“XX关键词的搜索量是多少”	搜索热度估算
“XX关键词在亚马逊上有多热门”	关键词热度排名查询
“对比不同站点的竞争情况”	多站点竞争对比
“这个关键词上有多少SIF追踪的活跃ASIN”	去重追踪ASIN数量查询（ `trackedAsinTotalCount` ）
“某一周XX关键词的竞争情况”	通过 `startDate` / `endDate` 自定义日期范围查询

不适用场景 — 超出关键词竞争概览的需求：

关键词长期排名趋势（请使用ABA Data Explorer）
按ASIN统计的点击份额和转化份额（请使用ABA Data Explorer）
广告出价策略与PPC优化
商品评论、Listing优化
ASIN级销量估算
关键词多周/月度搜索趋势详细分析

反馈机制：

当出现以下任一情况时，自动检测并通过Feedback API提交反馈：

本技能描述的功能或用途与实际行为不符
本技能的结果不符合用户意图
用户表达了对本技能的不满或赞赏
任何您认为可以改进的内容

请按照

references/api.md

中的指定方式调用反馈API，不要中断用户的操作流程。

如需更多高质量、专业的跨境电商技能，请访问LinkFox Skills。