> ## Documentation Index > Fetch the complete documentation index at: https://hub.ypym.app/llms.txt > Use this file to discover all available pages before exploring further. # Search Visibility Index (SVI) & Competitive Share of Voice > How YPYM DBX aggregates organic SERP rankings into an authoritative executive score, measuring true market dominance, Share of Voice, and entity categorization. ## Executive Summary & Market Context Traditional rank-tracking tools inundate executive stakeholders with hundreds of fragmented keyword positions. Reviewing individual ranking rows fails to provide a cohesive answer to the most vital commercial question: **"Are we dominating our market landscape, or are competitors capturing organic search share?"** To solve this, **YPYM DBX v6.2.0** introduces the **Search Visibility Index (SVI)** and **Share of Voice (SoV %)** suite, anchored as **Tab 1 ("Brand, SV Index")** within the central domain tracking console. Instead of tracking keywords in isolation, DBX normalizes competitive search rankings across Page 1 and Page 2 into a single unified visibility score, segments competing domains into structured entity categories, and delivers real-time market share telemetry. ```mermaid theme={null} flowchart TD A["Tracked Target Keywords\n(Page 1 & Page 2 SERP)"] --> B["DataForSEO Scraping Engine\n(Live Advanced & Standard Queue)"] B --> C["SERP Position Extractor\n(Positions 1 to 20)"] C --> D["SVI Inverse-Rank Scoring Engine\nRank #1 = 20 pts ... Rank #20 = 1 pt"] D --> E["Domain Aggregation & Leaderboard"] E --> F["Share of Voice (SoV %)\nNormalized Market Share"] E --> G["Entity Classifier\nBrands, Aggregators, Media, Gov/Edu"] E --> H["Head-to-Head SERP Gap Auditor\nWin/Loss Rank Differential"] F --> I["DBX Executive Dashboard\n(Tab 1: Brand, SV Index)"] G --> I H --> I style A fill:#1A4BFF,stroke:#1A4BFF,color:#fff style B fill:#30FFFC,stroke:#1A4BFF,color:#000 style C fill:#1A4BFF,stroke:#1A4BFF,color:#fff style D fill:#30FFFC,stroke:#1A4BFF,color:#000 style E fill:#1A4BFF,stroke:#1A4BFF,color:#fff style F fill:#30FFFC,stroke:#1A4BFF,color:#000 style G fill:#30FFFC,stroke:#1A4BFF,color:#000 style H fill:#30FFFC,stroke:#1A4BFF,color:#000 style I fill:#1A4BFF,stroke:#1A4BFF,color:#fff ``` YPYM DBX Search Visibility Index architecture: Transforming raw multi-keyword SERP rankings into executive SVI points, competitive Share of Voice (SoV %), entity clustering, and automated threat analysis. *** ## 1. The Mathematical Scoring Model The **Search Visibility Index (SVI)** uses an inverse-linear positioning weight that reflects real-world search engine click-through behavior: higher rankings receive disproportionately greater visibility credit, while deep Page 2 rankings receive marginal representation. ### SVI Point Allocation Formula For any domain $d$ across a tracked keyword portfolio $Q$, the total SVI score is calculated as: $\text{SVI}_d = \sum_{q \in Q} w(r_{d, q})$ Where $r_{d, q}$ represents the organic rank position of domain $d$ for query $q$, and the point weighting function $w(r)$ is defined for ranks 1 through 20: $$ w(r) = \begin{cases} 21 - r & \text{for } 1 \le r \le 20 \\ 0 & \text{for } r > 20 \text{ or unranked} \end{cases} $$ | Ranking Tier | SERP Positions | Points Per Keyword | Commercial Significance | | :- | :- | :- | :- | | **Top 3 Dominance** | Rank #1, #2, #3 | **20, 19, 18 pts** | Captures over 55% of all organic clicks. Prime real estate. | | **Mid Page 1** | Rank #4 to #6 | **17, 16, 15 pts** | Strong consideration zone with notable organic traffic. | | **Lower Page 1** | Rank #7 to #10 | **14, 13, 12, 11 pts** | Defending first-page presence; vulnerable to competitive drops. | | **Page 2 Horizon** | Rank #11 to #20 | **10 to 1 pt** | Opportunity horizon for quick-win on-page optimization. | | **Unranked / >20** | Beyond Page 2 | **0 pts** | Zero organic visibility value in the active market landscape. | ### Share of Voice (SoV %) Formulation Share of Voice quantifies the relative visibility percentage commanded by a brand compared to the entire competitive domain universe across the tracked portfolio: $\text{SoV}_d = \left( \frac{\text{SVI}_d}{\sum_{k \in D} \text{SVI}_k} \right) \times 100\%$ Where $D$ is the set of all unique domains appearing anywhere within the Top 20 organic rankings for the target keyword set. *** ## 2. Automated Entity Classification & Heuristic Clustering In search engine results pages, not every ranking URL represents a direct business competitor. Commercial brands frequently compete against massive multi-category marketplaces, media news outlets, social networks, and regulatory portals. YPYM DBX incorporates an automated **Entity Classification Engine** that tags every ranking domain into one of seven distinct functional clusters: ```mermaid theme={null} pie title Entity Market Distribution by 7 Clusters "Commercial Brands (Direct & Indirect)" : 36 "Social Media Platforms" : 18 "E-Commerce & Marketplaces" : 16 "Directories & Aggregators" : 12 "Editorial Media & News" : 10 "Institutional, Gov & Edu" : 5 "Tech Providers & Utilities" : 3 ``` | Entity Category | System Identifier | Badge & Accent | Identification Rules | Example Domains | | :- | :- | :- | :- | :- | | **Commercial Brands** | `brand_peer` | Solid Blue (`#579CFE`) | Dedicated commercial products, B2B services, SaaS providers, and corporate direct-to-consumer portals. | `ypym.app`, `salesforce.com`, `hubspot.com` | | **Social Media Platforms** | `social_media` | Vibrant Pink (`#EC4899`) | Video networks, community platforms, professional networks, and social media channels. | `instagram.com`, `youtube.com`, `tiktok.com`, `linkedin.com`, `x.com`, `facebook.com` | | **E-Commerce & Marketplaces** | `marketplace` | Amber Gold (`#F59E0B`) | Multi-vendor commerce portals, consumer app stores, and digital goods distribution platforms. | `play.google.com`, `apps.apple.com`, `tokopedia.com`, `shopee.co.id`, `lazada.co.id`, `blibli.com` | | **Directories & Aggregators** | `aggregator` | Bright Orange (`#FB923C`) | Multi-source price comparators, job search aggregators, property listing directories, and booking engines. | `traveloka.com`, `tiket.com`, `cermati.com`, `rumah123.com`, `glints.com`, `jobstreet.co.id` | | **Editorial Media & News** | `media_news` | Royal Violet (`#8B5CF6`) | National/regional journalism publishers, business news dailies, tech blogs, and broadcast media portals. | `detik.com`, `kompas.com`, `bisnis.com`, `bisnisjogja.id`, `cnbcindonesia.com`, `tempo.co` | | **Institutional, Gov & Edu** | `gov_edu` | Emerald Green (`#10B981`) | Public sector services, ministry portals (`.go.id`, `.gov`), universities (`.ac.id`, `.edu`), and global bodies. | `kemendag.go.id`, `kemenkeu.go.id`, `ui.ac.id`, `ugm.ac.id`, `wikipedia.org`, `who.int` | | **Tech Providers & Utilities** | `tech_provider` | Slate Gray (`#64748B`) | Search engines, infrastructure utilities, cloud providers, code repositories, and link aggregators. | `google.com`, `bing.com`, `apple.com`, `microsoft.com`, `github.com`, `linktr.ee`, `cloudflare.com` | ### Zero-Friction Filtering The DBX console provides instant 0ms category chips (`All Entities`, `Brands Only`, `Social Media`, `Marketplaces`, `Aggregators`, `Media`, `Gov/Edu`, `Providers`) and an integrated competitor search filter, allowing teams to filter out noisy aggregators, news sites, and tech providers to analyze pure brand-to-brand market share in a single click. *** ## 3. Executive Intelligence Cards & Visual Layout The Tab 1 interface features four dedicated metric cards engineered for executive presentations and daily SEO operations: > **Search Visibility Index (SVI Total)** > > Styled in solid **YPYM DBX Brand Blue (`#579CFE`)** with high-contrast white typography. Features a live 30-day SVG gradient area sparkline visualizing visibility trajectory over time alongside Top 3 and Top 20 ranking counts. > **Share of Voice (SoV %)** > > Features a high-precision SVG circular progress meter displaying exact market percentage relative to all competitors, indicating whether the brand holds market leadership or challenger status. > **Entity Distribution Breakdown** > > A stacked proportional category bar displaying the exact percentage split across all 7 clusters (Commercial Brands, Social Media, Marketplaces, Aggregators, Editorial Media, Gov/Edu, and Tech Providers). > **Competitor Threat Radar** > > Real-time delta tracker highlighting the #1 market challenger, displaying the exact point differential and risk status (Defending Lead vs. Trailing). *** ## 4. Direct Head-to-Head SERP Gap Auditor Clicking the **"Compare"** action on any leaderboard row opens the **Head-to-Head SERP Gap Auditor** modal. ``` ┌────────────────────────────────────────────────────────────────────────┐ │ ⚖️ Head-to-Head SERP Gap Analysis │ │ tracked-brand.com vs competitor-domain.com │ ├────────────────────────────────────────────────────────────────────────┤ │ SVI Points: 284 pts │ SVI Points: 196 pts │ │ Lead: +88 pts (Ahead) │ Deficit: -88 pts │ ├────────────────────────────────────────────────────────────────────────┤ │ Keyword │ Your Rank │ Competitor Rank │ Rank Delta │ ├──────────────────────────┼─────────────┼─────────────────┼─────────────┤ │ enterprise erp software │ #1 (20 pts) │ #5 (16 pts) │ +4 (Lead) │ │ b2b procurement portal │ #3 (18 pts) │ #2 (19 pts) │ -1 (Deficit)│ │ supply chain automation │ #2 (19 pts) │ #8 (13 pts) │ +6 (Lead) │ │ inventory management saas│ #4 (17 pts) │ #1 (20 pts) │ -3 (Theft) │ └──────────────────────────┴─────────────┴─────────────────┴─────────────┘ ``` Head-to-Head SERP Gap Auditor: Side-by-side keyword rank comparisons between the tracked brand and an active competitor. ### Strategic Insights Extracted * **Ranking Dominance**: Keywords where your brand holds the higher position, generating stronger click share. * **SERP Theft Alerts**: Keywords where a competitor ranks higher, identifying immediate targets for content refreshing and internal linking. * **Mutual Ranking Coverage**: Identification of query clusters where both entities actively rank on Page 1. *** ## 5. Seamless Layout Architecture & Modular Design YPYM DBX v6.2.0 introduces two major design enhancements ensuring visual elegance and responsive performance: ### Flush Tab Container Merge The active **"Brand, SV Index"** tab is engineered with continuous visual flow directly into the executive dashboard container. By eliminating arbitrary margins and matching corner radiuses, the interface forms an unbroken white canvas mirroring modern luxury operating systems. ### Standalone Calibrated Action Toolbar The domain toolbar replaces grouped wrapper boxes with individual `w-8 h-8` white card icon buttons (Export CSV, Crawl Keywords, Fetch Volume, Domain Settings). Each button is calibrated to exactly 32px height, achieving mathematical parity with the primary `+ Add Keyword` action. *** ## 6. MCP & AI Connector Readiness The Search Visibility Index backend is engineered from the ground up to support external LLM reasoning and autonomous agent queries via the **Model Context Protocol (MCP)**: ```bash theme={null} # SVI Executive Telemetry Endpoint GET /api/domains/{slug}/search-visibility ``` ### Standardized JSON Response Schema ```json theme={null} { "domain": "ypym.app", "period": "30d", "svi": { "totalScore": 284, "top3Count": 12, "top20Count": 24, "shareOfVoice": 28.4 }, "topCompetitor": { "domain": "competitor.com", "score": 196, "pointGap": 88 }, "entityBreakdown": { "brand_peer": 36.0, "social_media": 18.0, "marketplace": 16.0, "aggregator": 12.0, "media_news": 10.0, "gov_edu": 5.0, "tech_provider": 3.0 }, "leaderboard": [ { "rank": 1, "domain": "ypym.app", "svi": 284, "sov": 28.4, "category": "brand_peer" }, { "rank": 2, "domain": "competitor.com", "svi": 196, "sov": 19.6, "category": "brand_peer" } ] } ``` This endpoint allows future **Claude MCP Tools**, **ChatGPT Custom Actions**, and **Gemini Enterprise Agents** to query competitive visibility with zero schema adaptations. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.