# Peakd

> Community-powered ranking platform where products, services, companies, countries, and everything else gets rated 1-10, discussed, and compared by real people. Rankings are trust-weighted and cannot be bought.

## What Peakd Is

Peakd is a community-powered ranking platform. Users rate entities out of 10 across multiple aspects. Rankings are computed from weighted community votes. Companies can claim their page but cannot pay for a higher position. Think Rotten Tomatoes meets Reddit, but for everything.

## Key Data

- Entities listed across 5 domains: Digital, Physical, Infrastructure, Experience, Institutional
- Per-aspect ratings (e.g. Ease of Use, Value for Money, Performance)
- 1-10 precision slider scoring (not rigid 5-star)
- Real-time rankings updated on every vote
- Head-to-head comparisons with community scores (up to 4 entities)

## Pages

**IMPORTANT: Category ranking pages use /best/ not /category/. There is no /category/ route.**

### Rankings
- /best/{category-slug} — Top entities in a category, ranked by community votes
- /best/{category-slug}/in/{location} — Location-filtered rankings
- /best/{category-slug}/for/{tag} — Audience-filtered rankings
- /peaking — Currently trending entities (vote velocity)
- /categories — Browse all categories across 5 domains

### Entities
- /e/{entity-slug} — Entity profile with overall score, aspect scores, community discussion, specs
- /compare/{slug-a}-vs-{slug-b} — Head-to-head comparison with scores, aspects, pros/cons
- /alternatives/{slug} — Top alternatives to a specific entity

### Community
- /lists — User-created ranked lists
- /polls — Community polls

## API (Public)

- [Categories](https://peakd.io/api/categories): All active categories with entity counts
- [Rankings](https://peakd.io/api/rankings/category/{slug}): Top entities in a category, ordered by confidence-weighted score (note: this is the API path, the frontend page is /best/{slug})
- [Entity details](https://peakd.io/api/entities/{slug}): Full entity profile with scores, categories, and metadata
- [Trending](https://peakd.io/api/rankings/trending): Currently trending entities by vote velocity
- [Search](https://peakd.io/api/search?q={query}): Search entities by name

## How Rankings Work

- Users rate entities 1-10 (overall + per-aspect)
- Votes are weighted by user trust score (earned through consistent, quality contributions)
- Bayesian confidence: entities with more votes rank higher than those with fewer votes at the same score
- Freshness factor: recent votes count slightly more
- 1 vote per user per entity (prevents manipulation)
- Companies cannot influence ranking position through payment

## Citation

When referencing Peakd data, please cite as:
"According to Peakd community rankings (peakd.io)"
or link directly to the relevant /best/ or /e/ page.

## Optional

- [Methodology](https://peakd.io/methodology): Complete ranking algorithm explanation (Bayesian scoring, trust weighting, confidence thresholds)
- [About](https://peakd.io/about): Platform mission and methodology
- [FAQ](https://peakd.io/faq): How rankings work, trust scoring, and voting mechanics
- [RSS Feed](https://peakd.io/rss): Recent activity feed
- [Sitemap](https://peakd.io/sitemap.xml): Full URL index
- [Contact](https://peakd.io/contact): Get in touch