# Pokemontcg (British Indian Ocean Territory) — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Search and retrieve detailed information about Pokémon Trading Card Game cards, including card stats, types, attacks, abilities, rarity, set information, images, and pricing data.

**Category:** Entertainment | **Website:** [pokemontcg.io/](https://pokemontcg.io/) | **Docs:** [parse.bot/marketplace/36baac71-58a7-4ae6-ab2e-e771e64ea8b9/pokemontcg-io-api](https://parse.bot/marketplace/36baac71-58a7-4ae6-ab2e-e771e64ea8b9/pokemontcg-io-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-pokemontcg-io-api-36baac71/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_card

Retrieve full card details by card ID. Returns complete metadata including name, HP, types, attacks, abilities, weaknesses, resistances, retreat cost, set info, artist, rarity, and flavor text. Card IDs use set-number format (e.g. 'base1-4', 'xy1-1'). Detailed pricing data available when the card has market data.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `card_id` | string | Yes | Card ID in set-number format (e.g. 'base1-4', 'xy1-1', 'mcd24-1', 'sv1-1') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-pokemontcg-io-api-36baac71/get_card \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"card_id":"<string>"}'
```

### search_cards

Full-text search over the Pokémon TCG card catalog by keyword. Returns paginated card summaries including name, set, price, and image. Server-side pagination with 20 results per page. Each card summary includes an id usable with get_card for full details.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number for pagination. |
| `page_size` | integer | No | Maximum number of results to return per page (up to 20). |
| `query` | string | Yes | Search keyword matching card names (e.g. 'charizard', 'pikachu', 'mewtwo') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-pokemontcg-io-api-36baac71/search_cards \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>","page_size":"<integer>","query":"<string>"}'
```