Scoring

Internal Service — This is not an HTTP endpoint. It’s called by the analyze-visibility orchestrator.

Purpose

Calculates visibility scores from raw platform results. Converts boolean arrays into percentages and overall scores.

Functions

calculate_platform_scores

def calculate_platform_scores(summary: dict) -> dict[str, int]

Converts summary counts to percentage scores per platform:

{
    "chatgpt": 75,   # 75% of prompts visible
    "claude": 50,
    "gemini": 80,
    # ...
}

calculate_overall_score

def calculate_overall_score(summary: dict, total_queries: int) -> tuple[int, int]

Returns (overall_score, total_visible):

overall_score: 0-100, weighted average across platforms
total_visible: Total number of (prompt, platform) pairs where visible

calculate_summary_stats

def calculate_summary_stats(results: list[dict]) -> dict

Aggregates results into counts per platform:

{
    "chatgpt": {"visible": 15, "total": 20},
    "claude": {"visible": 10, "total": 20},
    # ...
}

Score Formula

overall_score = (total_visible / (total_queries * 8)) * 100

Where 8 is the number of AI platforms tracked.

Code Location

src/app/apis/cron/analyze_visibility/scoring.py

Getting Started

Website

Onboarding

Cron

Your Current Setup

Explore

Settings - Toggle

Settings - Business

Settings - Team

Settings - Billing

Settings - Domain

Webhooks

Health

Manual Trigger

Purpose

Functions

calculate_platform_scores

calculate_overall_score

calculate_summary_stats

Score Formula

Code Location

​Purpose

​Functions

​calculate_platform_scores

​calculate_overall_score

​calculate_summary_stats

​Score Formula

​Code Location

Purpose

Functions

calculate_platform_scores

calculate_overall_score

calculate_summary_stats

Score Formula

Code Location