docs: add unique meta descriptions to all 44 pages and improve defaults

Mlaz-code · claude · Mlaz-code · commit afe02a18fff4 · 2026-03-16T07:11:10.000-04:00
Previously every page used the generic 37-char default "Real-time sports
betting odds API". Now each page has a unique 100-160 char description
via MDX frontmatter, and the layout default/OG description is expanded.

Co-Authored-By: Claude Opus 4.6 (1M context) &lt;noreply@anthropic.com&gt;
diff --git a/app/layout.tsx b/app/layout.tsx
@@ -13,7 +13,7 @@ export const metadata: Metadata = {
     default: 'SharpAPI Docs',
     template: '%s - SharpAPI Docs',
   },
-  description: 'Real-time sports betting odds API',
+  description: 'SharpAPI documentation — real-time sports betting odds API with +EV detection, arbitrage alerts, low-hold markets, and SSE streaming from 16+ sportsbooks.',
   icons: {
     icon: [
       { url: '/favicon.ico', sizes: 'any' },
@@ -23,7 +23,7 @@ export const metadata: Metadata = {
   },
   openGraph: {
     title: 'SharpAPI Documentation',
-    description: 'Real-time sports betting odds API',
+    description: 'SharpAPI documentation — real-time sports betting odds API with +EV detection, arbitrage alerts, low-hold markets, and SSE streaming from 16+ sportsbooks.',
   },
 }
 
diff --git a/content/api-reference/account-keys.mdx b/content/api-reference/account-keys.mdx
@@ -1,3 +1,7 @@
+---
+description: "SharpAPI API key management — create, list, rotate, and delete API keys. Manage multiple keys per account with granular permissions."
+---
+
 import { Callout, Tabs } from 'nextra/components'
 
 # API Key Management
diff --git a/content/api-reference/account-usage.mdx b/content/api-reference/account-usage.mdx
@@ -1,3 +1,7 @@
+---
+description: "GET /api/v1/account/usage — View API usage statistics including request counts, rate limit status, and active streaming connections."
+---
+
 import { Callout, Tabs } from 'nextra/components'
 
 # Usage Stats
diff --git a/content/api-reference/account.mdx b/content/api-reference/account.mdx
@@ -1,3 +1,7 @@
+---
+description: "GET /api/v1/account — Retrieve your account details, subscription tier, rate limits, and enabled features for your SharpAPI API key."
+---
+
 import { Callout, Tabs } from 'nextra/components'
 
 # Account Info
diff --git a/content/api-reference/deeplinks.mdx b/content/api-reference/deeplinks.mdx
@@ -1,3 +1,7 @@
+---
+description: "SharpAPI deep links API — generate sportsbook deep links from opportunity hash IDs for one-click bet placement on sportsbook websites."
+---
+
 import { Callout, Tabs } from 'nextra/components'
 
 # Deep Links
diff --git a/content/api-reference/events-by-id.mdx b/content/api-reference/events-by-id.mdx
@@ -1,3 +1,7 @@
+---
+description: "GET /api/v1/events/{eventId} — Get detailed information for a single event including available markets, teams, and event metadata."
+---
+
 import { Callout, Tabs } from 'nextra/components'
 
 # Event Details
diff --git a/content/api-reference/events-markets.mdx b/content/api-reference/events-markets.mdx
@@ -1,3 +1,7 @@
+---
+description: "GET /api/v1/events/{eventId}/markets — Get available market types for a specific event with sportsbook coverage counts per market."
+---
+
 import { Callout, Tabs } from 'nextra/components'
 
 # Event Markets
diff --git a/content/api-reference/events-odds.mdx b/content/api-reference/events-odds.mdx
@@ -1,3 +1,7 @@
+---
+description: "GET /api/v1/events/{eventId}/odds — Get all odds for a specific event with optional filtering by sportsbook and market type."
+---
+
 import { Callout, Tabs } from 'nextra/components'
 
 # Event Odds
diff --git a/content/api-reference/events.mdx b/content/api-reference/events.mdx
@@ -1,3 +1,7 @@
+---
+description: "GET /api/v1/events — List and search sporting events with filtering by sport, league, date, and live status. Includes pagination and search."
+---
+
 import { Callout, Tabs } from 'nextra/components'
 
 # Events
diff --git a/content/api-reference/gamestate.mdx b/content/api-reference/gamestate.mdx
@@ -1,3 +1,7 @@
+---
+description: "GET /api/v1/gamestate — Get live game scores, clocks, and periods aggregated across sportsbooks using max-score priority-fill merging."
+---
+
 import { Callout, Tabs } from 'nextra/components'
 
 # Game State
diff --git a/content/api-reference/health.mdx b/content/api-reference/health.mdx
@@ -1,3 +1,7 @@
+---
+description: "GET /api/v1/health — Check SharpAPI operational status including backend connectivity, data freshness, and service availability."
+---
+
 import { Callout, Tabs } from 'nextra/components'
 
 # Health Check
diff --git a/content/api-reference/leagues.mdx b/content/api-reference/leagues.mdx
@@ -1,3 +1,7 @@
+---
+description: "GET /api/v1/leagues — Get available leagues with sport filtering. Returns league identifiers, display names, and active event counts."
+---
+
 import { Callout, Tabs } from 'nextra/components'
 
 # Leagues
diff --git a/content/api-reference/markets.mdx b/content/api-reference/markets.mdx
@@ -1,3 +1,7 @@
+---
+description: "GET /api/v1/markets — Get available betting market types with their configurations and sport availability across all supported sportsbooks."
+---
+
 import { Callout, Tabs } from 'nextra/components'
 
 # Markets
diff --git a/content/api-reference/odds-batch.mdx b/content/api-reference/odds-batch.mdx
@@ -1,3 +1,7 @@
+---
+description: "POST /api/v1/odds/batch — Fetch odds for multiple events in a single request. Reduces latency and rate limit usage compared to individual calls."
+---
+
 import { Callout, Tabs } from 'nextra/components'
 
 # Batch Odds
diff --git a/content/api-reference/odds-best.mdx b/content/api-reference/odds-best.mdx
@@ -1,3 +1,7 @@
+---
+description: "GET /api/v1/odds/best — Get the best available odds for each selection across all sportsbooks with consensus odds and market hold calculations."
+---
+
 import { Callout, Tabs } from 'nextra/components'
 
 # Best Odds
diff --git a/content/api-reference/odds-comparison.mdx b/content/api-reference/odds-comparison.mdx
@@ -1,3 +1,7 @@
+---
+description: "GET /api/v1/odds/comparison — Compare odds for a specific event across sportsbooks, organized by market and selection with hold calculations."
+---
+
 import { Callout, Tabs } from 'nextra/components'
 
 # Odds Comparison
diff --git a/content/api-reference/odds-delta.mdx b/content/api-reference/odds-delta.mdx
@@ -1,3 +1,7 @@
+---
+description: "GET /api/v1/odds/delta — Get only odds that changed since a given timestamp. Ideal for polling clients that need incremental updates."
+---
+
 import { Callout, Tabs } from 'nextra/components'
 
 # Odds Delta
diff --git a/content/api-reference/odds.mdx b/content/api-reference/odds.mdx
@@ -1,3 +1,7 @@
+---
+description: "GET /api/v1/odds — Fetch a snapshot of current sportsbook odds with filtering by sport, league, sportsbook, market type, and live status."
+---
+
 import { Callout, Tabs } from 'nextra/components'
 
 # Odds Snapshot
diff --git a/content/api-reference/opportunities-arbitrage.mdx b/content/api-reference/opportunities-arbitrage.mdx
@@ -1,3 +1,7 @@
+---
+description: "GET /api/v1/opportunities/arbitrage — Find guaranteed-profit arbitrage opportunities across sportsbooks with optimal stake calculations."
+---
+
 import { Callout, Tabs } from 'nextra/components'
 
 # Arbitrage Opportunities
diff --git a/content/api-reference/opportunities-ev.mdx b/content/api-reference/opportunities-ev.mdx
@@ -1,3 +1,7 @@
+---
+description: "GET /api/v1/opportunities/ev — Find positive expected value (+EV) betting opportunities using Pinnacle sharp lines as the reference source."
+---
+
 import { Callout, Tabs } from 'nextra/components'
 
 # +EV Opportunities
diff --git a/content/api-reference/opportunities-low-hold.mdx b/content/api-reference/opportunities-low-hold.mdx
@@ -1,3 +1,7 @@
+---
+description: "GET /api/v1/opportunities/low_hold — Find markets with the lowest vig (hold) across sportsbooks for the tightest available lines."
+---
+
 import { Callout, Tabs } from 'nextra/components'
 
 # Low Hold Opportunities
diff --git a/content/api-reference/opportunities-middles-summary.mdx b/content/api-reference/opportunities-middles-summary.mdx
@@ -1,3 +1,7 @@
+---
+description: "GET /api/v1/opportunities/middles/summary — Get aggregate statistics for current middle opportunities without the full opportunity list."
+---
+
 import { Callout, Tabs } from 'nextra/components'
 
 # Middles Summary
diff --git a/content/api-reference/opportunities-middles.mdx b/content/api-reference/opportunities-middles.mdx
@@ -1,3 +1,7 @@
+---
+description: "GET /api/v1/opportunities/middles — Find middle opportunities where different sportsbook lines create a gap where both bets can win."
+---
+
 import { Callout, Tabs } from 'nextra/components'
 
 # Middles
diff --git a/content/api-reference/overview.mdx b/content/api-reference/overview.mdx
@@ -1,3 +1,7 @@
+---
+description: "Complete SharpAPI v1 REST API reference. Covers authentication, pagination, filtering, error handling, and conventions used across all endpoints."
+---
+
 import { Callout, Tabs } from 'nextra/components'
 
 # API Reference Overview
diff --git a/content/api-reference/splits.mdx b/content/api-reference/splits.mdx
@@ -1,3 +1,7 @@
+---
+description: "GET /api/v1/splits — Get public betting splits (handle % and bet %) from DraftKings and Circa Sports for sharp vs public analysis."
+---
+
 import { Callout, Tabs } from 'nextra/components'
 
 # Betting Splits
diff --git a/content/api-reference/sports.mdx b/content/api-reference/sports.mdx
@@ -1,3 +1,7 @@
+---
+description: "GET /api/v1/sports — Get all available sports with their leagues and event counts. Use for building sport and league navigation filters."
+---
+
 import { Callout, Tabs } from 'nextra/components'
 
 # Sports
diff --git a/content/api-reference/sportsbooks.mdx b/content/api-reference/sportsbooks.mdx
@@ -1,3 +1,7 @@
+---
+description: "GET /api/v1/sportsbooks — List available sportsbooks with current status, required subscription tier, and book-specific capabilities."
+---
+
 import { Callout, Tabs } from 'nextra/components'
 
 # Sportsbooks
diff --git a/content/api-reference/stream.mdx b/content/api-reference/stream.mdx
@@ -1,3 +1,7 @@
+---
+description: "GET /api/v1/stream — Real-time odds and opportunity updates via Server-Sent Events (SSE). Requires WebSocket add-on subscription."
+---
+
 import { Callout, Tabs } from 'nextra/components'
 
 # Unified Stream
diff --git a/content/api-reference/teams.mdx b/content/api-reference/teams.mdx
@@ -1,3 +1,7 @@
+---
+description: "GET /api/v1/teams — Look up teams and players across sports and leagues. Includes aliases, league memberships, and active event counts."
+---
+
 import { Callout, Tabs } from 'nextra/components'
 
 # Teams
diff --git a/content/api-reference/websocket.mdx b/content/api-reference/websocket.mdx
@@ -1,3 +1,7 @@
+---
+description: "WebSocket API at wss://ws.sharpapi.io — real-time bidirectional streaming for odds updates, +EV alerts, and arbitrage notifications."
+---
+
 import { Callout, Tabs } from 'nextra/components'
 
 # WebSocket Stream
diff --git a/content/authentication.mdx b/content/authentication.mdx
@@ -1,3 +1,7 @@
+---
+description: "Learn how to authenticate SharpAPI requests using API keys via headers, bearer tokens, or query parameters. Includes rate limits and error handling."
+---
+
 import { Callout, Tabs } from 'nextra/components'
 
 # Authentication
diff --git a/content/concepts/arbitrage.mdx b/content/concepts/arbitrage.mdx
@@ -1,3 +1,6 @@
+---
+description: "Understand how sports betting arbitrage works — the math behind guaranteed-profit arbs and how SharpAPI detects them across sportsbooks."
+---
 
 ## What is Arbitrage?
 
diff --git a/content/concepts/ev-calculation.mdx b/content/concepts/ev-calculation.mdx
@@ -1,3 +1,6 @@
+---
+description: "Learn how SharpAPI calculates expected value (+EV) using Pinnacle sharp lines. Covers fair probability, Kelly criterion, and edge calculation."
+---
 
 ## What is Expected Value?
 
diff --git a/content/concepts/event-matching.mdx b/content/concepts/event-matching.mdx
@@ -1,3 +1,6 @@
+---
+description: "How SharpAPI matches events across sportsbooks using canonical event IDs. Solves the problem of different sportsbook-specific event identifiers."
+---
 
 ## The Problem
 
diff --git a/content/concepts/odds-formats.mdx b/content/concepts/odds-formats.mdx
@@ -1,3 +1,6 @@
+---
+description: "Understand American, decimal, and implied probability odds formats. SharpAPI returns all three simultaneously for every odds entry."
+---
 
 ## Three Formats, One Concept
 
diff --git a/content/examples/arbitrage-scanner.mdx b/content/examples/arbitrage-scanner.mdx
@@ -1,3 +1,6 @@
+---
+description: "Build a real-time arbitrage scanner with SharpAPI SSE streaming. Includes stake calculations and multi-platform alert notifications."
+---
 
 ## Overview
 
diff --git a/content/examples/value-betting.mdx b/content/examples/value-betting.mdx
@@ -1,3 +1,6 @@
+---
+description: "Build a Discord or Telegram bot that alerts you to +EV betting opportunities in real-time using SharpAPI SSE streaming."
+---
 
 ## Overview
 
diff --git a/content/index.mdx b/content/index.mdx
@@ -1,3 +1,7 @@
+---
+description: "SharpAPI provides real-time sports betting odds from 16+ sportsbooks with +EV detection, arbitrage alerts, and SSE streaming via REST API."
+---
+
 import { Cards, Callout } from 'nextra/components'
 
 # Welcome to SharpAPI
diff --git a/content/pricing.mdx b/content/pricing.mdx
@@ -1,3 +1,7 @@
+---
+description: "Compare SharpAPI pricing tiers from Free to Enterprise. See rate limits, streaming access, sportsbook availability, and feature breakdown by plan."
+---
+
 import { Cards, Callout } from 'nextra/components'
 
 # Pricing
diff --git a/content/quickstart.mdx b/content/quickstart.mdx
@@ -1,3 +1,7 @@
+---
+description: "Get started with SharpAPI in 2 minutes. Make your first API call to fetch real-time odds with cURL, JavaScript, Python, or TypeScript examples."
+---
+
 import { Callout, Tabs, Steps } from 'nextra/components'
 
 # Quick Start
diff --git a/content/sdks/other-languages.mdx b/content/sdks/other-languages.mdx
@@ -1,3 +1,7 @@
+---
+description: "Generate SharpAPI client libraries for any language from our OpenAPI spec, or use the REST API directly with cURL and HTTP examples."
+---
+
 import { Callout, Tabs } from 'nextra/components'
 
 # Other Languages
diff --git a/content/sdks/python.mdx b/content/sdks/python.mdx
@@ -1,3 +1,7 @@
+---
+description: "Official SharpAPI Python SDK — install sharpapi for typed access with Pydantic models, SSE streaming, and full IDE autocomplete support."
+---
+
 import { Callout, Tabs } from 'nextra/components'
 
 # Python SDK
diff --git a/content/sdks/typescript.mdx b/content/sdks/typescript.mdx
@@ -1,3 +1,7 @@
+---
+description: "Official SharpAPI TypeScript SDK — install @sharp-api/client for typed access to all endpoints with SSE streaming and full IDE autocomplete."
+---
+
 import { Callout, Tabs } from 'nextra/components'
 
 # TypeScript SDK
diff --git a/content/streaming/overview.mdx b/content/streaming/overview.mdx
@@ -1,3 +1,7 @@
+---
+description: "Real-time sports odds streaming via SSE or WebSocket. Compare protocols, understand event types, and choose the right approach for your app."
+---
+
 import { Callout, Tabs } from 'nextra/components'
 
 # Streaming Overview
diff --git a/content/streaming/websocket.mdx b/content/streaming/websocket.mdx
@@ -1,3 +1,7 @@
+---
+description: "WebSocket streaming guide for SharpAPI — connect to wss://ws.sharpapi.io for real-time odds updates with bidirectional communication."
+---
+
 import { Callout, Tabs } from 'nextra/components'
 
 # WebSocket Streaming
