PokéAPI Scraper

Scrape PokéAPI — the complete open Pokémon dataset covering all 1,025 species across nine generations. Browse the whole Pokédex, pull a single generation or elemental type, or look up specific Pokémon by name or National Pokédex ID, and get types, abilities, the six base stats, height, weight, base experience, move counts, sprites and official artwork. Enable species enrichment for legendary/mythical status, habitat, egg groups, capture rate, and Pokédex flavour text. HTTP-only via the public pokeapi.co v2 API. No auth, no proxy.

What this actor does

• Five modes: browse, byType, byGeneration, byName, byId
• 18 elemental types and 9 generations exposed as dropdowns with Pokédex ranges (Gen 1 — Kanto #1–151 … Gen 9 — Paldea #906–1025)
• Full base stats: HP, Attack, Defense, Special Attack, Special Defense and Speed, as flat fields and as a baseStats object
• Optional species enrichment: includeSpecies adds legendary / mythical / baby flags, habitat, colour, shape, egg groups, capture rate, genus and description
• Empty fields are omitted

Output per Pokémon

• pokemonId — National Pokédex number
• name
• types — one or two elemental types
• abilities — ability names, including hidden abilities
• statHp, statAttack, statDefense, statSpecialAttack, statSpecialDefense, statSpeed
• baseStats — the same six values as a nested object
• height, heightDecimeters — height in decimetres
• weight, weightHectograms — weight in hectograms
• baseExperience — experience yield on defeat
• movesCount — number of learnable moves
• isDefault — false for alternate forms
• imageUrl — official artwork where available, otherwise the sprite
• artworkUrl, spriteUrl — high-resolution artwork and the classic game sprite
• speciesUrl — species endpoint for the Pokémon
• sourceUrl — Pokédex page on pokemon.com
• recordType: "pokemon", scrapedAt

With includeSpecies: true each record also carries:

• description — English Pokédex flavour text
• genus — species category, e.g. Mouse Pokémon
• generation — e.g. generation-i
• habitat, color, shape
• eggGroups — breeding groups
• captureRate, baseHappiness, growthRate
• isLegendary, isMythical, isBaby

Input

Field	Type	Default	Description
mode	string	byGeneration	browse / byType / byGeneration / byName / byId
pokemonType	string	–	Elemental type, e.g. fire, water, dragon (mode=byType)
generation	string	gen1	gen1 … gen9 (mode=byGeneration)
pokemonName	string	pikachu	Single Pokémon name (mode=byName)
pokemonNames	array	–	Multiple Pokémon names (mode=byName)
pokemonId	int	–	Single National Pokédex ID (mode=byId)
pokemonIds	array	–	Multiple Pokédex IDs (mode=byId)
includeSpecies	bool	false	Also fetch species data — doubles the number of requests
maxItems	int	50	Hard cap (1–1000)

Example: the original 151

{
  "mode": "byGeneration",
  "generation": "gen1",
  "maxItems": 151
}

Example: every Fire-type with species data

{
  "mode": "byType",
  "pokemonType": "fire",
  "includeSpecies": true,
  "maxItems": 100
}

Example: specific Pokémon by name

{
  "mode": "byName",
  "pokemonNames": ["pikachu", "charizard", "mewtwo"],
  "includeSpecies": true
}

Example: the full National Pokédex

{
  "mode": "browse",
  "maxItems": 1000
}

Use cases

• Fan sites & Pokédex apps — populate species pages with stats, types, abilities, and artwork
• Team builders — compute type coverage and stat spreads across a candidate roster
• Quiz & trivia games — generate questions from types, generations, and Pokédex entries
• Data science teaching — a clean, well-shaped public dataset for clustering and visualisation exercises
• Machine learning — labelled sprite and artwork sets with structured attributes
• Chatbots & assistants — ground Pokémon answers in canonical stats rather than model memory

FAQ

What is PokéAPI? A free, open, community-maintained REST API serving the full Pokémon dataset. See pokeapi.co.

Is this affiliated with PokéAPI, Nintendo, or The Pokémon Company? No. This is a third-party actor using a public community API.

Do I need an API key? No. The API is open. It asks callers to be considerate, so the actor paces requests and retries on 429.

What units are height and weight in? PokéAPI's native units: decimetres and hectograms. Divide by 10 for metres and kilograms — Pikachu's height: 4 is 0.4 m and weight: 60 is 6 kg.

What does includeSpecies cost me? One extra request per Pokémon, so roughly double the runtime. In exchange you get legendary/mythical flags, habitat, egg groups, capture rate, genus, and the Pokédex description.

Why do some entries have isDefault: false? Alternate forms — regional variants, Mega Evolutions, Gigantamax forms — are separate entries sharing a species. The default form is the one shown in the Pokédex.

Why does byGeneration sometimes return fewer than the generation's full count? maxItems caps the run, and the generation is walked from its first Pokédex number upward. Raise maxItems to the generation's size to get all of it.

Can I hotlink the artwork? Yes. artworkUrl and spriteUrl point at PokéAPI's public sprite repository and are served without referer checks.

Are moves included in full? Only movesCount. Full move lists with learn methods and levels are large and vary by game version; fetch them from the species endpoint if you need them.

How fresh is the data? The dataset is updated by PokéAPI's maintainers when new games ship. Each run queries it live.