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

# Search Stores

Returns a collection of storeKey values based on the search parameters.

Searches for stores based on passed parameters. Doesn't allow you to interact with the stores returned, just gives keys which can be used to give a little more information about the stores. This could be useful for a Geo Location application.

[block:code]
{
  "codes": [
    {
      "code": "{\n    \"totalItems\": integer,\n    \"success\": boolean,\n    \"errors\": [],\n    \"results\": [\n        string,\n      \tstring,\n      \tstring\n    ]\n}",
      "language": "json",
      "name": "Response Template"
    },
    {
      "code": "/stores?name=Gamer\n\n{\n    \"totalItems\": 479,\n    \"success\": true,\n    \"errors\": [],\n    \"results\": [\n        \"369cc67b\",\n        \"7b19d7b9\",\n        \"a4a75f58\",\n        \"6681c773\",\n        \"9522e0a4\",\n        \"f17ab081\",\n        \"b4f24b1a\",\n        \"11401f01\",\n        \"986f6f26\",\n        \"3a5dd391\"\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": {
      "get": {
        "tags": [
          "Stores"
        ],
        "summary": "Search Stores",
        "description": "Returns a collection of storeKey values based on the search parameters.",
        "operationId": "Stores_GetStores",
        "parameters": [
          {
            "name": "name",
            "in": "query",
            "description": "Optional filter to search by store name.",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "address",
            "in": "query",
            "description": "Optional filter to search by store address.",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "city",
            "in": "query",
            "description": "Optional filter to search by store city.",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "state",
            "in": "query",
            "description": "Optional filter to search by store state.",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "zipCode",
            "in": "query",
            "description": "Optional filter to search by store ZIP/Postal code.",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "sort",
            "in": "query",
            "description": "If specified, sort the results by this value. Default is \"Name ASC\".",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "offset",
            "in": "query",
            "description": "Used for paging. The number of records to skip. Default is 0.",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "description": "Used for paging. The maximum number of records 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_System.String_"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/TcgApiModel.Common.PagedApiResult_System.String_"
                }
              }
            }
          }
        }
      }
    }
  },
  "servers": [
    {
      "url": "https://api.tcgplayer.com"
    }
  ],
  "components": {
    "schemas": {
      "TcgApiModel.Common.PagedApiResult_System.String_": {
        "type": "object",
        "properties": {
          "totalItems": {
            "format": "int32",
            "type": "integer"
          },
          "success": {
            "type": "boolean"
          },
          "errors": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "results": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        }
      }
    }
  },
  "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
    }
  }
}
```