# TopSaaS.lol

> TopSaaS.lol is a community-driven SaaS & AI tool battle arena. Genuine software users, developers, and founders vote in head-to-head duels (e.g. ChatGPT vs Claude, Cursor vs Windsurf, Supabase vs Firebase) to generate an authentic global Elo leaderboard (TSL rating).

## Core Capabilities & Resources
- **Live Battle Arena**: Head-to-head software showdowns with real-time community vote percentages.
- **TSL Leaderboard**: Global Elo rating rankings (baseline 1500 Elo) updated live on every community vote.
- **Custom Battle Creation**: Launch any software competition for free by submitting two website URLs.
- **Dynamic Social Cards**: Real-time 1200x630 duel comparison cards for social sharing.

## Developer & Agent APIs
All endpoints return standard JSON and are CORS-enabled:

- `GET https://www.topsaas.lol/api/rankings`: Fetch the full TSL Leaderboard with rankings, Elo ratings, win rates, and streak data.
  - Optional Query Params: `category` (string, e.g. "AI Assistant", "AI Code Editor"), `search` (string)
- `GET https://www.topsaas.lol/api/battles`: Fetch all active software duels, vote counts, and current percentage splits.
  - Optional Query Params: `slug` (string, e.g. "chatgpt-vs-claude"), `category` (string)
- `GET https://www.topsaas.lol/api/activity`: Stream the latest live community voting events and Elo rating shifts.
- `POST https://www.topsaas.lol/api/create-battle`: Launch a custom software duel with two website URLs.
  - Body: `{"urlA": "https://...", "urlB": "https://...", "category": "..."}`
- `GET https://www.topsaas.lol/api/health`: System health, Upstash KV persistence status, and latency diagnostics.

## Top Software Matchups
- [ChatGPT vs Claude](https://www.topsaas.lol/battle/chatgpt-vs-claude): OpenAI conversational reasoning vs Anthropic frontier coding & analysis.
- [Cursor vs Windsurf](https://www.topsaas.lol/battle/cursor-vs-windsurf): Anysphere AI pair-programmer vs Codeium Cascade agentic IDE.
- [Supabase vs Firebase](https://www.topsaas.lol/battle/supabase-vs-firebase): Open-source Postgres backend platform vs Google Firebase app development suite.
- [Notion vs Linear](https://www.topsaas.lol/battle/notion-vs-linear): Connected workspace docs & notes vs high-performance engineering issue tracking.
- [Framer vs Webflow](https://www.topsaas.lol/battle/framer-vs-webflow): Designer-first visual site canvas vs production CMS visual web development.
- [Stripe vs Paddle](https://www.topsaas.lol/battle/stripe-vs-paddle): Global financial payments infrastructure vs Merchant of Record tax & checkout billing.
- [Perplexity vs Gemini](https://www.topsaas.lol/battle/perplexity-vs-gemini): Real-time conversational answer engine vs Google 2M context multimodal ecosystem.
- [Canva vs Adobe Express](https://www.topsaas.lol/battle/canva-vs-adobe-express): Visual communications design suite vs Adobe generative Firefly content creator.

## Full Documentation & Specifications
- [Full LLM Context](https://www.topsaas.lol/llms-full.txt): Comprehensive markdown documentation with Elo mathematics and full product data.
- [OpenAPI 3.0 Specification](https://www.topsaas.lol/.well-known/openapi.json): Machine-readable schema for autonomous AI agents and tool-calling models.