Best Buy · JSON Structure

Products Api Product List Response Structure

Paginated list of Best Buy products.

Type: object Properties: 11
Fortune 100RetailConsumer ElectronicsE-CommerceProductsStores

ProductListResponse is a JSON Structure definition published by Best Buy, describing 11 properties. It conforms to the https://json-structure.org/meta/core/v0/# meta-schema.

Properties

from to total currentPage totalPages queryTime totalTime partial canonicalUrl nextCursorMark products

Meta-schema: https://json-structure.org/meta/core/v0/#

JSON Structure

Raw ↑
{
  "$schema": "https://json-structure.org/meta/core/v0/#",
  "$id": "https://raw.githubusercontent.com/api-evangelist/best-buy/refs/heads/main/json-structure/products-api-product-list-response-structure.json",
  "name": "ProductListResponse",
  "description": "Paginated list of Best Buy products.",
  "type": "object",
  "properties": {
    "from": {
      "type": "int32",
      "description": "Starting index of returned results.",
      "example": 1
    },
    "to": {
      "type": "int32",
      "description": "Ending index of returned results.",
      "example": 10
    },
    "total": {
      "type": "int32",
      "description": "Total number of matching products.",
      "example": 125000
    },
    "currentPage": {
      "type": "int32",
      "description": "Current page number.",
      "example": 1
    },
    "totalPages": {
      "type": "int32",
      "description": "Total number of pages available.",
      "example": 12500
    },
    "queryTime": {
      "type": "string",
      "description": "Time taken to execute the query in seconds.",
      "example": "0.023"
    },
    "totalTime": {
      "type": "string",
      "description": "Total response time in seconds.",
      "example": "0.043"
    },
    "partial": {
      "type": "boolean",
      "description": "Whether the response is a partial result.",
      "example": false
    },
    "canonicalUrl": {
      "type": "string",
      "description": "The canonical URL for this query.",
      "example": "https://api.bestbuy.com/v1/products?format=json&pageSize=10"
    },
    "nextCursorMark": {
      "type": "string",
      "description": "Cursor mark for fetching the next page when using cursor-based pagination.",
      "example": "AoE="
    },
    "products": {
      "type": "array",
      "description": "Array of product objects.",
      "items": {
        "$ref": "#/components/schemas/Product"
      }
    }
  }
}