Pokékipe Public API
Gratis competitive Pokémon-analytics, udledt fra Smogons monthly usage stats og refreshed hver måned. Ingen konto nødvendig til casual brug; mint en personlig nøgle fra Account Settings for at hæve rate-limit-loftet til bulk pulls.
Endpoints
100+
Formater
30+
Refresh
Månedlig
Auth
Valgfri
Licens
CC BY 4.0
Hvorfor dette eksisterer
Hvad denne API er — og hvad den ikke er
Fire ting at vide før du skriver en eneste linje kode mod /api/v1/.
Hvad denne API er
En read-only JSON-overflade over verdens competitive Pokémon-data. Spørg "hvad er metaet i Gen 9 OU på 1500+ ELO denne måned?" eller "hvem counterede denne Pokémon i denne turnerings top cut?" og få et single-call-svar med stabile, dokumenterede shapes.
Hvor dataen kommer fra
Smogons monthly battle logs (den offentlige chaos JSON), officielle turnerings-feeds (Pokémon Company, VGC, Smogon Tour), og community-kilder som Limitless TCG til community-run events. Pokékipe kører sin egen ingestion-, normalization- og enrichment-pipeline ovenpå, og re-exposer derefter det rensede resultat.
Hvad denne API ikke er
Ikke en live Pokémon Showdown-bro, ikke en battle simulator, ikke et damage calculator-endpoint, ikke et teambuilding-engine. De tools lever på websitet. APIen er datalaget de står på.
Credit til kilden
Credit hvor credit er fortjent. Smogon, chaos-format JSON-exporterne, og community'et af spillere der spiller spillene hver måned — det er grunden til at dette dataset eksisterer. Pokékipe gør det interrogerbart; vi ejer ikke den underliggende data.
Kom i gang
Dit første kald — på 30 sekunder
Tre copy-paste-eksempler der henter format-kataloget. Ingen API-nøgle, ingen setup, ingen signup. Vælg dit sprog-tab, paste, kør.
curl -s https://pokekipe.com/api/v1/formats \
| jq '.[0:3]'Erstat pathen med et hvilket som helst endpoint listet i referencen nedenfor. Det første kald bør returnere på under et sekund på en warm cache.
Autentificering
Autentificering og rate limits
Anonyme kald fungerer til casual brug. En personlig nøgle (gratis, genereret fra dine kontoindstillinger) hæver rate-limit-loftet for analytikere og tool-buildere, der trækker data i bulk. Nøgler låser aldrig nye endpoints op; de hæver kun loftet.
Anonym, ingen nøgle
DefaultLav kald uden nogen header. Bucketten er keyed på din IP, så et lille script eller en LLM-agent der laver en håndfuld requests per session vil aldrig trippe limiten.
- Ingen konto, ingen signup, ingen header at sætte.
- Per-IP-bucket, egnet til ad-hoc-scripts og LLM-agent tool-use.
- Rammer en 429 hvis du sustainer bulk pulls; skift til en personlig nøgle.
per minut
60
per dag
5,000
Autentificeret, med en personlig nøgle
Anbefalet til bulkPass din nøgle som X-API-Key (eller Authorization: Bearer pk_live_…). Anonyme kald fortsætter med at virke ved siden af; nøglen hæver kun loftet, den låser ikke nye endpoints op.
- Per-bruger-bucket: dine IP-skift resetter ikke tælleren.
- Højere lofter på hver per-route-limit.
- Op til 5 aktive nøgler per konto, revokable når som helst.
per minut
600
per dag
100,000
Headers på hvert response
Hvert successful response bærer rate-limit-headers nedenfor, så din klient kan self-pace uden retries. Læs dem én gang per response og back off i det øjeblik Remaining rammer få requests, ikke nul.
| Header | Betydning |
|---|---|
| X-RateLimit-Tier | Hvilket tier du falder under: anonym (ingen nøgle) eller autentificeret (JWT eller API-nøgle resolved). |
| X-RateLimit-Limit-Min | Per-minut-loft for dit tier (60 anonymt, 600 autentificeret). |
| X-RateLimit-Limit-Day | Per-dag-loft for dit tier (5 000 anonymt, 100 000 autentificeret). |
| X-RateLimit-Remaining-Min | Kald tilbage i det nuværende minutvindue. Sæt farten ned når det nærmer sig nul. |
| X-RateLimit-Remaining-Day | Kald tilbage i det nuværende dagsvindue. Resetter på det samme wall-clock-minut hver dag. |
| Retry-After | Sendes kun på 429. Vent dette antal sekunder før retry, typisk under 60 for per-minut-vinduet. |
Fejl
Fejl du kan støde på
Standard HTTP-statuskoder. Body'en er altid JSON med et "detail"-felt, der beskriver hvad der gik galt. Behandl 4xx som et kontraktproblem (din request) og 5xx som vores problem (retry med backoff).
OK
OK. Body'en er JSON-payloaden dokumenteret i referencen. Tomme arrays betyder "ingen rows", ikke "manglende" — behandl dem som data, ikke som en fejl.
Not Modified
Not Modified. Cache-headers blev valideret. Brug den cachede body, ingen re-parse nødvendig. Returneres automatisk når du sender If-None-Match eller If-Modified-Since.
Bad Request
Bad Request. En query-parameter eller body-form er forkert. Detail-beskeden navngiver det præcise felt. Retry ikke uden at fixe inputtet.
Unauthorized
Unauthorized. Requesten krævede en API-nøgle eller session og fik ingen af delene, eller credentials var ugyldige/tilbagekaldte. Bliv ikke ved med at fyre — udsted credentialet igen.
Not Found
Not Found. Pathen eller ressourcen findes ikke. For per-Pokémon-routes betyder det ofte at formatet ikke har usage data endnu for den Pokémon, ikke en typo i dit kald.
Too Many Requests
Too Many Requests. Du ramte rate-limit-loftet. Læs Retry-After og vent — exponential backoff er god skik men sjældent nødvendig, da vinduet er kort.
Server Error
Internal Server Error. Noget eksploderede på vores side. Retry én gang efter et par sekunder; hvis det fortsætter, ping os på Discord med request-URL'en.
Service Unavailable
Service Unavailable. Vi deployer enten eller er midlertidigt overloadede. Retry med backoff. Status-updates postes på community Discord.
Grundregler
Brugsvilkår
Fire grundregler. Læs én gang, spar dit fremtidige jeg for et Discord-ping.
Credit til kilden
Attribution kræves ved redistribution eller republishing. Credit Pokékipe (link til https://pokekipe.com), og credit Smogon for den underliggende chaos JSON de publicerer hver måned.
Best-effort, ingen SLA
Best-effort, ingen SLA. Dataen serveres "as is" uden uptime-garanti. Cache aggressivt og degrader gracefully når et endpoint er langsomt eller returnerer en 429.
Versionering
Skemaer under /api/v1/ forbliver backwards-compatible inden for v1-lifecyclen. Breaking changes går til /api/v2/ med prior notice på Discord og en sunset-header på den deprecated path.
Commercial brug
Commercial brug er tilladt under CC BY 4.0. Hvis du bygger noget ovenpå denne API, vil vi rigtig gerne høre om det på community Discord.
Browse hvert endpoint — alt sammen ét sted
Browse hvert endpoint med beskrivelser, parameter-tabeller, request- og response-skemaer, og kodeeksempler i curl, JavaScript og Python. Søg hele API'en i én boks, deep-link til enhver operation, del URL'en.
- 100+ endpoints
- ·
- 3-pane navigation, content, samples
- ·
- fuldtekstsøgning
- ·
- live request samples