Lista Dos Pokemons

Como montar uma lista funcional de Pokémon

Muita gente pede a lista dos pokemons completa e acha que é só copiar da Wikipedia. Não é bem assim. A questão é mais complicada quando você precisa usar esses dados de verdade, seja pra um site, um bot de troca, ou até um jogo de fã.

Eu comecei montando listas pra um projeto simples em Python. Achei que seria coisa de cinco minutos. Levei dois dias e tanto.

onde conseguir a lista dos pokemons correta

O dado cru fica no PokeAPI. É gratuito, não precisa de chave, e devolve JSON. Você faz uma requisição GET pra /pokemon?limit=1000 e joga tudo num arquivo. Simples.

Depois você percebe que o limite padrão é 20 por página. Tem que pagear até chegar em 1022. Gasta menos tempo que fazer manualmente, mas ainda sim é chato se você nunca fez isso antes.

O problema que ninguém avisa

A maior dor de cabeça não é pegar os dados. É a consistência. A Generation 9 (Pokémon Scarlet e Violet) introduziu formas regionais, formas alternadas, e a API nem sempre atualiza na mesma velocidade. Eu descobri isso na prática quando meu script de geração de tabelas começou a falhar com erro 404 em alguns IDs.

O workaround foi simples: em vez de confiar no ID numérico pra buscar a forma alternativa, use o campo "sprite" correto e filtre por forma_name dentro do JSON. Assim você não depende de endpoints que mudam entre updates.

Dicas que realmente funcionam

- Baixe tudo de uma vez. Não faça requisições individuais. Uma chamada com limit=1000 retorna o índice completo em segundos. - Salve os dados localmente e faça update incremental. Você economiza banda e não fica refém da API. - Use os campos "names" em vez de "name" pra exibição multilíngue. O campo name vem sempre em inglês. Se o seu público fala português, vai querer os nomes nas outras línguas. - A API tem rate limit não oficial. Se você fizer muitas requisições seguidas, pode levar ban temporário. Coloque um delay de 100ms entre chamadas e vai tranquilo.

O que eu mais vejo gente errando: confiar cegamente no número de espécies. A contagem oficial varia entre gerações. Em 2024, são 1025 formas distintas, mas algumas são compartilhadas entre formas alternativas do mesmo Pokémon. Se você quer unik IDs, tem que dar join por species_id, não por id mesmo.

Quando isso não funciona

Se você precisa de dados oficiais em tempo real pra algum produto comercial, o PokeAPI não é a melhor escolha. Ele é community-maintained e às vezes fica desatualizado. Nesse caso, o melhor caminho é o Pokémon TCG API ou consultar a base de dados do servidor oficial da Nintendo, que só libera acesso mediante acordo.

Outro ponto: a API não entrega sprites em alta resolução. Se você precisa de imagens bonitas pros cards, vai ter que buscar em outra fonte. Eu uso o Pokémon Showdown spritesheet cortado com Python e Pillow. Funciona, mas exige um script propio.

O arquivo pronto

Quem não quer perder tempo scriptando pode baixar um JSON já processado em github.com/fanzeyi/pokemon.json. O repositório atualiza a cada nova geração e inclui sprites, tipos, e stats básicos. É o mais usado pela comunidade indie.