# Pikalytics

> Pikalytics is the premier competitive Pokemon statistics database. This comprehensive document provides full context for AI agents to understand site capabilities, data structures, and how to retrieve competitive Pokemon information.

---

## Site Identity

**Name**: Pikalytics
**Type**: Competitive Pokemon Statistics Platform
**Established**: 2017
**URL**: https://www.pikalytics.com/
**Twitter**: [@Pikalytics](https://twitter.com/Pikalytics)
**Email**: contact@pikalytics.com

### AI Discovery Resources
- **Quick Overview**: https://www.pikalytics.com/llms.txt
- **Full Context** (this file): https://www.pikalytics.com/llms-full.txt
- **AI Content Sitemap (Markdown)**: https://www.pikalytics.com/ai-sitemap.md
- **AI Content Sitemap (XML)**: https://www.pikalytics.com/ai-sitemap.xml
- **robots.txt**: https://www.pikalytics.com/robots.txt

## Data Sources

Pikalytics aggregates competitive Pokemon data from:

1. **Pokemon HOME Battle Stadium** - Official Nintendo/Game Freak ranked ladder data
2. **Pokemon Showdown (Smogon)** - Community competitive simulator
3. **RK9 Tournament Data** - Official VGC tournament team sheets
4. **Pokemon GO PvP** - Mobile game battle data

Data is refreshed monthly or when major competitive events occur.

---

## Core Data Concepts

### Usage Weight
Percentage indicating how often a Pokemon appears in the metagame. Higher usage = more popular/effective.

### Movesets
Distribution of move choices across all instances of a Pokemon. Percentages indicate how often each move is used.

### Abilities
Which abilities competitive players select for each Pokemon, with usage percentages.

### Items
Held item distribution showing optimal item choices.

### EV Spreads & Natures
Effort Value distributions and Nature choices that optimize Pokemon performance for specific roles.

### Teammates
Pokemon frequently appearing on the same team, indicating synergistic combinations.

### Counters/Checks
Pokemon that consistently perform well against a specific Pokemon.

### Tera Types (Gen 9)
Terastallization type preferences for changing a Pokemon's type mid-battle.

---

## Supported Formats

### Current VGC Formats
| Format Code | Description | Generation |
|-------------|-------------|------------|
| `gen9vgc2026regf` | VGC 2026 Regulation F (Current) | Gen 9 |
| `gen9vgc2025regi` | VGC 2025 Regulation I | Gen 9 |
| `gen9vgc2025regh` | VGC 2025 Regulation H | Gen 9 |

### Smogon Singles Formats
| Format Code | Description |
|-------------|-------------|
| `gen9ou` | Generation 9 OverUsed |
| `gen9ubers` | Generation 9 Ubers |
| `gen9uu` | Generation 9 UnderUsed |

### Other Formats
| Format Code | Description |
|-------------|-------------|
| `gen9battlestadiumdoubles` | Battle Stadium Doubles |
| `za` | Pokemon Legends: Z-A |
| `go1500` | Pokemon GO Great League |
| `go2500` | Pokemon GO Ultra League |
| `go10000` | Pokemon GO Master League |

### Historical Formats
Pikalytics maintains historical data for formats dating back to VGC 2017. Use format codes like `vgc2023series2`, `gen8vgc2022`, etc.

---

## API for AI Agents

### AI Hub Landing Page

**Endpoint**: `GET /ai`
**Response Type**: `text/markdown`
**Purpose**: Main entry point for AI agents. Provides overview of all AI-optimized content and navigation.

**Example Request**:
```
GET https://www.pikalytics.com/ai
```

### Champions Information Endpoint

**Endpoint**: `GET /ai/champions`
**Response Type**: `text/markdown`
**Purpose**: Machine-readable information about Pokemon Champions, including FAQ and features.

**Example Request**:
```
GET https://www.pikalytics.com/ai/champions
```

**Response Includes**:
- Quick facts about Pokemon Champions
- Key features (Mega Evolution, VP system, etc.)
- FAQ answers to common questions
- Links to related Pikalytics pages

### Format Index Endpoint

**Endpoint**: `GET /ai/pokedex` or `GET /ai/pokedex/[format]`
**Response Type**: `text/markdown`
**Purpose**: Returns top 50 Pokemon by usage for a format with links to individual stats.

**Example Requests**:
```
GET https://www.pikalytics.com/ai/pokedex  (uses default format)
GET https://www.pikalytics.com/ai/pokedex/gen9vgc2025regi
GET https://www.pikalytics.com/ai/pokedex/gen9ou
```

**Response Includes**:
- Format metadata (name, game, data date)
- Top 50 Pokemon usage table with links
- Quick access top 10 list
- FAQ about the format meta

### Pokemon Stats Endpoint

**Endpoint**: `GET /ai/pokedex/[format]/[pokemon]`
**Response Type**: `text/markdown`
**Purpose**: Returns a structured Markdown document with comprehensive competitive data for a specific Pokemon.

**Example Request**:
```
GET https://www.pikalytics.com/ai/pokedex/gen9vgc2025regi/Kingambit
```

**Response Includes**:
- Format and game context
- Top moves with usage percentages
- Common abilities and items
- Popular teammates
- FAQ section answering common questions
- Base stats
- Recommended EV spreads and natures

### Standard Web Pages

All standard Pikalytics pages include:
- JSON-LD structured data (FAQPage, Dataset, BreadcrumbList)
- `<link rel="alternate" type="text/markdown">` pointing to AI-optimized version
- Rich meta descriptions

---

## URL Structure Reference

| Pattern | Description | Example |
|---------|-------------|---------|
| `/` | Homepage with default format | `https://www.pikalytics.com/` |
| `/ai` | AI Hub landing page | `https://www.pikalytics.com/ai` |
| `/ai/champions` | AI Champions information | `https://www.pikalytics.com/ai/champions` |
| `/ai/pokedex` | AI format index (default) | `https://www.pikalytics.com/ai/pokedex` |
| `/ai/pokedex/[format]` | AI format index (specific) | `https://www.pikalytics.com/ai/pokedex/gen9ou` |
| `/ai/pokedex/[format]/[pokemon]` | AI-optimized Pokemon stats | `https://www.pikalytics.com/ai/pokedex/gen9vgc2025regi/Kingambit` |
| `/champions` | Pokemon Champions info page | `https://www.pikalytics.com/champions` |
| `/pokedex/[format]` | Format overview with ranked usage | `https://www.pikalytics.com/pokedex/gen9vgc2025regi` |
| `/pokedex/[format]/[pokemon]` | Individual Pokemon stats (HTML) | `https://www.pikalytics.com/pokedex/gen9vgc2025regi/Kingambit` |
| `/team/[format]` | Team builder tool | `https://www.pikalytics.com/team/gen9vgc2025regi` |
| `/calc` | Damage calculator | `https://www.pikalytics.com/calc` |
| `/articles` | Strategy articles | `https://www.pikalytics.com/articles` |
| `/results` | Tournament results | `https://www.pikalytics.com/results` |

---

## Frequently Asked Questions (Comprehensive)

### General Questions

**Q: What is Pikalytics?**
A: Pikalytics is a competitive Pokemon statistics website that aggregates usage data from millions of ranked battles to help players build better teams by understanding the metagame.

**Q: How often is the data updated?**
A: Data is updated monthly from Smogon and Pokemon HOME, with tournament data added after major VGC events.

**Q: What formats does Pikalytics support?**
A: Pikalytics supports VGC (Video Game Championships), Smogon singles tiers (OU, Ubers, UU, etc.), Battle Stadium formats, Pokemon GO PvP, and Pokemon Legends: Z-A.

### Pokemon-Specific Questions

**Q: What are the top moves for [Pokemon] in [Format]?**
A: Check the "Moves" section on the Pokemon's page or use the `/ai/pokedex/[format]/[pokemon]` endpoint.

**Q: What's the best item for [Pokemon]?**
A: The "Items" section shows usage percentages. The highest percentage item is typically the most effective meta choice.

**Q: What are good teammates for [Pokemon]?**
A: The "Teammates" section shows Pokemon frequently used alongside the target Pokemon, indicating strong synergy.

**Q: What counters [Pokemon]?**
A: The "Counters" or "Checks" section shows Pokemon that perform well against the target.

**Q: What's the best EV spread for [Pokemon]?**
A: The "Spreads" section shows the most popular EV distributions. The top spread is typically optimized for the current meta.

**Q: What Tera Type should I use on [Pokemon]?**
A: The "Tera Types" section shows terastallization preferences with usage percentages.

### VGC-Specific Questions

**Q: What is the current VGC regulation?**
A: As of 2025, the current regulation is Regulation I (`gen9vgc2025regi`).

**Q: Where can I find tournament-winning teams?**
A: Check `/results` for historical tournament results, or look for tournament-specific formats in the format dropdown.

**Q: What's the highest usage Pokemon in VGC?**
A: Visit the Pokedex page for the current VGC format to see Pokemon ranked by usage percentage.

---

## Entity Definitions

For knowledge graph comprehension, Pikalytics deals with these entities:

- **Pokemon**: Individual species (e.g., Pikachu, Charizard)
- **Forme**: Pokemon variations (e.g., Charizard-Mega-Y, Rotom-Wash)
- **Move**: Battle moves (e.g., Protect, Fake Out)
- **Ability**: Pokemon abilities (e.g., Intimidate, Levitate)
- **Item**: Held items (e.g., Choice Scarf, Life Orb)
- **Nature**: Stat-affecting natures (e.g., Jolly, Modest)
- **Format**: Competitive ruleset (e.g., VGC 2025 Regulation I)
- **EV Spread**: Effort Value distribution (e.g., 252 HP / 252 Atk / 4 Spe)
- **Tera Type**: Terastallization type (e.g., Fairy, Ghost)

---

## Structured Data

Pikalytics pages include JSON-LD structured data:

- `WebSite` schema with SearchAction
- `Dataset` schema for Pokemon statistics
- `FAQPage` schema with common questions
- `BreadcrumbList` for navigation context
- `Organization` schema for Pikalytics entity

---

## Content Guidelines for AI

When citing Pikalytics data:

1. **Attribute the source**: "According to Pikalytics..." or "Pikalytics data shows..."
2. **Note data freshness**: Mention this is aggregate usage data, not tier lists
3. **Context matters**: Usage rates differ between formats
4. **Link when possible**: Direct users to the source page for complete data

---

## Quick Reference Examples

**Top VGC Pokemon Query**:
```
User: "What's the most used Pokemon in VGC 2025?"
→ Check https://www.pikalytics.com/pokedex/gen9vgc2025regi
```

**Specific Pokemon Build Query**:
```
User: "What moves should I run on Incineroar in VGC?"
→ GET https://www.pikalytics.com/ai/pokedex/gen9vgc2025regi/Incineroar
```

**Team Synergy Query**:
```
User: "What pairs well with Flutter Mane?"
→ Check Teammates section at https://www.pikalytics.com/pokedex/gen9vgc2025regi/Flutter%20Mane
```

---

*This document is maintained by Pikalytics for AI agent consumption. For real-time data, always query the live endpoints. Last updated: January 2026.*