TCGCSV

https://tcgcsv.com/docs
Admin
TCGCSV provides cached TCGplayer API data (categories, groups, products, and market prices) updated...
Tokens:3,496
Snippets:24
Trust Score:5.3
Update:4 months ago
Show doc for...
Tokens:
Raw
### TCGplayer Products API URL Example

Source: https://tcgcsv.com/docs

This is an example URL for fetching products from the TCGplayer API. Replace {categoryId} and {groupId} with the appropriate IDs for your query.

```HTTP
https://tcgcsv.com/tcgplayer/3/3170/products
```

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

### TCGplayer Products API JSON Response Example

Source: https://tcgcsv.com/docs

This is an example JSON response from the TCGplayer List All Products endpoint when getExtendedFields is set to true. It includes product details and nested extendedData.

```JSON
{
    "totalItems": 254,
    "success": true,
    "errors": [],
    "results": [
        // ...

        {
            "productId": 451396,
            "name": "Lugia VSTAR",
            "cleanName": "Lugia VSTAR",
            "imageUrl": "https://tcgplayer-cdn.tcgplayer.com/product/451396_200w.jpg",
            "categoryId": 3,
            "groupId": 3170,
            "url": "https://www.tcgplayer.com/product/451396/pokemon-swsh12-silver-tempest-lugia-vstar",
            "modifiedOn": "2025-12-04T15:00:29.8",
            "imageCount": 1,
            "presaleInfo": {
                "isPresale": false,
                "releasedOn": null,
                "note": null
            },
            "extendedData": [
                {
                  "name": "Number",
                  "displayName": "Card Number",
                  "value": "139/195"
                }, {
                  "name": "Rarity",
                  "displayName": "Rarity",
                  "value": "Ultra Rare"
                }, {
                  "name": "Card Type",
                  "displayName": "Card Type",
                  "value": "Colorless"
                }, {
                  "name": "HP",
                  "displayName": "HP",
                  "value": "280"
                }, {
                  "name": "Stage",
                  "displayName": "Stage", 
                  "value": "VSTAR"
                }, {
                  "name": "CardText",
                  "displayName": "Card Text",
                  "value": "<span style=\"color:gold\"><strong>VSTAR Power</strong></span>\r\n<br>\r\n<strong>Ability — Summoning Star</strong>\r\n<br>\r\n…game.)</em>\r\n<br><br>\r\n<em>VSTAR rule — When your Pokémon VSTAR is Knocked Out, your opponent takes 2 Prize cards.</em>"
                }, {
                  "name": "Attack 1",
                  "displayName": "Attack 1", 
                  "value": "[4] Tempest Dive (220)\r\n<br>\r\nYou may discard a Stadium in play."
                }, {
                  "name": "Weakness",
                  "displayName": "Weakness",
                  "value": "Lx2"
                }, {
                  "name": "Resistance",
                  "displayName": "Resistance",
                  "value": "F-30"
                }, {
                  "name": "RetreatCost",
                  "displayName": "Retreat Cost",
                  "value": "2"
                }
            ]
        },

        // ...
    ]
}
```

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

### Example Market Prices JSON Response

Source: https://tcgcsv.com/docs

This JSON snippet shows a sample response from the TCGplayer Product Prices by Group endpoint, illustrating the structure of price data for individual products.

```json
{
    "success": true,
    "errors": [],
    "results": [
        // ...

        {
            "productId": 451784,
            "lowPrice": 0.1,
            "midPrice": 0.51,
            "highPrice": 25.51,
            "marketPrice": 0.53,
            "directLowPrice": 0.44,
            "subTypeName": "Holofoil"
        }, {
            "productId": 451784,
            "lowPrice": 0.35,
            "midPrice": 0.7,
            "highPrice": 2.99,
            "marketPrice": 0.74,
            "directLowPrice": null,
            "subTypeName": "Reverse Holofoil"
        }

        // ...
    ]
}
```

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

### Example Categories Response

Source: https://tcgcsv.com/docs

This JSON structure represents the response from the TCGplayer List All Categories endpoint. It includes total items, success status, errors, and a list of category results.

```json
{
    "totalItems": 89,
    "success": true,
    "errors": [],
    "results": [
        // ...

        {
            "categoryId": 3,
            "name": "Pokemon",
            "modifiedOn": "2025-11-19T15:58:35.27",
            "displayName": "Pokemon",
            "seoCategoryName": "Pokemon",
            "categoryDescription": "Trainers, your Pokémon adventure starts here! Whether you're a champ in the making or trying to catch 'em all from the latest sets, browse and buy Pokémon cards, booster boxes, Elite Trainer Boxes, and card packs at the best prices from thousands of sellers.",
            "categoryPageTitle": "TCGplayer - Buy Pokémon TCG Cards, Singles, and Pack",
            "sealedLabel": "Sealed Products",
            "nonSealedLabel": "Single Cards",
            "conditionGuideUrl": "https://store.tcgplayer.com/help/cardconditionguide",
            "isScannable": true,
            "popularity": 576635,
            "isDirect": true
        },

        // ...
    ]
}
```

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

### Example Groups Response

Source: https://tcgcsv.com/docs

This JSON structure represents the response from the TCGplayer List All Category Groups endpoint. It includes total items, success status, errors, and a list of group results.

```json
{
    "totalItems": 212,
    "success": true,
    "errors": [],
    "results": [
        // ...

        {
            "groupId": 3170,
            "name": "SWSH12: Silver Tempest",
            "abbreviation": "SWSH12",
            "isSupplemental": false,
            "publishedOn": "2022-11-11T00:00:00",
            "modifiedOn": "2025-12-12T22:37:34.34",
            "categoryId": 3
        },

        // ...
    ]
}
```

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

### List All Categories

Source: https://tcgcsv.com/docs

Retrieves a list of all available categories on TCGplayer. This endpoint provides information such as category ID, name, and display details.

```APIDOC
## GET /tcgplayer/categories

### Description
Retrieves a list of all available categories on TCGplayer. This endpoint provides information such as category ID, name, and display details.

### Method
GET

### Endpoint
https://tcgcsv.com/tcgplayer/categories

### Parameters
This endpoint does not accept any parameters.

### Response
#### Success Response (200)
- **totalItems** (int32) - The total number of categories returned.
- **success** (boolean) - Indicates if the request was successful.
- **errors** (array) - An array of errors, if any occurred.
- **results** (array) - An array of category objects, each containing:
  - **categoryId** (int32) - Unique ID for the category.
  - **name** (string) - Internal name of the category.
  - **modifiedOn** (string) - Timestamp of the last modification.
  - **displayName** (string) - Name of the category for display.
  - **seoCategoryName** (string) - SEO-friendly name for the category.
  - **categoryDescription** (nullable string) - Description of the category.
  - **categoryPageTitle** (nullable string) - Title for the category page.
  - **sealedLabel** (nullable string) - Label for sealed products.
  - **nonSealedLabel** (nullable string) - Label for non-sealed products.
  - **conditionGuideUrl** (string) - URL to the condition guide.
  - **isScannable** (boolean) - Indicates if products in this category are scannable.
  - **popularity** (int32) - Popularity ranking of the category.
  - **isDirect** (boolean) - Indicates if products are available via TCGplayer Direct.

### Request Example
```json
{
    "example": "request body"
}
```

### Response Example
```json
{
    "totalItems": 89,
    "success": true,
    "errors": [],
    "results": [
        {
            "categoryId": 3,
            "name": "Pokemon",
            "modifiedOn": "2025-11-19T15:58:35.27",
            "displayName": "Pokemon",
            "seoCategoryName": "Pokemon",
            "categoryDescription": "Trainers, your Pokémon adventure starts here! Whether you're a champ in the making or trying to catch 'em all from the latest sets, browse and buy Pokémon cards, booster boxes, Elite Trainer Boxes, and card packs at the best prices from thousands of sellers.",
            "categoryPageTitle": "TCGplayer - Buy Pokémon TCG Cards, Singles, and Pack",
            "sealedLabel": "Sealed Products",
            "nonSealedLabel": "Single Cards",
            "conditionGuideUrl": "https://store.tcgplayer.com/help/cardconditionguide",
            "isScannable": true,
            "popularity": 576635,
            "isDirect": true
        }
    ]
}
```
```

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

### List All Category Groups

Source: https://tcgcsv.com/docs

Retrieves a list of groups (sets) within a specified category. This endpoint provides details about each group, such as its ID, name, and publication date.

```APIDOC
## GET /tcgplayer/{categoryId}/groups

### Description
Retrieves a list of groups (sets) within a specified category. This endpoint provides details about each group, such as its ID, name, and publication date.

### Method
GET

### Endpoint
https://tcgcsv.com/tcgplayer/{categoryId}/groups

### Parameters
#### Path Parameters
- **categoryId** (int32) - Required - The ID of the category to retrieve groups for.

### Response
#### Success Response (200)
- **totalItems** (int32) - The total number of groups returned.
- **success** (boolean) - Indicates if the request was successful.
- **errors** (array) - An array of errors, if any occurred.
- **results** (array) - An array of group objects, each containing:
  - **groupId** (int32) - Unique ID for the group.
  - **name** (string) - Name of the group or set.
  - **abbreviation** (string) - Abbreviation for the group or set.
  - **isSupplemental** (boolean) - Indicates if the group is supplemental.
  - **publishedOn** (string) - Timestamp when the group was first created.
  - **modifiedOn** (string) - Timestamp of the last modification.
  - **categoryId** (int32) - Reference to the category this group belongs to.

### Request Example
```json
{
    "example": "request body"
}
```

### Response Example
```json
{
    "totalItems": 212,
    "success": true,
    "errors": [],
    "results": [
        {
            "groupId": 3170,
            "name": "SWSH12: Silver Tempest",
            "abbreviation": "SWSH12",
            "isSupplemental": false,
            "publishedOn": "2022-11-11T00:00:00",
            "modifiedOn": "2025-12-12T22:37:34.34",
            "categoryId": 3
        }
    ]
}
```
```

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

### TCGplayer API Response Format

Source: https://tcgcsv.com/docs

This is the typical JSON response format from TCGplayer API endpoints. It includes metadata about the request and a list of results.

```json
{
    "totalItems": 440,
    "success": true,
    "errors": [],
    "results": [
        // ...
    ]

}
```
Tokens:
Raw