Fetch the complete documentation index at: https://docs.tcgplayer.com/llms.txt. Use this file to discover all available pages before exploring further.

# List Top Sold Products

This listing comes from the current Store's inventory whose Seller is associated with the user's bearer token making this API call.

This endpoint returns the product category that received the most sales by the currently authenticated store.

[block:code]
{
  "codes": [
    {
      "code": "{\n    \"totalItems\": integer,\n    \"success\": boolean,\n    \"errors\": [],\n    \"results\": [\n        {\n            \"productId\": integer,\n            \"productName\": \"string\",\n            \"setName\": \"string\",\n            \"categoryName\": \"string\",\n            \"rarity\": \"string\",\n            \"number\": integer,\n            \"lowestPrice\": decimal\n        }\n    ]\n}",
      "language": "json",
      "name": "Response Template"
    },
    {
      "code": "{\n    \"totalItems\": 30681,\n    \"success\": true,\n    \"errors\": [],\n    \"results\": [\n        {\n            \"productId\": 145602,\n            \"productName\": \"Field of Ruin\",\n            \"setName\": \"Ixalan\",\n            \"categoryName\": \"Magic\",\n            \"rarity\": \"U\",\n            \"number\": \"254\",\n            \"lowestPrice\": 1.79\n        },\n        {\n            \"productId\": 155794,\n            \"productName\": \"Curious Obsession\",\n            \"setName\": \"Rivals of Ixalan\",\n            \"categoryName\": \"Magic\",\n            \"rarity\": \"U\",\n            \"number\": \"35\",\n            \"lowestPrice\": 0.22\n        },\n        {\n            \"productId\": 95242,\n            \"productName\": \"Gurmag Angler\",\n            \"setName\": \"Fate Reforged\",\n            \"categoryName\": \"Magic\",\n            \"rarity\": \"C\",\n            \"number\": \"72\",\n            \"lowestPrice\": 0.3\n        },\n        {\n            \"productId\": 118411,\n            \"productName\": \"Bloodbraid Elf\",\n            \"setName\": \"Eternal Masters\",\n            \"categoryName\": \"Magic\",\n            \"rarity\": \"U\",\n            \"number\": \"197\",\n            \"lowestPrice\": 2.67\n        },\n        {\n            \"productId\": 155738,\n            \"productName\": \"Hadanas Climb\",\n            \"setName\": \"Rivals of Ixalan\",\n            \"categoryName\": \"Magic\",\n            \"rarity\": \"R\",\n            \"number\": \"158\",\n            \"lowestPrice\": 1.72\n        },\n        {\n            \"productId\": 151825,\n            \"productName\": \"Island\",\n            \"setName\": \"Unstable\",\n            \"categoryName\": \"Magic\",\n            \"rarity\": \"L\",\n            \"number\": \"213\",\n            \"lowestPrice\": 3.56\n        },\n        {\n            \"productId\": 145699,\n            \"productName\": \"Swamp\",\n            \"setName\": \"Ixalan\",\n            \"categoryName\": \"Magic\",\n            \"rarity\": \"L\",\n            \"number\": \"268\",\n            \"lowestPrice\": 0.18\n        },\n        {\n            \"productId\": 66560,\n            \"productName\": \"Ethereal Armor\",\n            \"setName\": \"Return to Ravnica\",\n            \"categoryName\": \"Magic\",\n            \"rarity\": \"C\",\n            \"number\": \"9\",\n            \"lowestPrice\": 0.22\n        },\n        {\n            \"productId\": 151828,\n            \"productName\": \"Forest\",\n            \"setName\": \"Unstable\",\n            \"categoryName\": \"Magic\",\n            \"rarity\": \"L\",\n            \"number\": \"216\",\n            \"lowestPrice\": 2.74\n        },\n        {\n            \"productId\": 145686,\n            \"productName\": \"Mountain\",\n            \"setName\": \"Ixalan\",\n            \"categoryName\": \"Magic\",\n            \"rarity\": \"L\",\n            \"number\": \"272\",\n            \"lowestPrice\": 0.19\n        }\n    ]\n}",
      "language": "json",
      "name": "Example Response #1"
    }
  ]
}
[/block]

# OpenAPI definition

```json
{
  "openapi": "3.0.0",
  "info": {
    "version": "v1.39.0",
    "title": "TcgApi"
  },
  "paths": {
    "/stores/{storeKey}/inventory/topsales": {
      "get": {
        "tags": [
          "Stores"
        ],
        "summary": "List Top Sold Products",
        "description": "This listing comes from the current Store's inventory whose Seller is associated with the user's bearer token making this API call.",
        "operationId": "Stores_GetTopSalesForSeller",
        "parameters": [
          {
            "name": "storeKey",
            "in": "path",
            "description": "Required. A unique key used to identify the caller of the API.",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "categoryId",
            "in": "query",
            "description": "If provided, this request will only return products from the specified category.",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "includeGeneric",
            "in": "query",
            "description": "If set to true, generic listings will be returned.  Default is true.",
            "required": false,
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "includeCustom",
            "in": "query",
            "description": "If set to true, custom listings will be returned.  Default is true.",
            "required": false,
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "channelId",
            "in": "query",
            "description": "The channel to search for results. Defaults to 0, the TCG Marketplace.",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "includeExcludedCategories",
            "in": "query",
            "description": "If true, will return results for excluded categories. Default is false.",
            "required": false,
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "offset",
            "in": "query",
            "description": "Used for paging. The number of TopSoldProducts to skip. Default is 0.",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "description": "Used for paging. The maximum number of TopSoldProducts to return. Default is 10.",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/TcgApiModel.Common.PagedApiResult_TcgApiModel.Store.TopSoldProduct_"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/TcgApiModel.Common.PagedApiResult_TcgApiModel.Store.TopSoldProduct_"
                }
              }
            }
          }
        }
      }
    }
  },
  "servers": [
    {
      "url": "https://api.tcgplayer.com"
    }
  ],
  "components": {
    "schemas": {
      "TcgApiModel.Store.TopSoldProduct": {
        "type": "object",
        "properties": {
          "productId": {
            "format": "int64",
            "type": "integer"
          },
          "productName": {
            "type": "string"
          },
          "setName": {
            "type": "string"
          },
          "categoryName": {
            "type": "string"
          },
          "rarity": {
            "type": "string"
          },
          "number": {
            "type": "string"
          },
          "lowestPrice": {
            "format": "double",
            "type": "number"
          },
          "imageUrl": {
            "type": "string"
          }
        }
      },
      "TcgApiModel.Common.PagedApiResult_TcgApiModel.Store.TopSoldProduct_": {
        "type": "object",
        "properties": {
          "totalItems": {
            "format": "int32",
            "type": "integer"
          },
          "success": {
            "type": "boolean"
          },
          "errors": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "results": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/TcgApiModel.Store.TopSoldProduct"
            }
          }
        }
      }
    }
  },
  "x-readme": {
    "explorer-enabled": true,
    "proxy-enabled": true
  },
  "_id": {
    "buffer": {
      "0": 94,
      "1": 217,
      "2": 152,
      "3": 86,
      "4": 78,
      "5": 118,
      "6": 200,
      "7": 0,
      "8": 17,
      "9": 105,
      "10": 157,
      "11": 192
    }
  }
}
```