CardBase API

概要

CardBase API は、日本のポケモンカードゲームのカードデータを提供するREST APIです。

ベースURL：https://pokecaai.vercel.app/api/v1
レスポンス形式：application/json
認証：X-API-Key ヘッダー
テキストデータのみ提供（カード画像URLは含みません）
データ更新：新弾発売に合わせて順次追加

データ仕様

対応レギュレーション

H〜J

現在の環境

アビスアイ環境

カード種別

5種

データ形式

テキストのみ

最終更新：2026-05-27 ／新弾発売に合わせて順次追加

画像データについて

本APIはカードのテキスト情報のみを提供します。カード画像URLは著作権上の理由からレスポンスに含まれません。画像が必要な場合は公式サイトや各種パブリッシャーの素材をご利用ください。

カード種別（card_type）

ポケモンサポートグッズスタジアムエネルギー

レスポンスフィールド一覧

フィールド	型	説明
`id`	number	カードの一意ID
`regu`	string	レギュレーション（H / I / J）
`pack`	string	パック名（例：バトルパートナーズ）
`card_number`	string	パック内のカード番号
`card_type`	string	カード種別（ポケモン / サポート / グッズ / スタジアム / エネルギー）
`subtype`	string	サブタイプ（exなど）
`card_name`	string	カード名
`stage`	string	進化段階（基本 / 1進化 / 2進化）
`evolves_from`	string	進化前のカード名
`hp`	number	HP
`type1 / type2`	string	タイプ（炎・水・雷など）
`tera_type`	string	テラスタルタイプ
`ability_name`	string	特性名
`ability_effect`	string	特性テキスト
`move1〜3_cost`	string	技のコスト（例：炎炎無）
`move1〜3_name`	string	技名
`move1〜3_damage`	string	技のダメージ
`move1〜3_effect`	string	技のテキスト
`weakness`	string	弱点タイプ
`resistance`	string	抵抗力
`retreat`	number	にげるコスト
`tags`	string	タグ（例：ex・テラスタル、カンマ区切り）

認証

全エンドポイントにAPIキーが必要です。X-API-Key ヘッダーに含めてください。

curl -H "X-API-Key: pcg_xxxxxxxxxxxx" \
  https://pokecaai.vercel.app/api/v1/cards

注意：APIキーは秘密情報です。クライアントサイドのコードや公開リポジトリに含めないでください。

エラーレスポンス

HTTPステータス	意味
`401`	APIキーが無効または未設定
`403`	プランがこの操作を許可していない
`404`	リソースが見つからない
`429`	レートリミット超過
`500`	サーバーエラー

{ "error": "Daily rate limit exceeded (500 requests/day for free plan)." }

レスポンス例

GET /api/v1/cards のレスポンス例：

{
  "data": [
    {
      "id": 1410,
      "regu": "I",
      "pack": "SV9a",
      "card_number": "091/063",
      "card_type": "ポケモン",
      "card_name": "シロナのガブリアスex",
      "hp": 330,
      "type1": "闘",
      "move1_name": "スクリューダイブ",
      "move1_damage": "100",
      "move1_effect": "のぞむなら、自分の手札が6枚になるように、山札を引く。",
      "move2_name": "リューノバスター",
      "move2_damage": "260",
      "move2_effect": "このポケモンについているエネルギーを、すべてトラッシュする。"
    }
  ],
  "total": 4443,
  "limit": 20,
  "offset": 0,
  "has_more": true,
  "plan": "free",
  "requests_today": 3,
  "rate_limit": 500
}

エンドポイント

料金プラン

決済完了後、登録のメールアドレスにAPIキーが自動送付されます。

Free

無料

500リクエスト/日

20件/レスポンス

✓全エンドポイントへのアクセス
✓カード名・パック・カード種別での絞り込み
✓テキストデータのみ（画像URLは含まない）

無料でAPIキーを取得する

StandardMost Popular

¥2,000/月

10,000リクエスト/日

100件/レスポンス

✓Freeの全機能
✓全クエリパラメータ（HP・タイプ・特性など）
✓ページネーション上限拡大

Pro

¥10,000/月

無制限

500件/レスポンス

✓Standardの全機能
✓一括取得エンドポイント（/bulk/cards）
✓カードショップ・ツール開発向け

Freeプランはメールアドレスを入力するだけで即時発行できます。有料プランはStripeで安全に決済します。