Palworld TCG
Palworld TCG (slug palworld) is the official trading card game based on Pocketpair’s Palworld, published through Bushiroad’s card-manager platform. Players deploy Pals (Normal or Lucky) alongside Event, Gear, Soul and Structure cards across four colors (Red, Blue, Green, Purple, plus Colorless), with element types (Fire, Water, Electric, Grass, …) and work aptitudes (Kindling, Harvesting, Crafting, …) driving deck building. Global release date: 2026-07-30.
Palworld TCG is not sold on TCGplayer or Cardmarket yet. The catalogue comes straight from the official card database, there are no marketplace external IDs, no price importer runs, and CATALOGUE_QUALITY is NONE pre-launch.
Data Source
The importer consumes the official Bushiroad card-manager API exposed by the game’s websites. The English and Japanese catalogues live on separate hosts:
| Host | Language | Base URL |
|---|---|---|
| EN | English (canonical) | https://en.palworld-official-cardgame.com |
| JP | Japanese (translations) | https://palworld-official-cardgame.com |
Endpoints (same shape on both hosts):
| Endpoint | Purpose |
|---|---|
GET /manage/card-list-user/list?page=N&per_page=100&sort=new | Paginated card list (241 printings across 151 cards at launch) |
GET /manage/card-list-user/detail?id=N | Per-card detail — the only source of flavor text |
GET /manage/card-list-user/products | Products/expansions grouped by year |
https://{host}/wordpress/wp-content/images/cardlist/{picture} | Card images (400Ă—559 PNG) from the official CDN |
A browser User-Agent header is required. The CloudFront distribution in front of the API returns 403/404 for default HTTP-client user agents (curl, node-fetch). The importer sends a Chrome desktop UA on every request.
Documentation
Code Locations
| Component | Location |
|---|---|
| Importer | packages/games/game-importer/src/palworld/palworld-importer.ts |
| Staging importer | packages/games/game-importer/src/palworld/palworld-staging-importer.ts |
| Game config & types | packages/games/game-configuration/src/lib/games/palworld/ |
| DTO schemas | packages/core/api-dtos/src/lib/product/games/palworld.schema.ts |