Get Brand Visibility

Get brand visibility metrics for a specified date range.

Visibility Score (0-100): Composite score based on:

• Mention Frequency (40%): How often the brand is mentioned
• Position Quality (30%): How highly ranked in AI responses
• Engagement (20%): How often users interact with mentions
• Sentiment (10%): Overall sentiment of mentions

Trend Analysis: Compares current period to previous period of equal length to determine if visibility is growing, stable, or declining.

AI Source Breakdown: Metrics broken down by platform (ChatGPT, Claude, Gemini, etc.)

Daily Breakdown: Time-series data for each day in the requested period

Example Request:

GET /api/b2b/visibility/550e8400-e29b-41d4-a716-446655440000?start_date=2026-01-01&end_date=2026-01-31

Example Response:

{
    "brand_id": "550e8400-e29b-41d4-a716-446655440000",
    "brand_name": "OpenAI",
    "period": {
        "start": "2026-01-01",
        "end": "2026-01-31"
    },
    "visibility_score": {
        "mention_frequency": 75.5,
        "position_quality": 85.0,
        "engagement": 42.3,
        "sentiment": 78.9,
        "overall": 72.4
    },
    "trend": "growing",
    "trend_pct_change": 15.3,
    "by_ai_source": {
        "chatgpt": {
            "mention_count": 1250,
            "avg_position": 2.3,
            "engagement_rate": 0.42
        },
        "claude": {
            "mention_count": 980,
            "avg_position": 1.8,
            "engagement_rate": 0.45
        }
    },
    "industry_benchmark": {
        "avg_visibility_score": 50.0,
        "avg_mention_count": 100,
        "avg_engagement_rate": 0.25
    },
    "daily_breakdown": [
        {
            "date": "2026-01-01",
            "mentions": 45,
            "impressions": 60,
            "avg_position": 2.5,
            "engagement_rate": 0.40
        }
    ]
}

Requirements:

• Authentication required (B2B subscription)
• Date range must be valid (end_date >= start_date)
• Maximum date range: 365 days