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

# Search 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.
Similar to the other Top Sales Search except that you can specify search criteria in the sellerTssc parameter.

The name of the category is a required parameter in the body.

[block:code]
{
  "codes": [
    {
      "code": "{\n  \"categories\": [\n    {\n      \"categoryId\": 1,\n      \"name\": \"Magic\"\n    }\n  ]\n}",
      "language": "text",
      "name": "Body example"
    }
  ]
}
[/block]

# OpenAPI definition

```json
{
  "openapi": "3.0.0",
  "info": {
    "version": "v1.39.0",
    "title": "TcgApi"
  },
  "paths": {
    "/stores/{storeKey}/inventory/topsalessearch": {
      "post": {
        "tags": [
          "Stores"
        ],
        "summary": "Search 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.\r\nSimilar to the other Top Sales Search except that you can specify search criteria in the sellerTssc parameter.",
        "operationId": "Stores_TopSalesSearch",
        "parameters": [
          {
            "name": "storeKey",
            "in": "path",
            "description": "Required. A unique key used to identify the caller of the API.",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "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": "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"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/TcgApiModel.Store.TopSalesSearchCriteria"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/TcgApiModel.Store.TopSalesSearchCriteria"
              }
            },
            "application/x-www-form-urlencoded": {
              "schema": {
                "$ref": "#/components/schemas/TcgApiModel.Store.TopSalesSearchCriteria"
              }
            }
          },
          "description": "The criteria to use in the search.",
          "required": true
        },
        "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.Catalog.Category": {
        "type": "object",
        "properties": {
          "categoryId": {
            "format": "int32",
            "type": "integer"
          },
          "name": {
            "type": "string"
          },
          "modifiedOn": {
            "format": "date-time",
            "type": "string"
          },
          "displayName": {
            "type": "string"
          },
          "seoCategoryName": {
            "type": "string"
          },
          "sealedLabel": {
            "type": "string"
          },
          "nonSealedLabel": {
            "type": "string"
          },
          "conditionGuideUrl": {
            "type": "string"
          },
          "isScannable": {
            "type": "boolean"
          },
          "popularity": {
            "format": "int32",
            "type": "integer"
          }
        }
      },
      "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.Store.TopSalesSearchCriteria": {
        "type": "object",
        "properties": {
          "categories": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/TcgApiModel.Catalog.Category"
            }
          }
        }
      },
      "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
    }
  }
}
```