# TCGdex API API

> TCGdex API API on Apizie: 33 endpoints (fetch the list of cards, Finds Card by Global ID, GET /categories, GET /categories/{category}, …) returned as clean JSON through one API key. 33 endpoints are live now. Call it over REST at https://zieapi.vercel.app/v1/open-data:tcgdex/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

- Project key: `open-data:tcgdex`
- Category: Open Data
- Status: live
- Source: https://github.com/tcgdex/cards-database
- Page: https://zieapi.vercel.app/api/open-data/tcgdex
- OpenAPI: https://zieapi.vercel.app/api/open-data/tcgdex/openapi.json

A Multilanguage Pokémon TCG Database with Cards Pictures and most of the informations contained on the cards. You can find out more about TCGdex at [https://www.tcgdex.net](https://www.tcgdex.net) or on…

## Endpoints

### fetch the list of cards
`GET https://zieapi.vercel.app/v1/open-data:tcgdex/cards`

| Parameter | Type | Required | Description |
|---|---|---|---|
| lang | string | no | Part of the server address: https://api.tcgdex.net/v2/{lang} |

### Finds Card by Global ID
`GET https://zieapi.vercel.app/v1/open-data:tcgdex/find-pets-by-tags`

| Parameter | Type | Required | Description |
|---|---|---|---|
| lang | string | no | Part of the server address: https://api.tcgdex.net/v2/{lang} |
| cardId | string | yes | Tags to filter by |

### GET /categories
`GET https://zieapi.vercel.app/v1/open-data:tcgdex/get-categories`

| Parameter | Type | Required | Description |
|---|---|---|---|
| lang | string | no | Part of the server address: https://api.tcgdex.net/v2/{lang} |

### GET /categories/{category}
`GET https://zieapi.vercel.app/v1/open-data:tcgdex/get-categories-category`

| Parameter | Type | Required | Description |
|---|---|---|---|
| lang | string | no | Part of the server address: https://api.tcgdex.net/v2/{lang} |
| category | string | yes |  |

### GET /dex-ids
`GET https://zieapi.vercel.app/v1/open-data:tcgdex/get-dex-ids`

| Parameter | Type | Required | Description |
|---|---|---|---|
| lang | string | no | Part of the server address: https://api.tcgdex.net/v2/{lang} |

### GET /dex-ids/{dexId}
`GET https://zieapi.vercel.app/v1/open-data:tcgdex/get-dex-ids-dex-id`

| Parameter | Type | Required | Description |
|---|---|---|---|
| lang | string | no | Part of the server address: https://api.tcgdex.net/v2/{lang} |
| dexId | string | yes |  |

### GET /energy-types
`GET https://zieapi.vercel.app/v1/open-data:tcgdex/get-energy-types`

| Parameter | Type | Required | Description |
|---|---|---|---|
| lang | string | no | Part of the server address: https://api.tcgdex.net/v2/{lang} |

### GET /energy-types/{energy-type}
`GET https://zieapi.vercel.app/v1/open-data:tcgdex/get-energy-types-energy-type`

| Parameter | Type | Required | Description |
|---|---|---|---|
| lang | string | no | Part of the server address: https://api.tcgdex.net/v2/{lang} |
| energy-type | string | yes |  |

### GET /hp
`GET https://zieapi.vercel.app/v1/open-data:tcgdex/get-hp`

| Parameter | Type | Required | Description |
|---|---|---|---|
| lang | string | no | Part of the server address: https://api.tcgdex.net/v2/{lang} |

### GET /hp/{hp}
`GET https://zieapi.vercel.app/v1/open-data:tcgdex/get-hp-hp`

| Parameter | Type | Required | Description |
|---|---|---|---|
| lang | string | no | Part of the server address: https://api.tcgdex.net/v2/{lang} |
| hp | string | yes |  |

### GET /illustrators
`GET https://zieapi.vercel.app/v1/open-data:tcgdex/get-illustrators`

| Parameter | Type | Required | Description |
|---|---|---|---|
| lang | string | no | Part of the server address: https://api.tcgdex.net/v2/{lang} |

### GET /illustrators/{illustrator}
`GET https://zieapi.vercel.app/v1/open-data:tcgdex/get-illustrators-illustrator`

| Parameter | Type | Required | Description |
|---|---|---|---|
| lang | string | no | Part of the server address: https://api.tcgdex.net/v2/{lang} |
| illustrator | string | yes |  |

### GET /rarities
`GET https://zieapi.vercel.app/v1/open-data:tcgdex/get-rarities`

| Parameter | Type | Required | Description |
|---|---|---|---|
| lang | string | no | Part of the server address: https://api.tcgdex.net/v2/{lang} |

### GET /rarities/{rarity}
`GET https://zieapi.vercel.app/v1/open-data:tcgdex/get-rarities-rarity`

| Parameter | Type | Required | Description |
|---|---|---|---|
| lang | string | no | Part of the server address: https://api.tcgdex.net/v2/{lang} |
| rarity | string | yes |  |

### GET /regulation-marks
`GET https://zieapi.vercel.app/v1/open-data:tcgdex/get-regulation-marks`

| Parameter | Type | Required | Description |
|---|---|---|---|
| lang | string | no | Part of the server address: https://api.tcgdex.net/v2/{lang} |

### GET /regulation-marks/{regulation-mark}
`GET https://zieapi.vercel.app/v1/open-data:tcgdex/get-regulation-marks-regulation-mark`

| Parameter | Type | Required | Description |
|---|---|---|---|
| lang | string | no | Part of the server address: https://api.tcgdex.net/v2/{lang} |
| regulation-mark | string | yes |  |

### GET /retreats
`GET https://zieapi.vercel.app/v1/open-data:tcgdex/get-retreats`

| Parameter | Type | Required | Description |
|---|---|---|---|
| lang | string | no | Part of the server address: https://api.tcgdex.net/v2/{lang} |

### GET /retreats/{retreat}
`GET https://zieapi.vercel.app/v1/open-data:tcgdex/get-retreats-retreat`

| Parameter | Type | Required | Description |
|---|---|---|---|
| lang | string | no | Part of the server address: https://api.tcgdex.net/v2/{lang} |
| retreat | string | yes |  |

### GET /series
`GET https://zieapi.vercel.app/v1/open-data:tcgdex/get-series`

| Parameter | Type | Required | Description |
|---|---|---|---|
| lang | string | no | Part of the server address: https://api.tcgdex.net/v2/{lang} |

### GET /series/{serie}
`GET https://zieapi.vercel.app/v1/open-data:tcgdex/get-series-serie`

| Parameter | Type | Required | Description |
|---|---|---|---|
| lang | string | no | Part of the server address: https://api.tcgdex.net/v2/{lang} |
| serie | string | yes | the serie ID or name |

### GET /sets
`GET https://zieapi.vercel.app/v1/open-data:tcgdex/get-sets`

| Parameter | Type | Required | Description |
|---|---|---|---|
| lang | string | no | Part of the server address: https://api.tcgdex.net/v2/{lang} |

### GET /sets/{set}
`GET https://zieapi.vercel.app/v1/open-data:tcgdex/get-sets-set`

| Parameter | Type | Required | Description |
|---|---|---|---|
| lang | string | no | Part of the server address: https://api.tcgdex.net/v2/{lang} |
| set | string | yes | the set ID or the set name |

### GET /sets/{set}/{cardLocalId}
`GET https://zieapi.vercel.app/v1/open-data:tcgdex/get-sets-set-card-local-id`

| Parameter | Type | Required | Description |
|---|---|---|---|
| lang | string | no | Part of the server address: https://api.tcgdex.net/v2/{lang} |
| set | string | yes |  |
| cardLocalId | string | yes |  |

### GET /stages
`GET https://zieapi.vercel.app/v1/open-data:tcgdex/get-stages`

| Parameter | Type | Required | Description |
|---|---|---|---|
| lang | string | no | Part of the server address: https://api.tcgdex.net/v2/{lang} |

### GET /stages/{stage}
`GET https://zieapi.vercel.app/v1/open-data:tcgdex/get-stages-stage`

| Parameter | Type | Required | Description |
|---|---|---|---|
| lang | string | no | Part of the server address: https://api.tcgdex.net/v2/{lang} |
| stage | string | yes |  |

### GET /suffixes
`GET https://zieapi.vercel.app/v1/open-data:tcgdex/get-suffixes`

| Parameter | Type | Required | Description |
|---|---|---|---|
| lang | string | no | Part of the server address: https://api.tcgdex.net/v2/{lang} |

### GET /suffixes/{suffix}
`GET https://zieapi.vercel.app/v1/open-data:tcgdex/get-suffixes-suffix`

| Parameter | Type | Required | Description |
|---|---|---|---|
| lang | string | no | Part of the server address: https://api.tcgdex.net/v2/{lang} |
| suffix | string | yes |  |

### GET /trainer-types
`GET https://zieapi.vercel.app/v1/open-data:tcgdex/get-trainer-types`

| Parameter | Type | Required | Description |
|---|---|---|---|
| lang | string | no | Part of the server address: https://api.tcgdex.net/v2/{lang} |

### GET /trainer-types/{trainer-type}
`GET https://zieapi.vercel.app/v1/open-data:tcgdex/get-trainer-types-trainer-type`

| Parameter | Type | Required | Description |
|---|---|---|---|
| lang | string | no | Part of the server address: https://api.tcgdex.net/v2/{lang} |
| trainer-type | string | yes |  |

### GET /types
`GET https://zieapi.vercel.app/v1/open-data:tcgdex/get-types`

| Parameter | Type | Required | Description |
|---|---|---|---|
| lang | string | no | Part of the server address: https://api.tcgdex.net/v2/{lang} |

### GET /types/{type}
`GET https://zieapi.vercel.app/v1/open-data:tcgdex/get-types-type`

| Parameter | Type | Required | Description |
|---|---|---|---|
| lang | string | no | Part of the server address: https://api.tcgdex.net/v2/{lang} |
| type | string | yes |  |

### GET /variants
`GET https://zieapi.vercel.app/v1/open-data:tcgdex/get-variants`

| Parameter | Type | Required | Description |
|---|---|---|---|
| lang | string | no | Part of the server address: https://api.tcgdex.net/v2/{lang} |

### GET /variants/{variant}
`GET https://zieapi.vercel.app/v1/open-data:tcgdex/get-variants-variant`

| Parameter | Type | Required | Description |
|---|---|---|---|
| lang | string | no | Part of the server address: https://api.tcgdex.net/v2/{lang} |
| variant | string | yes |  |

## Example
```
curl "https://zieapi.vercel.app/v1/open-data:tcgdex/cards" \
  -H "x-api-key: $APIZIE_KEY"
```

## FAQ

### How do I call the TCGdex API API?
Create a free Apizie key, then send GET https://zieapi.vercel.app/v1/open-data:tcgdex/cards with the header x-api-key. Every endpoint returns { project, data, timestamp }.

### Is the TCGdex API API free on Apizie?
Yes. The Free plan includes 1,000 requests a month at 100 requests a minute, no credit card.

### Can AI agents use the TCGdex API API?
Yes. Add the Apizie MCP server (https://zieapi.vercel.app/mcp) to Claude, ChatGPT, Cursor or VS Code, then ask in plain language. The agent calls run_scraper with project key open-data:tcgdex.

### What is the status of the TCGdex API API?
Live: works with just an Apizie key