Market Overview

Market Overview

Get a high-level view of an e-commerce market or category — top companies, top products, and pricing landscape.

When to use

When the user wants to understand a market or product category at a high level, not a specific company.

Workflow

1. Discover categories using get_product_types (FREE) to find the right product_type filter value.

   • Call with no args for root categories, then drill into subcategories with parent_product_type_id
   • Use the product_type_id from the result as the product_type filter in other tools

2. Get top companies using get_market_top_companies. Costs 1 credit per company returned.

   • Filter by product_type to focus on a category
   • Filter by keyword for market segments (e.g., 'sustainable', 'luxury')
   • Use end_date to analyze a specific point in time

3. Get top products using get_market_top_products. Costs 1 credit per product returned.

   • Same filters as above for consistent analysis
   • Returns bestselling products across all companies

4. Get pricing analysis using get_market_pricing_analysis. Costs 1 fixed credit.

   • Same filters for consistency
   • Returns average, median, price range, and distribution buckets

5. Present findings with:

   • Market leaders by revenue
   • Bestselling products
   • Pricing landscape (average price, price distribution)
   • Key insights and patterns

Tips

• Start with get_product_types to find the exact category before running market tools
• Use the same product_type and keyword filters across all calls for consistent data
• get_market_pricing_analysis is the cheapest call (1 fixed credit) — good starting point
• The overall_total_sales_revenue from get_market_top_companies gives market size context
• Compare end_date values to see trends over time