Market Insights Reports

Category Snapshot & Market Share

Report ID: category-snapshot Best starting report in the platform.

Shows a full competitive picture of a category: top brands, top items, keyword landscape, sales share, and sponsorship activity in one view.

Primary anchor: Category (Department + Category Tree) + Retailer + Date. Always confirm the right category node using Category List first.

Key tiles:

• At a Glance — KPI summary: brand count, item count, keyword count, organic search visibility, sponsorship activity, % change vs. prior period
• Top Selling Brands/Items by Share of Sales — estimated BSR-modeled sales share
• Most Identified Organic Keywords / Sponsored Keywords — keyword landscape
• Share of Sponsorship Activity by Brand — weekly paid investment trend
• Price Distribution — items and sponsored activity by price tier

Date filter name: Data Period Date. Default 4 weeks; 13 weeks is standard for a rolling quarter view.

Common mistake: Filtering at too high a level (e.g., "Electronics" instead of "Over-Ear Headphones"). Always drill to the lowest relevant category node.

Edge case filters: Brand (own-brand lens), Item ID, Keyword, Ad Type, Price, Seller Type/Name (Walmart only).

Keyword Snapshot

Best for: Understanding who owns a specific keyword — which brands and items are winning organically and in paid search on that term.

Primary anchor: Keyword(s) + Retailer + Date. Can also anchor by Category to see the full keyword landscape.

Key tiles:

• Keywords summary — search volume, brand count, item count, sponsorship activity
• Top Organic Ranking Item/Brand Performance — who's winning organically
• Top Sponsored Item/Brand Activity — who's most active in paid
• Sponsorship Activity Share by Brand — weekly paid trend per brand
• Search Volume — weekly demand trend for the keyword

Date filter name: Data Period Date. Default 4 weeks.

Common mistake: Filtering by too many unrelated keywords at once — blend different intents and the view becomes meaningless. Group by intent or theme.

Competitive Brand Comparison

Best for: Multi-brand head-to-head comparisons on search visibility, sales share, and paid activity. Good for custom competitive sets or categories that don't fit a standard taxonomy node.

Primary anchor: Multiple brands (comma-separated in Brand filter) + Retailer + Date. Does NOT normalize brand name variants — ensure consistent naming.

Key tiles:

• Search Visibility by Brand — ranked by total visibility score and sponsorship activity share
• Details by Brand — full metrics table per brand
• Details by Keyword — keyword-level SOV per brand (SOV values populate correctly here, unlike most reports)
• Details by Category — category-level breakdown per brand
• Top Items by Search Visibility / Sponsorship

Date filter name: Data Period Date. Default 4 weeks.

Note: Trend tiles (Organic Keyword Count Trends, Search Visibility Trends, etc.) return nulls via API — data renders in the platform UI. Use get_report_url for trend views.

Common mistake: Entering name variants of the same brand (e.g., "P&G" and "Procter & Gamble") — each is treated as a separate brand.

Brand KPIs & Benchmarks

Best for: Benchmarking a brand's performance (sales share, search visibility, sponsorship activity) against all other brands in a category using percentile rankings. Good for pitch support and client health checks.

Primary anchor: Brand + Category + Retailer + Date.

Key tiles:

• At a Glance — most data-rich KPI tile in the platform: keywords, organic visibility, sponsorship activity, SOV, sales share, BSR score
• Keyword Count / Organic Search Visibility / Sponsorship Activity Benchmark — three percentile scores (0–100) vs. category peers
• Sales Performance Benchmark — percentile score for BSR performance
• Benchmarks by Keyword — keyword-level benchmark scores

Date filter name: Data Period Date. Default 4 weeks.

Important: Benchmark scores are percentile ranks (0–100), not share percentages. A score of 100 means the brand leads the category on that metric — it does not mean 100% share. Share of Voice and Share of Sales trend tiles return nulls via API.

Common mistake: Presenting percentile rank as "share" — a brand in the 90th percentile for search visibility does not have 90% search share.

Brand Snapshot (Legacy)

Report ID: brand-snapshot note: This is a Legacy report and will be retired soon

Single-brand overview of sales share, search visibility, keyword placement, and sponsorship activity over time. Still heavily used but neither this nor Brand & Items Snapshot is fully stable. For brand overviews, prefer Executive Summary (Search Intelligence) or Executive Dashboard. For item/keyword tracking, use Organic Rank Tracker.

Primary anchor: Brand + Category + Retailer + Date.

Date filter name: Data Period Date. Default 4 weeks.

Brand & Items Snapshot

Report ID: competitive-brand-snapshot 

Newer version combining brand and item-level metrics including SOV trends (SOV values populate correctly here). Being redesigned. Use for item-level drill-down only until redesign is complete.

Primary anchor: Brand + Category + Retailer + Date.

Date filter name: Data Period Date. Default 4 weeks.

Note: Navigation tiles (labeled "Top Sponsored Keywords" variants) are UI buttons linking to other reports — not data tiles. Ignore when querying via API.

Marketplace Intelligence

Report ID: brand-finder Best for: Business development and prospecting. Hidden report — access via search bar.

Shows all brands active in a category ranked by search visibility and estimated sales share. Designed to surface which brands to target for new business and quickly pull competitive KPIs.

Primary anchor: Category (Department + Category Tree) + Retailer. Leave Brand filter open — filtering to a single brand collapses the competitive landscape view.

Key tiles:

• Top Brands in Search — ranked by organic visibility with full paid/organic breakdown by ad type
• Top Brands in Sales — ranked by estimated sales share with BSR, rating, review count, price range

Date filter name: Data Period Date. Default 2 weeks; extend to 4–8 weeks for more stable rankings.

Common mistake: Filtering by a specific brand — this defeats the purpose. Leave Brand open to see the full landscape.