# Bestbuy

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

- **Category:** ecommerce
- **Auth:** API_KEY
- **Composio Managed App Available?** N/A
- **Tools:** 8
- **Triggers:** 0
- **Slug:** `BESTBUY`
- **Version:** 20260211_00

## Tools

### 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | No | Filter by category ID(s), pipe-separated |
| `name` | string | No | Filter by category name(s), pipe-separated |
| `page` | integer | No | Page number to retrieve (1-based) |
| `show` | string | No | Comma-separated list of fields to include in each category |
| `sort` | string | No | Sort order, e.g., 'name.asc' or 'id.desc' |
| `format` | string ("json" | "xml") | No | Response format (json or xml) |
| `pageSize` | integer | No | Number of categories per page (1-100) |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Category Details

**Slug:** `BESTBUY_GET_CATEGORY_DETAILS`

Tool to retrieve detailed information about a Best Buy category by its ID. Use when you need enriched metadata about a specific category.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | The ID of the category to retrieve |
| `page` | integer | No | Page number to retrieve |
| `show` | string | No | Comma-delimited list of fields to include in the response |
| `apiKey` | string | Yes | Your Best Buy Developer API key |
| `format` | string ("json" | "xml") | No | Response format, json or xml |
| `pageSize` | integer | No | Number of records to return per page |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `sku` | string | Yes | The SKU (Stock Keeping Unit) of the product to retrieve. |
| `show` | string | No | Comma-separated list of additional fields to include in the response. |
| `format` | string ("json" | "xml") | No | Response format. Defaults to json. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `sku` | string | No | Filter for a specific SKU |
| `upc` | string | No | Filter for a specific UPC |
| `name` | string | No | Filter by product name with wildcard, e.g., name="iPad*" |
| `page` | integer | No | Page number to retrieve |
| `show` | string | No | Comma-separated list of attributes to include in response |
| `sort` | string | No | Sort format, e.g., 'name.asc' or 'salePrice.dsc' |
| `pageSize` | integer | No | Number of products per page (1-100) |
| `salePrice` | string | No | Filter by sale price, e.g., 'salePrice>100' |
| `categoryPath.id` | string | No | Filter products by category ID |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | The unique identifier of the review to retrieve |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `sku` | string | No | Filter reviews by product SKU |
| `page` | integer | No | Page number for pagination |
| `show` | string | No | Comma-separated fields to include in response |
| `sort` | string | No | Sort expression, e.g., 'submissionTime.dsc' |
| `format` | string ("json" | "xml") | No | Response format, 'json' (default) or 'xml' |
| `maxScore` | integer | No | Maximum rating score (1-5) |
| `minScore` | integer | No | Minimum rating score (1-5) |
| `pageSize` | integer | No | Number of reviews per page |
| `reviewer` | string | No | Filter reviews by reviewer name |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `show` | string | No | Comma-separated list of fields to include in the response (e.g., 'storeId,name,address') |
| `storeId` | string | Yes | Unique identifier for the Best Buy store |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `geo` | object | No | Geographic filtering parameters for stores search. |
| `city` | string | No | Filter stores by city name |
| `page` | integer | No | Page number to retrieve (must be > 0) |
| `show` | string | No | Comma-separated list of store fields to include in the response |
| `sort` | string | No | Sort directive, e.g., 'city.asc' or 'name.desc' |
| `state` | string | No | Filter stores by two-letter state code |
| `region` | string | No | Filter stores by region |
| `storeId` | integer | No | Specific store ID to retrieve |
| `pageSize` | integer | No | Number of results per page (must be > 0) |
| `services` | string | No | Comma-separated list of services to filter by |
| `storeType` | string | No | Filter stores by store type |
| `postalCode` | string | No | Filter stores by postal code |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |