Best Buy · Schema

Store

A Best Buy store location with operational details.

Fortune 100RetailConsumer ElectronicsE-CommerceProductsStores

Properties

Name	Type	Description
storeId	integer	Unique store identifier.
name	string	Short store name.
longName	string	Full store name including address.
address	string	Street address of the store.
address2	string	Secondary address line (suite, building, etc.).
city	string	City where the store is located.
state	string	Two-letter US state abbreviation.
zipcode	string	US postal code.
phone	string	Store phone number.
lat	number	Store latitude coordinate.
lng	number	Store longitude coordinate.
distance	number	Distance from the search location in miles (when area query is used).
storeType	string	Store format type.
hours	string	Store hours summary.
gmtOffset	integer	GMT offset for the store's timezone.
services	array	Services offered at this store location.

View JSON Schema on GitHub

JSON Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/best-buy/refs/heads/main/json-schema/stores-api-store-schema.json",
  "title": "Store",
  "description": "A Best Buy store location with operational details.",
  "type": "object",
  "properties": {
    "storeId": {
      "type": "integer",
      "description": "Unique store identifier.",
      "example": 281
    },
    "name": {
      "type": "string",
      "description": "Short store name.",
      "example": "Best Buy - San Francisco"
    },
    "longName": {
      "type": "string",
      "description": "Full store name including address.",
      "example": "Best Buy San Francisco - 1717 Harrison St"
    },
    "address": {
      "type": "string",
      "description": "Street address of the store.",
      "example": "1717 Harrison St"
    },
    "address2": {
      "type": "string",
      "description": "Secondary address line (suite, building, etc.).",
      "example": ""
    },
    "city": {
      "type": "string",
      "description": "City where the store is located.",
      "example": "San Francisco"
    },
    "state": {
      "type": "string",
      "description": "Two-letter US state abbreviation.",
      "example": "CA"
    },
    "zipcode": {
      "type": "string",
      "description": "US postal code.",
      "example": "94103"
    },
    "phone": {
      "type": "string",
      "description": "Store phone number.",
      "example": "415-626-9682"
    },
    "lat": {
      "type": "number",
      "format": "double",
      "description": "Store latitude coordinate.",
      "example": 37.771
    },
    "lng": {
      "type": "number",
      "format": "double",
      "description": "Store longitude coordinate.",
      "example": -122.411
    },
    "distance": {
      "type": "number",
      "format": "double",
      "description": "Distance from the search location in miles (when area query is used).",
      "example": 0.8
    },
    "storeType": {
      "type": "string",
      "description": "Store format type.",
      "enum": [
        "Big Box",
        "Express Kiosk",
        "Warehouse Sale",
        "Outlet Center",
        "PAC Standalone"
      ],
      "example": "Big Box"
    },
    "hours": {
      "type": "string",
      "description": "Store hours summary.",
      "example": "Mon-Sat 10am-8pm, Sun 11am-7pm"
    },
    "gmtOffset": {
      "type": "integer",
      "description": "GMT offset for the store's timezone.",
      "example": -8
    },
    "services": {
      "type": "array",
      "description": "Services offered at this store location.",
      "items": {
        "$ref": "#/components/schemas/StoreService"
      }
    }
  }
}