Keyword Research
Use these reports for keyword strategy, gap analysis, seasonal planning, and building keyword lists for campaigns or content optimization.
Keyword Trends
Best for: Understanding search volume over time — seasonality patterns, demand cycles, and emerging terms. Up to 3 years of history available.
Primary anchor: Keyword(s) + Retailer + Date Range. This report requires at least one keyword to be meaningful — without it there is no anchor.
Key tiles:
- Best Monthly Search Volume — months ranked by avg search volume; confirms seasonality peaks
- Keyword List by Search Volume — flat table of all filtered keywords ranked by avg and max monthly search volume
- Keyword Weekly Search Volume YoY Trends — year-over-year overlay by week; best view for seasonality patterns
Date filter name: Date Range. Default 52 weeks. Extend to 2–3 years for robust YoY patterns.
Note: Weekly Search Volume Trend and Keyword Count YoY Trends tiles return nulls via API — monthly aggregates (Best Monthly Search Volume tile) return correctly. Use get_report_url for weekly/YoY trend views.
Common mistake: Using too short a date range — a 4-week view misses seasonality entirely. Always pull at least 52 weeks.
Edge case filters: Is Branded Keyword, Keyword Brand, Keyword Rank Limit (default 5), YoY Compare (default 3 years).
Keyword List
Best for: Flat export of all tracked keywords for a brand, item, or category with search volume, rank, and placement data. Primary export for keyword research and gap analysis.
In-platform the report returns each keyword with: avg monthly search volume (current + past + % change), search visibility, organic/sponsored visibility, sponsorship activity, item count, brand count, avg search rank, avg organic rank, avg price, and branded keyword flag.
Primary anchor: Brand, Category, Keyword, or Item ID — all four are valid; any combination works.
Date filter name: Current Period. Default 4 weeks. Past Period should mirror Current Period to enable period-over-period comparison.
Common mistake: Exporting without filtering — a large category returns thousands of rows. Always anchor with at least brand or category first.
Keyword Opportunities
Report ID: priority-keywords Best for: Tracking keywords where a brand recently lost or gained placement on page 1 or above the fold. Scored by impact to prioritize which movements matter most.
Primary anchor: Brand. Add Item ID(s) to focus on specific products; add Category for large multi-category brands.
Six tiles, each surfacing a different movement type:
- ATF Keywords Lost — dropped out of above-the-fold (positions 1–8); ranked by Brand Volume Lost Index
- Page 1 Keywords Lost — dropped off page 1 entirely
- ATF Keywords Gained — newly appeared above the fold
- Page 1 Keywords Gained — newly appeared on page 1
- Page 1 BTF Keywords — on page 1 but below the fold; improvement opportunities
- Page 2 Keywords — on page 2; page-1 promotion candidates
Date filter name: Current Period. Default 4 weeks. Past Period sets automatically to match.
Common mistake: Treating every flagged keyword as equally urgent — always sort by impact index first. Low-volume keyword drops are low priority.
Edge case filters: Keyword, Sponsored Result (Yes/No), Own Items (Yes/No), Title.
Keyword Discovery
Report ID: item-keyword-discovery Best for: Surfacing adjacent keywords a brand is NOT currently targeting, discovered via item co-occurrence on page 1.
Primary anchor: Brand, Brand + Item ID(s), or Brand + Category. No date filter available — this is a current-state snapshot.
Key tile:
- Opportunity Keywords — each row is an adjacent keyword not currently targeted, with: keyword, branded flag, avg monthly search volume, KD keyword score (relevance + opportunity composite), ATF price, sponsored item count, sponsored brand count, ATF brand count. Sort by KD Keyword Score.
Low ATF brand count on a high-volume keyword = less crowded premium placement = easier entry.
Common mistake: Expecting this to replace traditional keyword research tools entirely — Discovery surfaces keywords based on item co-occurrence, not consumer intent modeling. Use it to expand an existing list, not as the sole input.
Edge case filters: Is Branded Keyword (filter to non-branded for gap/conquest research), Keyword Brand, Keyword (use a seed keyword as the discovery anchor instead of brand/item).
Keyword Expander
Best for: Finding adjacent sponsored keywords a brand isn't bidding on, via item co-occurrence in paid results. Complements Keyword Discovery (which is organic-focused).
Primary anchor: Keyword(s) — keyword-only anchor; no brand or category filters available.
Two tiles:
- Keywords Related Organically Through Overlapping Items — organic co-occurrence; use for organic gap analysis
- Keywords Related Through Overlapping Items Being Sponsored — sponsored co-occurrence; use for identifying where competitors are buying adjacent terms
Date filter name: Data Period Date. Default 4 weeks. No comparison period.
Edge case filters: Overlapping Items (Organic/Sponsored) threshold — increase from >=1 to raise confidence (e.g., >=3 filters out coincidental overlap). Branded Keyword filter.
Common mistake: Confusing with Keyword Discovery — Expander is sponsored-placement-focused; Discovery is organic-focused. Use both for a complete gap picture.