> ## Documentation Index
> Fetch the complete documentation index at: https://composio-preview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Bestbuy

> Best Buy offers a suite of APIs providing access to product, store, category, and recommendation data.

![Bestbuy logo](https://mintcdn.com/composio-preview/6S5R4NszqpnVIZRD/images/toolkits/bestbuy.png?fit=max\&auto=format\&n=6S5R4NszqpnVIZRD\&q=85\&s=e8cbf354abb6a235581e36e90d8f11e7)

* **Category:** ecommerce
* **Auth:** API\_KEY
* **Composio-managed OAuth available?** N/A
* **Tools:** 8
* **Triggers:** 0
* **Slug:** `BESTBUY`
* **Version:** 20261101\_00

## Tools

> [accordion] Get Categories
>
> **Slug:** `BESTBUY_GET_CATEGORIES`
>
> Tool to retrieve Best Buy product categories. Use when you need to list or filter categories in the catalog.
>
> #### Input Parameters
>
> **id** `string`
>
> Filter by category ID(s), pipe-separated
>
> **name** `string`
>
> Filter by category name(s), pipe-separated
>
> **page** `integer`
>
> Page number to retrieve (1-based)
>
> **show** `string`
>
> Comma-separated list of fields to include in each category
>
> **sort** `string`
>
> Sort order, e.g., 'name.asc' or 'id.desc'
>
> **format** `string ("json" | "xml")`
>
> Response format (json or xml)
>
> **pageSize** `integer`
>
> Number of categories per page (1-100)
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Category Details
>
> **Slug:** `BESTBUY_GET_CATEGORY_DETAILS`
>
> Retrieve detailed information about a Best Buy category by ID. Requires a Best Buy API key supplied in the request.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> The ID of the category to retrieve
>
> **page** `integer`
>
> Page number to retrieve
>
> **show** `string`
>
> Comma-delimited list of fields to include in the response
>
> **apiKey** `string` *required*
>
> Your Best Buy Developer API key
>
> **format** `string ("json" | "xml")`
>
> Response format, json or xml
>
> **pageSize** `integer`
>
> Number of records to return per page
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Product Details by SKU
>
> **Slug:** `BESTBUY_GET_PRODUCT_DETAILS`
>
> Tool to retrieve detailed information about a specific product by SKU. Use after obtaining a valid SKU to fetch its attributes.
>
> #### Input Parameters
>
> **sku** `string` *required*
>
> The SKU (Stock Keeping Unit) of the product to retrieve.
>
> **show** `string`
>
> Comma-separated list of additional fields to include in the response.
>
> **format** `string ("json" | "xml")`
>
> Response format. Defaults to json.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Products
>
> **Slug:** `BESTBUY_GET_PRODUCTS`
>
> Tool to retrieve products from Best Buy. Use when you need to fetch product listings with optional filters and sorting. Example: 'Get products for category abcat0101000 sorted by salePrice.dsc.'
>
> #### Input Parameters
>
> **sku** `string`
>
> Filter for a specific SKU
>
> **upc** `string`
>
> Filter for a specific UPC
>
> **name** `string`
>
> Filter by product name with wildcard, e.g., name="iPad\*"
>
> **page** `integer`
>
> Page number to retrieve
>
> **show** `string`
>
> Comma-separated list of attributes to include in response
>
> **sort** `string`
>
> Sort format, e.g., 'name.asc' or 'salePrice.dsc'
>
> **pageSize** `integer`
>
> Number of products per page (1-100)
>
> **salePrice** `string`
>
> Filter by sale price, e.g., 'salePrice>100'
>
> **categoryPath.id** `string`
>
> Filter products by category ID
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Review Details
>
> **Slug:** `BESTBUY_GET_REVIEW_DETAILS`
>
> Tool to retrieve detailed information for a specific review by ID. Use after confirming the review ID.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> The unique identifier of the review to retrieve
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Product Reviews
>
> **Slug:** `BESTBUY_GET_REVIEWS`
>
> Tool to retrieve product reviews. Use when you need customer feedback with filters or sorting. Use after obtaining product SKUs.
>
> #### Input Parameters
>
> **sku** `string`
>
> Filter reviews by product SKU
>
> **page** `integer`
>
> Page number for pagination
>
> **show** `string`
>
> Comma-separated fields to include in response
>
> **sort** `string`
>
> Sort expression, e.g., 'submissionTime.dsc'
>
> **format** `string ("json" | "xml")`
>
> Response format, 'json' (default) or 'xml'
>
> **maxScore** `integer`
>
> Maximum rating score (1-5)
>
> **minScore** `integer`
>
> Minimum rating score (1-5)
>
> **pageSize** `integer`
>
> Number of reviews per page
>
> **reviewer** `string`
>
> Filter reviews by reviewer name
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Store Details
>
> **Slug:** `BESTBUY_GET_STORE_DETAILS`
>
> Tool to retrieve detailed information about a specific Best Buy store. Use when you have a valid store ID.
>
> #### Input Parameters
>
> **show** `string`
>
> Comma-separated list of fields to include in the response (e.g., 'storeId,name,address')
>
> **storeId** `string` *required*
>
> Unique identifier for the Best Buy store
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Best Buy Stores
>
> **Slug:** `BESTBUY_GET_STORES`
>
> Tool to retrieve a list of Best Buy stores. Use when you need store listings with optional filters or geo-search after confirming your API key.
>
> #### Input Parameters
>
> **geo** `object`
>
> Geographic filtering parameters for stores search.
>
> **city** `string`
>
> Filter stores by city name
>
> **page** `integer`
>
> Page number to retrieve (must be > 0)
>
> **show** `string`
>
> Comma-separated list of store fields to include in the response
>
> **sort** `string`
>
> Sort directive, e.g., 'city.asc' or 'name.desc'
>
> **state** `string`
>
> Filter stores by two-letter state code
>
> **region** `string`
>
> Filter stores by region
>
> **storeId** `integer`
>
> Specific store ID to retrieve
>
> **pageSize** `integer`
>
> Number of results per page (must be > 0)
>
> **services** `string`
>
> Comma-separated list of services to filter by
>
> **storeType** `string`
>
> Filter stores by store type
>
> **postalCode** `string`
>
> Filter stores by postal code
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not
