The PalDB API
Palworld's game data as JSON — the same extraction this site runs on, versioned and free to use. No key needed to start, and no signup to read.
curl https://paldb.gg/api/v1/pals/anubis/
Every response carries the game build it came from, so you can cache against it: gameVersion is 4570874460 today and changes only when Pocketpair ships an update and we re-ingest.
Endpoints
| Path | What it returns | Try |
|---|---|---|
| /api/v1/ | Index: every endpoint, the counts and the rate limits. | — |
| /api/v1/pals/ | Every Pal, summarised. | ?element=fire&limit=5 |
| /api/v1/pals/{idOrSlug}/ | One Pal in full — stats, work, drops, moves, spawn. | anubis |
| /api/v1/items/ | Every item, summarised. | ?q=ingot |
| /api/v1/items/{idOrSlug}/ | One item, with its recipe. | pal-metal-ingot |
| /api/v1/skills/{idOrSlug}/ | One active skill. | beam-comet |
| /api/v1/passives/{idOrSlug}/ | One passive skill. | legend |
| /api/v1/breeding/result/ | What two Pals produce. | ?a=Anubis&b=JetDragon |
| /api/v1/breeding/parents/ | Pairs that produce a given Pal. | ?child=Anubis |
| /api/v1/updates/latest/ | Field-level changes in the newest game build. | — |
Note the trailing slash. The whole site canonicalises to trailing slashes, and the API follows the same rule. A request without one gets a 308 to the slashed URL, which every normal HTTP client follows automatically — but you save a round trip by including it.
300 requests an hour with no key, counted by IP. 2,000 with a free key. Responses carry X-RateLimit-Limit and X-RateLimit-Remaining.
Everything is public and edge-cached for an hour. The data only changes when a game build is ingested, so caching on gameVersion is the right strategy — poll /api/v1/updates/latest/ rather than re-fetching everything.
Fields may be added to v1; they will not be removed or repurposed. Ids are the game’s own internal ids and are stable across builds. Anything breaking becomes /api/v2/.
Attribution — the whole licence
Use it in a bot, a fan site, a spreadsheet, a mod — commercial or not. All we ask is a visible credit with a link wherever the data appears:
Data from <a href="https://paldb.gg">PalDB.gg</a>
The data itself is Pocketpair’s; what we add is the extraction, the normalisation and the version history. paldb.gg is an unofficial fan site and is not affiliated with Pocketpair. If you are building something interesting, tell us and we will raise your limit.
Embeds
Three iframes for a sidebar, a wiki page or a clan site. No key, no script tag, and they carry no cookies — each one is public game data and a link home.
| Widget | iframe src | Suggested size |
|---|---|---|
| Pal card | /embed/pal/{slug}/ | 320 x 190 |
| Breeding result | /embed/breeding/?a=&b= | 420 x 120 |
| Latest patch | /embed/patch/ | 320 x 220 |
<iframe src="https://paldb.gg/embed/pal/anubis/" width="320" height="190"
style="border:0" loading="lazy" title="Anubis on PalDB"></iframe>Your keys
What is in it
288 Pals, 1,880 items, 330 active skills and 421 passives, extracted from Palworld’s own data tables rather than typed up from a wiki — how that works. The one thing the API does not carry is anything personal: a key reads public game data and nothing else, which is why it needs no scopes and no OAuth.
Extracted from Palworld's game files on (build 4570874460).Methodology