Competitor Intelligence

Identify competitors, track pricing dynamics, and generate differentiation strategies — at catalog scale.

Overview

The Competitor Intelligence module maps your product's competitive landscape automatically. Feed it a product, get back a ranked list of competitors with pricing, positioning, and actionable differentiation insights.

Throughput: Batch 10,000 products/hour | Real-time: ~800ms per query

Basic Usage

result = client.competitor.analyze(
    product_title="Sony WH-1000XM5 Wireless Headphones",
    market="amazon_us",
    depth="detailed"  # "quick" | "detailed" | "comprehensive"
)

for comp in result.competitors[:5]:
    print(f"{comp.name}: ${comp.price}")
    print(f"  Strengths: {comp.strengths}")
    print(f"  Weaknesses: {comp.weaknesses}")
    print(f"  Differentiation: {comp.differentiation_angle}")

Example Output

{
  "competitors": [
    {
      "name": "Bose QuietComfort Ultra",
      "price": 329.00,
      "market_share_est": "28%",
      "strengths": ["Superior comfort", "Bose brand loyalty", "CustomTune EQ"],
      "weaknesses": ["Heavier (250g vs 250g)", "No multipoint in QC mode"],
      "differentiation_angle": "Emphasize Sony's multipoint + lighter weight"
    },
    {
      "name": "Apple AirPods Max",
      "price": 449.00,
      "market_share_est": "18%",
      "strengths": ["Apple ecosystem lock-in", "Premium build quality"],
      "weaknesses": ["2x price point", "No USB-C (Lightning)", "Heavy"],
      "differentiation_angle": "Price-to-performance ratio, universal compatibility"
    }
  ],
  "market_summary": {
    "total_competitors": 23,
    "avg_price": 189.99,
    "price_range": [49.99, 549.00],
    "market_trend": "premiumization",
    "opportunity_gaps": ["$150-200 ANC with premium build", "Gaming-focused ANC"]
  },
  "recommended_strategy": "Position as best-in-class ANC at accessible premium price point..."
}

Batch Competitor Mapping

# Map competitors for entire catalog
competitor_map = client.competitor.batch_analyze(
    products=catalog_df.to_dict("records"),
    depth="quick",
    concurrency=30
)

# Export competitive landscape report
competitor_map.to_excel("competitive_landscape.xlsx")

Price Tracking

# Set up price monitoring (webhook-based)
tracker = client.competitor.track_prices(
    products=["B0BX2L8PBT", "B0CCZ26B6V"],
    market="amazon_us",
    frequency="daily",
    callback_url="https://your-app.com/webhooks/price-change"
)

On-Chain Price Oracle

# Publish verified price data on-chain (for DeFi/commerce protocols)
oracle = client.competitor.publish_price_oracle(
    product_id="B0BX2L8PBT",
    chain="arbitrum",
    update_frequency="hourly"
)
print(oracle.contract_address)  # Price feed contract