Usage open data
The usage statistics PokéKit compiles, offered as ready-to-use CSV and JSON. Use them for research, analysis or your own tools. Updated to the latest month around the 15th.
Downloads
- Champions VGC reg.MB2026-07 ・ 1,764,686 battlesCSVJSON
- Champions BSS reg.MB2026-07 ・ 97,966 battlesCSVJSON
- OU2026-07 ・ 654,262 battlesCSVJSON
- Doubles OU2026-07 ・ 211,990 battlesCSVJSON
- VGC 2026 reg.I2026-06 ・ 77,135 battlesCSVJSON
URLs follow this pattern, so you can fetch them programmatically.
https://poke.itlibra.com/opendata/usage-{format}.{csv|json}CSV columns
| Column | Meaning |
|---|---|
| rank | Usage rank (starts at 1) |
| pokemon_id | Pokémon Showdown ID; distinguishes forms uniquely |
| pokemon_name | Pokémon Showdown English name |
| dex_number | National Pokédex number |
| type1 / type2 | Types; type2 is empty for single-type Pokémon |
| category | normal / paradox / ub / sublegend / restricted / mythical |
| hp … spe | Base stats (HP, Attack, Defense, Sp. Atk, Sp. Def, Speed) |
| usage_pct | Usage share across the whole format (%) |
| top_abilities / top_items / top_moves / top_tera | Top entries joined as "id:%", separated by a vertical bar. These are shares among users of that Pokémon |
| top_teammates | Top 3 Pokémon most often used alongside it |
The JSON includes everything trimmed from the CSV (10 moves, 6 items, 4 abilities, 6 Tera types, 4 EV spreads, 8 teammates) plus the month, battle count and source.
Terms of use
- Free to use and redistribute. No request or notification needed, and commercial use is not restricted.
- Please credit both "Smogon / Pokémon Showdown" (source of the statistics) and "PokéKit" (compilation).
- The underlying data is Smogon's publicly posted aggregated usage statistics. Pokémon names and related copyrights belong to Nintendo, Creatures and Game Freak.
- Please do not put heavy load on the server. For apps with many users, fetch the file to your own server once and serve it from there.
How the data is built and updated
From the monthly Pokémon Showdown ladder statistics Smogon publishes (chaos format), the top 150 Pokémon of each format are extracted, and the usage shares of their moves, items, abilities, Tera types, EV spreads and teammates are trimmed to the leading entries. Only each format's rating cutoff is used. It refreshes automatically to the latest completed month around the 15th.
FAQ
What are the percentages relative to?
usage_pct is a share of the whole format. The percentages for moves, items, abilities, Tera types and teammates use a different denominator: they are shares among people who used that Pokémon. So a move at 80% means 80% of that Pokémon's users ran it.
Is historical data available?
Only the latest completed month is distributed. Monthly usage trends for the last 24 months are shown as charts on the site. If you need raw data for past months, read Smogon's per-month directories directly.