Suggest Competitors

Get competitor suggestions from brand library for a given vertical.

Tech Spike Endpoint (Day 1 + Option C Enhancement)

This endpoint queries the pre-bootstrapped brand_library table (529+ brands, 36 verticals) and groups related products under their parent brands.

Grouping Logic (Option C):

• Parent brands are shown with their product lines grouped together
• Example: "OpenAI" groups "OpenAI Platform" as a child product
• "Salesforce" groups "Salesforce Marketing Cloud", "Sales Cloud", etc.
• Provides cleaner UX while maintaining product-level detail

Filtering Logic:

• Filters by vertical (exact match, case-sensitive)
• Excludes brands with "Low" confidence
• Sorts by tier (Leader → Challenger → Emerging) then by rank
• Groups child products under parent brands
• Limits to parent brand count (children don't count toward limit)

Example Request:

GET /api/v1/brand-library/suggest-competitors?vertical=AI%2FML%20Platforms&limit=10

Example Response:

{
  "vertical": "AI/ML Platforms",
  "count": 2,
  "total_brands": 3,
  "suggestions": [
    {
      "id": "...",
      "brand": "OpenAI",
      "tier": "Leader",
      "rank": 1,
      "is_parent": true,
      "products": [
        {
          "product_name": "Platform",
          "full_name": "OpenAI Platform",
          "subcategory": "LLM APIs",
          "tier": "Leader",
          "rank": 1
        }
      ]
    },
    ...
  ]
}

Args:

• vertical: Vertical name (e.g., "AI/ML Platforms", "Marketing Tech")
• limit: Maximum parent brands to return (0-50, default 15)

Returns:

• List of grouped brand suggestions with nested products

Status Codes:

• 200: Success (may return empty list if no brands found)
• 400: Invalid parameters (e.g., negative limit)