### Get Pokemon Cards (Curl)

Source: https://www.pokemonpricetracker.com/docs/index

Retrieves Pokemon card data using the Pokemon Price Tracker API. This example demonstrates a GET request with query parameters for filtering and sorting card information.

```curl
curl -X GET "https://www.pokemonpricetracker.com/api/v2/cards?language=english&tcgPlayerId=233294&limit=50&offset=0" \
     -H "accept: */*" \
     -H "Authorization: Bearer YOUR_API_KEY"
```

--------------------------------

### Retrieve Pokemon Cards with Filters (Shell/Curl)

Source: https://www.pokemonpricetracker.com/docs/index

This example demonstrates how to retrieve Pokemon card data using the API's GET /cards endpoint with various query parameters for filtering, sorting, and data inclusion. It requires an API key for authorization and specifies parameters like language, set, search terms, price range, and historical data inclusion.

```shell
curl 'https://www.pokemonpricetracker.com/api/v2/cards?language=english&tcgPlayerId=233294&cardId=&setId=black-and-white-promos&set=base%20set&setName=&search=charizard%20base%20set%20holo&rarity=Holo%20Rare&cardType=Pokemon&artist=&minPrice=0&maxPrice=0&printing=1st%20Edition&condition=Near%20Mint&includeHistory=false&includeEbay=false&includeBoth=false&days=30&maxDataPoints=365&fetchAllInSet=false&sortBy=cardNumber&sortOrder=desc&limit=50&offset=0' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'
```

--------------------------------

### Get Pokemon Cards (JavaScript)

Source: https://www.pokemonpricetracker.com/docs/index

Fetches Pokemon card data using the Pokemon Price Tracker API with JavaScript. This snippet shows how to make a GET request and handle the response, including setting up authentication.

```javascript
const apiKey = "YOUR_API_KEY";
const apiUrl = "https://www.pokemonpricetracker.com/api/v2/cards";

fetch(apiUrl, {
  method: "GET",
  headers: {
    "Authorization": `Bearer ${apiKey}`,
    "Accept": "*/*"
  },
  params: {
    language: "english",
    tcgPlayerId: 233294,
    limit: 50,
    offset: 0
  }
})
.then(response => response.json())
.then(data => console.log(data))
.catch(error => console.error("Error fetching data:", error));
```

--------------------------------

### GET /cards

Source: https://www.pokemonpricetracker.com/docs/index

Retrieve Pokemon card data and pricing information. Supports multi-word search queries for specific cards.

```APIDOC
## GET /cards

### Description
Retrieve Pokemon card data and pricing information. Supports multi-word search queries for specific cards.

### Method
GET

### Endpoint
`/api/v2/cards`

### Query Parameters
- **search** (string) - Required - The search query for the card. Supports natural language queries (e.g., `charizard base set`, `pikachu 4/102`, `umbreon ex unseen forces`).
- **include_history** (boolean) - Optional - Whether to include price history data. Adds 1 credit per card.
- **include_ebay** (boolean) - Optional - Whether to include eBay graded card sales data. Adds 1 credit per card.

### Request Example
```json
{
  "search": "charizard base set",
  "include_history": true,
  "include_ebay": true
}
```

### Response
#### Success Response (200)
- **cards** (array) - An array of card objects, each containing pricing and historical data.
  - **card_id** (string) - Unique identifier for the card.
  - **name** (string) - The name of the Pokemon card.
  - **set** (string) - The set the card belongs to.
  - **rarity** (string) - The rarity of the card.
  - **price_data** (object) - Contains current and historical pricing information.
  - **ebay_data** (object) - Contains graded card sales data from eBay (if `include_ebay` is true).

#### Response Example
```json
{
  "cards": [
    {
      "card_id": "12345",
      "name": "Charizard",
      "set": "Base Set",
      "rarity": "Holo Rare",
      "price_data": {
        "current_price_tcgplayer": 150.00,
        "history": [
          {"date": "2023-01-01", "price": 140.00},
          {"date": "2023-01-02", "price": 145.00}
        ]
      },
      "ebay_data": {
        "psa_10_sales": [
          {"date": "2023-01-01", "price": 200.00}
        ]
      }
    }
  ]
}
```
```

--------------------------------

### GET /api/v2/cards

Source: https://www.pokemonpricetracker.com/docs/index

Retrieve Pokemon cards with filtering, sorting, and optional historical/eBay data. The credit cost is calculated based on the number of cards returned and whether history or eBay data is included.

```APIDOC
## GET /api/v2/cards

### Description
Retrieve Pokemon cards with filtering, sorting, and optional historical/eBay data. The credit cost is calculated based on the number of cards returned and whether history or eBay data is included.

**Credit Cost Formula:** `cards_returned × (1 + includeHistory + includeEbay)`

**Response Limits:**
  * Standard: 200 cards max
  * With history: 100 cards max
  * With eBay data: 50 cards max
  * With both history AND eBay: 50 cards max

### Method
GET

### Endpoint
/api/v2/cards

### Parameters
#### Query Parameters
- **language** (string, enum) - Optional - Defaults to "english". Card language database to query. Options: "english", "japanese".
- **tcgPlayerId** (string) - Optional - Get specific card by TCGPlayer ID. Returns single card object instead of array.
- **cardId** (string) - Optional - Alias for tcgPlayerId. Get specific card by TCGPlayer ID.
- **setId** (string) - Optional - Filter by set ID. Accepts: tcgPlayerId slug (e.g., "black-and-white-promos"), numeric TCGPlayer GroupId (e.g., "1407"), or MongoDB ObjectId.
- **set** (string) - Optional - Search sets by name (partial match).
- **setName** (string) - Optional, deprecated - Legacy parameter for set name filter. Use "set" instead.
- **search** (string) - Optional - Multi-word search across name, setName, cardNumber, rarity, cardType. Supports "X/Y" card number format.
- **rarity** (string) - Optional - Filter by rarity.
- **cardType** (string, enum) - Optional - Filter by card type. Options: "Pokemon", "Trainer", "Energy".
- **artist** (string) - Optional - Filter by card artist.
- **minPrice** (number) - Optional - Minimum market price filter (USD). Minimum value: 0.
- **maxPrice** (number) - Optional - Maximum market price filter (USD). Minimum value: 0.
- **printing** (string) - Optional - Filter by printing variant (e.g., "1st Edition", "Unlimited", "Holofoil", "Reverse Holofoil", "Normal").
- **condition** (string) - Optional - Filter by condition (e.g., "Near Mint", "Lightly Played", "Moderately Played", "Heavily Played", "Damaged").
- **includeHistory** (boolean) - Optional - Defaults to `false`. Include price history data (+1 credit per card). Free plan limited to 3 days.
- **includeEbay** (boolean) - Optional - Defaults to `false`. Include eBay graded card sales data (PSA, CGC, BGS, SGC, etc.). +1 credit per card. Limits response to 50 cards max.
- **includeBoth** (boolean) - Optional - Defaults to `false`. Shorthand for includeHistory=true and includeEbay=true.
- **days** (integer) - Optional - Defaults to 30. Days of historical data to return. Minimum value: 1, Maximum value: 365. Free plan limited to 3 days.
- **maxDataPoints** (integer) - Optional - Defaults to 365. Maximum data points per condition in price history. Higher values (>365) cost +1 credit per card. Plan limits: Free (30), Pro (730), Business (1000). Minimum value: 1, Maximum value: 1000.
- **fetchAllInSet** (boolean) - Optional - Defaults to `false`. Fetch all cards in set (requires set filter). Increases limit to 200.
- **sortBy** (string, enum) - Optional - Defaults to "cardNumber". Sort field. Options: "name", "cardNumber", "price".
- **sortOrder** (string, enum) - Optional - Defaults to "desc". Sort direction. Options: "asc", "desc".
- **limit** (integer) - Optional - Defaults to 50. Maximum results per page. Minimum value: 1, Maximum value: 200.
- **offset** (integer) - Optional - Defaults to 0. Number of results to skip for pagination. Minimum value: 0.

### Request Example
```json
{
  "language": "english",
  "tcgPlayerId": "233294",
  "cardId": "",
  "setId": "black-and-white-promos",
  "set": "base set",
  "setName": "",
  "search": "charizard base set holo",
  "rarity": "Holo Rare",
  "cardType": "Pokemon",
  "artist": "",
  "minPrice": 0,
  "maxPrice": 0,
  "printing": "1st Edition",
  "condition": "Near Mint",
  "includeHistory": false,
  "includeEbay": false,
  "includeBoth": false,
  "days": 30,
  "maxDataPoints": 365,
  "fetchAllInSet": false,
  "sortBy": "cardNumber",
  "sortOrder": "desc",
  "limit": 50,
  "offset": 0
}
```

### Response
#### Success Response (200)
- **data** (object) - Array of Pokemon card objects.
  - **id** (string) - Unique identifier for the card.
  - **tcgPlayerId** (string) - TCGPlayer ID of the card.
  - **name** (string) - Name of the card.
  - **setName** (string) - Name of the set the card belongs to.
  - **cardNumber** (string) - Card number within its set.
  - **totalSetNumber** (string) - Total number of cards in the set.
  - **rarity** (string) - Rarity of the card.
  - **cardType** (string) - Type of the card (e.g., Pokemon, Trainer, Energy).
  - **pokemonType** (string) - Pokemon's elemental type.
  - **energyType** (array of strings) - Energy types required to play the card.
  - **hp** (integer) - Hit Points of the Pokemon.
  - **stage** (string) - Evolution stage of the Pokemon.
  - **flavorText** (string) - Flavor text associated with the card.

#### Response Example
```json
{
  "data": [
    {
      "id": "507f1f77bcf86cd799439011",
      "tcgPlayerId": "233294",
      "name": "Charizard",
      "setName": "Base Set",
      "cardNumber": "4",
      "totalSetNumber": "102",
      "rarity": "Holo Rare",
      "cardType": "Pokemon",
      "pokemonType": "Fire",
      "energyType": [
        "Fire",
        "Colorless"
      ],
      "hp": 120,
      "stage": "Stage 2",
      "flavorText": "Spits fire that is hot enough to melt boulders. Known to cause forest fires unintentionally."
    }
  ]
}
```

#### Error Responses
- **400** Bad request - missing required filter or invalid parameters.
- **401** Unauthorized - invalid or missing API key.
- **429** Rate limit exceeded.
- **500** Server error.
```

--------------------------------

### GET /cards

Source: https://www.pokemonpricetracker.com/docs/index

Retrieves a list of Pokemon cards with various filtering and sorting options. This endpoint allows users to search for specific cards based on criteria such as language, TCGPlayer ID, card ID, set, rarity, artist, price range, printing, condition, and more.

```APIDOC
## GET /cards

### Description
Retrieves a list of Pokemon cards with various filtering and sorting options. This endpoint allows users to search for specific cards based on criteria such as language, TCGPlayer ID, card ID, set, rarity, artist, price range, printing, condition, and more.

### Method
GET

### Endpoint
https://www.pokemonpricetracker.com/api/v2/cards

### Parameters
#### Query Parameters
- **language** (string) - Optional - Filters cards by language (e.g., 'english').
- **tcgPlayerId** (string) - Optional - Filters cards by TCGPlayer product ID.
- **cardId** (string) - Optional - Filters cards by unique card identifier.
- **setId** (string) - Optional - Filters cards by set ID (e.g., 'black-and-white-promos').
- **set** (string) - Optional - Filters cards by set name.
- **setName** (string) - Optional - Filters cards by the name of the set.
- **search** (string) - Optional - Performs a text search for cards (e.g., 'charizard base set holo').
- **rarity** (string) - Optional - Filters cards by rarity (e.g., 'Holo Rare').
- **cardType** (string) - Optional - Filters cards by card type.
- **artist** (string) - Optional - Filters cards by artist name.
- **minPrice** (number) - Optional - Filters cards with a minimum price.
- **maxPrice** (number) - Optional - Filters cards with a maximum price.
- **printing** (string) - Optional - Filters cards by printing (e.g., '1st Edition').
- **condition** (string) - Optional - Filters cards by condition (e.g., 'Near Mint').
- **includeHistory** (boolean) - Optional - Whether to include price history data.
- **includeEbay** (boolean) - Optional - Whether to include eBay data.
- **includeBoth** (boolean) - Optional - Whether to include both TCGPlayer and eBay data.
- **days** (integer) - Optional - Number of days for price history data.
- **maxDataPoints** (integer) - Optional - Maximum data points for price history.
- **fetchAllInSet** (boolean) - Optional - Whether to fetch all cards in a set.
- **sortBy** (string) - Optional - Field to sort results by (e.g., 'cardNumber').
- **sortOrder** (string) - Optional - Order of sorting ('asc' or 'desc').
- **limit** (integer) - Optional - Maximum number of results to return.
- **offset** (integer) - Optional - Number of results to skip.

### Request Example
```json
{
  "example": "https://www.pokemonpricetracker.com/api/v2/cards?language=english&tcgPlayerId=233294&search=charizard base set holo&rarity=Holo Rare&minPrice=350&maxPrice=420&condition=Near Mint&limit=10"
}
```

### Response
#### Success Response (200)
- **artist** (string) - The name of the artist who illustrated the card.
- **tcgPlayerUrl** (string) - The URL to the card on TCGPlayer.
- **prices** (object) - An object containing pricing information.
  - **market** (number) - The market price of the card.
  - **low** (number) - The lowest available price for the card.
  - **listings** (integer) - The number of available listings.
  - **sellers** (integer) - The number of sellers.
  - **primaryCondition** (string) - The primary condition of the listed card.
  - **primaryPrinting** (string) - The primary printing of the card.
  - **lastUpdated** (string) - The timestamp when the price data was last updated.
- **imageCdnUrl** (string) - The URL to the card's image on the CDN.
- **imageCdnUrl200** (string) - The URL to a 200x200 version of the card's image.
- **imageCdnUrl400** (string) - The URL to a 400x400 version of the card's image.
- **imageCdnUrl800** (string) - The URL to an 800x800 version of the card's image.
- **metadata** (object) - Metadata about the response.
  - **total** (integer) - The total number of cards matching the query.
  - **count** (integer) - The number of cards returned in this response.
  - **limit** (integer) - The limit applied to the number of results.
  - **offset** (integer) - The offset applied to the results.
  - **hasMore** (boolean) - Indicates if there are more results available.
  - **language** (string) - The language of the returned cards.
  - **includes** (object) - Information about included data.
    - **priceHistory** (boolean) - Whether price history was included.
    - **ebayData** (boolean) - Whether eBay data was included.

#### Response Example
```json
{
  "artist": "Mitsuhiro Arita",
  "tcgPlayerUrl": "https://www.tcgplayer.com/product/233294",
  "prices": {
    "market": 420,
    "low": 350,
    "listings": 156,
    "sellers": 42,
    "primaryCondition": "Near Mint",
    "primaryPrinting": "Holofoil",
    "lastUpdated": "2024-01-15T12:00:00Z"
  },
  "imageCdnUrl": "https://tcgplayer-cdn.tcgplayer.com/product/233294_in_800x800.jpg",
  "imageCdnUrl200": "https://tcgplayer-cdn.tcgplayer.com/product/233294_in_200x200.jpg",
  "imageCdnUrl400": "https://tcgplayer-cdn.tcgplayer.com/product/233294_in_400x400.jpg",
  "imageCdnUrl800": "https://tcgplayer-cdn.tcgplayer.com/product/233294_in_800x800.jpg",
  "metadata": {
    "total": 1,
    "count": 1,
    "limit": 1,
    "offset": 0,
    "hasMore": false,
    "language": "english",
    "includes": {
      "priceHistory": false,
      "ebayData": false
    }
  }
}
```
```

--------------------------------

### Population API

Source: https://www.pokemonpricetracker.com/docs/index

Fetches GemRate grading population data for Pokemon cards from services like PSA, BGS, CGC, and SGC.

```APIDOC
## GET /population

### Description
Fetches GemRate grading population data for Pokemon cards from services like PSA, BGS, CGC, and SGC.

### Method
GET

### Endpoint
https://www.pokemonpricetracker.com/api/v2/population

### Parameters
No specific parameters are listed for this endpoint in the provided documentation.

### Request Example
```json
{
  "example": "https://www.pokemonpricetracker.com/api/v2/population"
}
```

### Response
#### Success Response (200)
(Response structure not detailed in the provided text, but expected to contain population data.)

#### Response Example
(Response example not detailed in the provided text.)
```

--------------------------------

### POST /parse-title

Source: https://www.pokemonpricetracker.com/docs/index

A utility endpoint designed to help parse card titles, likely for identification or data extraction purposes.

```APIDOC
## POST /parse-title

### Description
A utility endpoint designed to help parse card titles, likely for identification or data extraction purposes.

### Method
POST

### Endpoint
https://www.pokemonpricetracker.com/api/v2/parse-title

### Parameters
#### Request Body
(Request body structure not detailed in the provided text, but expected to contain a card title string.)

### Request Example
```json
{
  "example": "{\"title\": \"Charizard VMAX\"}" 
}
```

### Response
#### Success Response (200)
(Response structure not detailed in the provided text, but expected to contain parsed card title information.)

#### Response Example
(Response example not detailed in the provided text.)
```

--------------------------------

### Sealed Products API

Source: https://www.pokemonpricetracker.com/docs/index

Retrieves information about sealed Pokemon TCG products such as booster boxes and Elite Trainer Boxes (ETBs).

```APIDOC
## GET /sealed-products

### Description
Retrieves information about sealed Pokemon TCG products such as booster boxes and Elite Trainer Boxes (ETBs).

### Method
GET

### Endpoint
https://www.pokemonpricetracker.com/api/v2/sealed-products

### Parameters
No specific parameters are listed for this endpoint in the provided documentation.

### Request Example
```json
{
  "example": "https://www.pokemonpricetracker.com/api/v2/sealed-products"
}
```

### Response
#### Success Response (200)
(Response structure not detailed in the provided text, but expected to contain sealed product information.)

#### Response Example
(Response example not detailed in the provided text.)
```

--------------------------------

### Parse eBay Title

Source: https://www.pokemonpricetracker.com/docs/index

Parses an eBay listing title to identify Pokemon card details. This operation has a higher credit cost.

```APIDOC
## POST /parse/title

### Description
Parses an eBay listing title to identify Pokemon card details. This operation has a higher credit cost.

### Method
POST

### Endpoint
`/api/v2/parse/title`

### Query Parameters
- **title** (string) - Required - The eBay listing title to parse.
- **fuzzy** (boolean) - Optional - Enables fuzzy matching for better accuracy (adds 1 credit).
- **long_title** (boolean) - Optional - Indicates if the title is long, potentially requiring more processing (adds 1 credit).

### Request Example
```json
{
  "title": "Charizard Base Set 1st Edition Holo PSA 10 GEM MINT",
  "fuzzy": true,
  "long_title": true
}
```

### Response
#### Success Response (200)
- **card_details** (object) - Contains the identified details of the Pokemon card.
  - **name** (string) - The name of the Pokemon card.
  - **set** (string) - The set the card belongs to.
  - **rarity** (string) - The rarity of the card.
  - **year** (integer) - The year the card was released.
  - **is_holo** (boolean) - Whether the card is holographic.
  - **is_first_edition** (boolean) - Whether the card is first edition.
  - **grading_company** (string) - The grading company (e.g., PSA, BGS).
  - **grade** (string) - The grade assigned to the card.

#### Response Example
```json
{
  "card_details": {
    "name": "Charizard",
    "set": "Base Set",
    "rarity": "Holo Rare",
    "year": 1999,
    "is_holo": true,
    "is_first_edition": true,
    "grading_company": "PSA",
    "grade": "10"
  }
}
```
```

--------------------------------

### Authentication

Source: https://www.pokemonpricetracker.com/docs/index

All API requests require a Bearer token in the Authorization header. Obtain your API key from pokemonpricetracker.com/api.

```APIDOC
## Authentication

All API requests require a Bearer token in the `Authorization` header:

```
Authorization: Bearer YOUR_API_KEY
```

Get your free API key at [pokemonpricetracker.com/api](https://pokemonpricetracker.com/api).
```

--------------------------------

### Sets API

Source: https://www.pokemonpricetracker.com/docs/index

Provides information about Pokemon TCG sets. This endpoint allows retrieval of details related to various Pokemon card sets.

```APIDOC
## GET /sets

### Description
Provides information about Pokemon TCG sets. This endpoint allows retrieval of details related to various Pokemon card sets.

### Method
GET

### Endpoint
https://www.pokemonpricetracker.com/api/v2/sets

### Parameters
No specific parameters are listed for this endpoint in the provided documentation.

### Request Example
```json
{
  "example": "https://www.pokemonpricetracker.com/api/v2/sets"
}
```

### Response
#### Success Response (200)
(Response structure not detailed in the provided text, but expected to contain set information.)

#### Response Example
(Response example not detailed in the provided text.)
```

--------------------------------

### Cards Collection Schema - JSON

Source: https://www.pokemonpricetracker.com/docs/database

Defines the structure of a single card entry in the Pokemon API database. Includes detailed information about the card, its set, pricing from various sources (TCGPlayer, graded prices), and update timestamps. This schema is crucial for understanding individual card data.

```json
{
  "id": "base1-4",                    // Unique identifier (setId-number)
  "name": "Charizard",               // Card name
  "supertype": "Pokémon",            // Card supertype
  "subtypes": ["Stage 2"],           // Array of subtypes
  "hp": "120",                       // Hit points (string or null)
  "types": ["Fire"],                 // Array of Pokemon types
  "rarity": "Rare Holo",             // Card rarity
  "artist": "Mitsuhiro Arita",       // Card artist
  "number": "4",                     // Card number in set
  "set": {
    "id": "base1",                   // Set identifier
    "name": "Base Set",              // Set name
    "series": "Base"                 // Series name
  },
  "images": {
    "small": "https://...",          // Small image URL (245x342)
    "large": "https://..."           // Large image URL (734x1024)
  },
  "tcgplayer": {
    "url": "https://...",            // TCGPlayer product URL
    "updatedAt": "2025-01-10",       // Last price update
    "prices": {
      "holofoil": {
        "low": 275.00,
        "mid": 375.00,
        "high": 575.00,
        "market": 399.99
      }
    }
  },
  "gradedPrices": {
    "psa10": 15750.00,
    "psa9": 1850.00,
    "psa8": 750.00
  },
  "lastUpdated": "2025-01-10T12:00:00Z"
}
```

=== COMPLETE CONTENT === This response contains all available snippets from this library. No additional content exists. Do not make further requests.