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

# List Catalog Objects

SearchResults returned can include Product, Groups, and Categories.

Search current catalog products by a variety of search fields.

[block:code]
{
  "codes": [
    {
      "code": "{\n    \"totalItems\": 0,\n    \"success\": true,\n    \"errors\": [],\n    \"results\": [\n        {\n            \"productName\": null,\n            \"setName\": null,\n            \"cleanSetName\": null,\n            \"categoryName\": \"Magic: The Gathering\",\n            \"cleanCategoryName\": \"Magic\",\n            \"matchType\": 0\n        }\n    ]\n}",
      "language": "json",
      "name": "Response Template"
    },
    {
      "code": "{\n    \"totalItems\": 0,\n    \"success\": true,\n    \"errors\": [],\n    \"results\": [\n        {\n            \"productName\": null,\n            \"setName\": null,\n            \"cleanSetName\": null,\n            \"categoryName\": \"Magic: The Gathering\",\n            \"cleanCategoryName\": \"Magic\",\n            \"matchType\": 0\n        },\n        {\n            \"productName\": null,\n            \"setName\": \"Lorwyn\",\n            \"cleanSetName\": \"Lorwyn\",\n            \"categoryName\": \"Magic: The Gathering\",\n            \"cleanCategoryName\": \"Magic\",\n            \"matchType\": 1\n        },\n        {\n            \"productName\": null,\n            \"setName\": \"Magic 2010 (M10)\",\n            \"cleanSetName\": \"Magic 2010 M10\",\n            \"categoryName\": \"Magic: The Gathering\",\n            \"cleanCategoryName\": \"Magic\",\n            \"matchType\": 1\n        },\n        {\n            \"productName\": null,\n            \"setName\": \"Magic 2012 (M12)\",\n            \"cleanSetName\": \"Magic 2012 M12\",\n            \"categoryName\": \"Magic: The Gathering\",\n            \"cleanCategoryName\": \"Magic\",\n            \"matchType\": 1\n        },\n        {\n            \"productName\": null,\n            \"setName\": \"Magic Player Rewards\",\n            \"cleanSetName\": \"Magic Player Rewards\",\n            \"categoryName\": \"Magic: The Gathering\",\n            \"cleanCategoryName\": \"Magic\",\n            \"matchType\": 1\n        },\n        {\n            \"productName\": \"Ponder\",\n            \"setName\": null,\n            \"cleanSetName\": null,\n            \"categoryName\": \"Magic: The Gathering\",\n            \"cleanCategoryName\": \"Magic\",\n            \"matchType\": 2\n        },\n        {\n            \"productName\": null,\n            \"setName\": \"Archenemy: Nicol Bolas\",\n            \"cleanSetName\": \"Archenemy Nicol Bolas\",\n            \"categoryName\": \"Magic: The Gathering\",\n            \"cleanCategoryName\": \"Magic\",\n            \"matchType\": 1\n        },\n        {\n            \"productName\": null,\n            \"setName\": \"Kaladesh\",\n            \"cleanSetName\": \"Kaladesh\",\n            \"categoryName\": \"Magic: The Gathering\",\n            \"cleanCategoryName\": \"Magic\",\n            \"matchType\": 1\n        },\n        {\n            \"productName\": null,\n            \"setName\": \"Magic Origins\",\n            \"cleanSetName\": \"Magic Origins\",\n            \"categoryName\": \"Magic: The Gathering\",\n            \"cleanCategoryName\": \"Magic\",\n            \"matchType\": 1\n        },\n        {\n            \"productName\": \"Aerial Responder\",\n            \"setName\": null,\n            \"cleanSetName\": null,\n            \"categoryName\": \"Magic: The Gathering\",\n            \"cleanCategoryName\": \"Magic\",\n            \"matchType\": 2\n        },\n        {\n            \"productName\": \"Mage-Ring Responder\",\n            \"setName\": null,\n            \"cleanSetName\": null,\n            \"categoryName\": \"Magic: The Gathering\",\n            \"cleanCategoryName\": \"Magic\",\n            \"matchType\": 2\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/search": {
      "get": {
        "tags": [
          "Stores"
        ],
        "summary": "List Catalog Objects",
        "description": "SearchResults returned can include Product, Groups, and Categories.",
        "operationId": "Stores_SearchInventory",
        "parameters": [
          {
            "name": "storeKey",
            "in": "path",
            "description": "Required. A unique key used to identify the caller of the API.",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "q",
            "in": "query",
            "description": "The string to search for in Product, Category, and Group names.",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "description": "Used for paging. The maximum number of SearchResults 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.ApiResult_TcgApiModel.Store.SearchResult_"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/TcgApiModel.Common.ApiResult_TcgApiModel.Store.SearchResult_"
                }
              }
            }
          }
        }
      }
    }
  },
  "servers": [
    {
      "url": "https://api.tcgplayer.com"
    }
  ],
  "components": {
    "schemas": {
      "TcgApiModel.Store.SearchResult": {
        "type": "object",
        "properties": {
          "productName": {
            "type": "string"
          },
          "setName": {
            "type": "string"
          },
          "cleanSetName": {
            "type": "string"
          },
          "categoryName": {
            "type": "string"
          },
          "cleanCategoryName": {
            "type": "string"
          },
          "matchType": {
            "format": "int32",
            "type": "integer"
          }
        }
      },
      "TcgApiModel.Common.ApiResult_TcgApiModel.Store.SearchResult_": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "errors": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "results": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/TcgApiModel.Store.SearchResult"
            }
          }
        }
      }
    }
  },
  "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
    }
  }
}
```