Skip to content

api-evangelist/pokeapi

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

PokéAPI (pokeapi)

PokéAPI (pokeapi.co) is a free, open-source RESTful and GraphQL API serving comprehensive Pokémon data — including Pokémon species, abilities, moves, items, types, locations, evolution chains, encounters, berries, contests, games, and machines. Built as an educational tool licensed under BSD-3-Clause, it is community-funded via Open Collective and GitHub Sponsors, requires no authentication, and is hosted with a fair-use policy encouraging clients to cache responses locally. The API powers tutorials, fan apps, machine-learning experiments, and game tooling worldwide and consistently serves one billion-plus requests per month.

URL: Visit APIs.json URL

Run: Capabilities Using Naftiko

Tags

  • Pokémon, Open Source, Open Data, REST, GraphQL, Gaming, Educational, Community

Timestamps

  • Created: 2026-05-30
  • Modified: 2026-05-30

APIs

PokéAPI REST API v2

The PokéAPI v2 REST API exposes the canonical Pokémon dataset across 12 resource families and roughly 60 endpoints — Pokémon, Pokémon Species, Abilities, Moves, Types, Items, Berries, Locations, Evolution Chains, Encounters, Games (Generations / Pokédex / Versions / Version Groups), Contests, Machines, and Utility (Languages). Every endpoint is GET-only, returns JSON, and is reachable under https://pokeapi.co/api/v2/ without authentication.

Human URL: https://pokeapi.co/docs/v2

Tags

  • Pokémon, REST, Open Data, Educational, Open Source

Properties

PokéAPI GraphQL API (Beta)

The PokéAPI GraphQL beta exposes the same Pokémon dataset as the REST API through a single endpoint with field-level selection, joins, and filtering.

Human URL: https://pokeapi.co/docs/graphql

Tags

  • Pokémon, GraphQL, Open Data, Beta

Properties

Common Properties

Features

Name Description
No Authentication All endpoints are publicly accessible without API keys, tokens, or signup.
REST and GraphQL Interfaces Choose REST under /api/v2 or GraphQL at beta.pokeapi.co/graphql/v1beta — same dataset, two access patterns.
Comprehensive Pokémon Dataset Roughly 60 endpoints covering Pokémon, species, moves, abilities, items, berries, types, locations, encounters, evolution chains, contests, games, and machines.
Multi-Generation Coverage Data spans every released generation of Pokémon games.
Multi-Language Localization Names, flavor text, and descriptions returned in multiple languages.
Cacheable Resources Resources are immutable game data — responses are highly cacheable.
Pokémon Sprites Library Companion PokeAPI/sprites repo provides every artwork, sprite, and shiny variant.
Static Data Dump PokeAPI/api-data publishes a static JSON snapshot for offline use.
Self-Hostable Docker image, Kubernetes manifests, and Firebase scripts let teams run a private mirror.
Open Source (BSD-3-Clause) Source code, sprites, GraphQL schema, and client wrappers are open source.

Use Cases

Name Description
Pokédex Apps Build mobile, web, or desktop Pokédex applications with species, abilities, moves, and sprites.
Team Builders and Battle Simulators Power competitive team-builder, damage-calculator, and battle-simulator tools.
Educational Coding Tutorials Widely used in tutorials teaching REST, GraphQL, caching, and pagination.
Machine Learning Datasets Train and benchmark recommendation, embedding, and image-classification models on Pokémon entities.
AI Assistant Demos Favorite first example for MCP servers, agent demos, and tool-use tutorials.
Fan Wikis and Trading Apps Provide reference data for fan-built wikis and card-collection trackers.

Integrations

Name Description
pokeapi-js-wrapper Browser-friendly async JavaScript wrapper with built-in cache.
pokedex-promise-v2 Node.js / TypeScript promise-based client.
pokebase Python 3 wrapper covering all v2 endpoints.
pokepy Alternative Python wrapper for PokéAPI.
pokekotlin Kotlin Multiplatform client for PokéAPI.
PokeAPI Sprites Companion repo of sprite images served alongside REST responses.
Static API Data Dump GitHub-hosted JSON snapshot for offline / build-time consumption.
Model Context Protocol Servers Numerous community MCP servers wrap PokéAPI as agent tools.

Tools

Name Description
pokeapi-mcp-server (npm) Community MCP server (Asthanaji05) exposing roughly 47 PokéAPI endpoints as MCP tools.
poke-mcp (NaveenBandarage) Reference MCP server connecting Claude Desktop, Continue, Cline via SSE.
poke-mcp (ChiragAgg5k) MCP server exposing stats, types, abilities, moves, and evolution chains.
pokedex-mcp (hollanddd) MCP server exposing Pokémon data, type-effectiveness charts, and encounter locations.
Pokemon-MCP-Server (Sachin-crypto) MCP server with list-popular-Pokémon and tournament-squad-builder tools.
pokemon-mcp-server (indroneelray) MCP server fetching Pokémon data via the official API.
poke-mcp (kaishin) Swift MCP wrapper around PokéAPI.
poke_api_mcp_rb (katakyo) Ruby MCP server built on mcp_rb for retrieving Pokémon information.

Artifacts

Machine-readable API specifications organized by format.

OpenAPI

  • PokéAPI OpenAPI — 60 GET operations across 11 tags covering Berries, Contests, Encounters, Evolution, Games, Items, Locations, Machines, Moves, Pokémon, and Utility.

JSON Schema

54 JSON Schema files covering every PokéAPI resource — Pokemon, PokemonSpecies, Ability, Move, Type, Berry, Item, Location, EvolutionChain, Generation, Nature, Stat, and more.

JSON Structure

54 JSON Structure (json-structure.org) files converted from JSON Schema.

JSON-LD

  • PokéAPI Context — Linked-data context aligning PokéAPI resources with schema.org.

Examples

54 example JSON files generated from JSON Schema definitions.

Capabilities

Naftiko capabilities organized as a shared per-API definition plus per-resource-family and cross-resource workflow capabilities.

Shared Per-API Definitions

  • PokéAPI REST API — 86 operations across 86 resources for the full v2 REST surface

Per-Resource-Family Capabilities

Capability Resource Family
Berries Berries, berry firmness, berry flavors
Contests Contest types, contest effects, super contest effects
Encounters Encounter methods, conditions, condition values
Evolution Evolution chains and triggers
Games Generations, Pokédexes, versions, version groups
Items Items, attributes, categories, fling effects, pockets
Locations Locations, location areas, Pal Park areas, regions
Machines TMs and HMs
Moves Moves, ailments, battle styles, categories, damage classes, learn methods, targets
Pokémon Pokémon, species, abilities, types, stats, natures, egg groups, growth rates, genders, characteristics
Utility Languages

Workflow Capabilities

Workflow APIs Combined Tools Persona
Pokémon Research PokéAPI v2 7 Game Developer, Educator, Hobbyist, AI Agent

Vocabulary

  • PokéAPI Vocabulary — Unified taxonomy mapping 17 resources, 2 actions, 4 workflows, and 5 personas across operational (OpenAPI) and capability (Naftiko) dimensions.

Rules

  • PokéAPI Spectral Rules — 28 rules across info, OpenAPI version, servers, paths, operations, parameters, responses, tags, and schemas enforcing PokéAPI conventions.

Maintainers

FN: Kin Lane

Email: kin@apievangelist.com

About

PokeAPI - comprehensive Pokémon REST + GraphQL API profile

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors