HEADtoHEADSTATS
HomeAboutData Sources
Transparency

Where Our Data
Comes From

We believe in data transparency. Every stat on HeadToHeadStats has a source — here's exactly where it comes from, how often it updates, and what it's used for.

💤
Sleeper API
Fantasy Football Stats
Docs ↗
What We Get

Season-by-season fantasy scoring stats for all NFL skill position players (2020–2025). PPR, Half-PPR, and Standard scoring totals, games played, positional rankings, target share, rushing attempts, and receiving stats.

Used For
Fantasy Football HubDraft Planner player rankingsBreakout badge algorithmAI draft plan generationFantasy compare tab on NFL player comparisons
Refresh Rate
Player data refreshes every 24 hours. Season stats refresh every hour via Next.js ISR.

Sleeper provides a public API with no authentication required. Year labels follow NFL convention: 2025 = the season starting September 2025.

📺
ESPN / Internal Database
Career & Season Stats
What We Get

Career statistics for 18,000+ NFL, NBA, MLB, and NHL players stored in our Supabase database. Includes season-by-season breakdowns, career totals, and sport-specific stat categories (passer rating, batting average, save percentage, etc.).

Used For
Player comparison pagesSeason tabsAI analysis contextHead-to-head records
Refresh Rate
Player profiles update periodically. Historical stats are static once finalized after each season.

Our database is populated and maintained by our editorial team. Stats for retired players are historical and do not change. Active player stats are updated regularly during and after each season.

🏒
NHL Stats API
NHL Game Logs & Career Stats
Docs ↗
What We Get

Official NHL statistics including game logs, career totals, goals, assists, plus/minus, penalty minutes, goalie stats (GAA, save percentage, shutouts), and team standings.

Used For
NHL player profilesNHL comparison pagesSeason-by-season NHL stats tabs
Refresh Rate
Game logs update in near-real-time during the season. Season stats cache for 1 hour.

The NHL's public stats API provides authoritative data directly from the league. No API key required.

🤖
Anthropic Claude AI
AI-Powered Analysis
Docs ↗
What We Get

We use Claude (claude-sonnet-4-6) to generate head-to-head analysis, draft strategy recommendations, and fantasy breakout player analysis. All AI content is clearly labeled.

Used For
Head-to-head comparison verdictsFantasy draft plan generation2026 breakout player analysisFantasy start/sit analysis
Refresh Rate
AI analysis is generated on-demand and cached in our database (typically 1 hour for draft plans, up to 7 days for breakout analysis). Admin can force-regenerate any analysis.

AI-generated content represents an algorithmic assessment based on statistical data. It is not human sports journalism and should be treated as a data-driven starting point, not a final verdict.

🗄️
Supabase
Our Own Database
Docs ↗
What We Get

We host our own PostgreSQL database (via Supabase) storing all player profiles, career stats, awards, head-to-head matchup records, user votes, comments, trending comparisons, and articles.

Used For
All player dataHead-to-head game recordsCommunity votesArticlesAI analysis cacheAdmin panel
Refresh Rate
Real-time for user interactions (votes, comments). Player stats update on our editorial schedule.

Our database is the source of truth for all career statistics displayed on the site. Head-to-head game records are sourced from official league data and cross-referenced for accuracy.

📢
Google AdSense
Advertising
Docs ↗
What We Get

We use Google AdSense to display advertisements that help fund the site. AdSense may set cookies to serve relevant ads based on your browsing behavior.

Used For
Displaying ads across the site
Refresh Rate
N/A

See our Privacy Policy for details on how AdSense data is handled. You can opt out of personalized ads via Google's Ad Settings.

Data Accuracy Disclaimer

We make every effort to ensure statistical accuracy across all sports and players. However, data sources occasionally differ on edge cases — mid-season trades, retroactive stat corrections, or discrepancies between official league records and third-party aggregators.

If you identify a stat that appears incorrect, please contact us at [email protected] with the player name, stat in question, and the correct value with a source. We review and correct errors promptly.

AI-generated analysis is based on the statistics in our database at the time of generation. It reflects a data-driven perspective and does not constitute professional sports analysis or gambling advice.

← About UsPrivacy Policy →