> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pinkfish.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# best-buy
> Best Buy Product Catalog
**Server path:** `/best-buy` | **Type:** Application | **PCID required:** Yes
## Tools
| Tool | Description |
| --------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [`best-buy_get_also_bought_products`](#best-buy_get_also_bought_products) | Get also-bought product recommendations |
| [`best-buy_get_also_viewed_products`](#best-buy_get_also_viewed_products) | Get also-viewed product recommendations |
| [`best-buy_get_most_viewed_products`](#best-buy_get_most_viewed_products) | Get most-viewed products by category |
| [`best-buy_get_product`](#best-buy_get_product) | Get product by SKU |
| [`best-buy_get_product_store_availability`](#best-buy_get_product_store_availability) | Get product store availability |
| [`best-buy_get_product_warranties`](#best-buy_get_product_warranties) | Get product warranties |
| [`best-buy_get_trending_products`](#best-buy_get_trending_products) | Get trending products by category |
| [`best-buy_get_viewed_ultimately_bought_products`](#best-buy_get_viewed_ultimately_bought_products) | Get viewed-ultimately-bought recommendations |
| [`best-buy_list_categories`](#best-buy_list_categories) | List product categories |
| [`best-buy_list_stores`](#best-buy_list_stores) | List Best Buy stores |
| [`best-buy_search_products`](#best-buy_search_products) | Search Best Buy products using keyword search or attribute filters. The Best Buy API uses a special search syntax embedded in the URL path. Use keyword search to find products by name, or attribute filters for precise queries. Examples: keyword search "laptop", attribute filter "name=ipad\*\&salePrice\<500", category filter "categoryPath.id=abcat0502000". Operators: = (equals), != (not equals), > \< >= \<= (comparison), in (list). Combine with & (AND) or \| (OR). Use \* as wildcard. |
| [`best-buy_search_stores`](#best-buy_search_stores) | Search Best Buy store locations by attribute filters or find nearby stores by ZIP code and radius. For nearby stores, use the area parameter with a ZIP code and mile radius (e.g., area "55423,10" finds stores within 10 miles of ZIP 55423). For attribute search, use filter with Best Buy query syntax (e.g., "region=MN", "city=Minneapolis", "storeType=Big Box"). |
***
## best-buy\_get\_also\_bought\_products
Get also-bought product recommendations
**Parameters:**
| Parameter | Type | Required | Default | Description |
| --------- | ------- | -------- | ------- | ------------------------------------------------- |
| `sku` | integer | Yes | — | The product SKU number to get recommendations for |
```json theme={null}
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID for the authenticated connection"
},
"sku": {
"type": "integer",
"description": "The product SKU number to get recommendations for"
}
},
"required": [
"PCID",
"sku"
]
}
```
***
## best-buy\_get\_also\_viewed\_products
Get also-viewed product recommendations
**Parameters:**
| Parameter | Type | Required | Default | Description |
| --------- | ------- | -------- | ------- | ------------------------------------------------- |
| `sku` | integer | Yes | — | The product SKU number to get recommendations for |
```json theme={null}
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID for the authenticated connection"
},
"sku": {
"type": "integer",
"description": "The product SKU number to get recommendations for"
}
},
"required": [
"PCID",
"sku"
]
}
```
***
## best-buy\_get\_most\_viewed\_products
Get most-viewed products by category
**Parameters:**
| Parameter | Type | Required | Default | Description |
| ------------ | ------ | -------- | ------- | -------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `categoryId` | string | Yes | — | The category ID to get most-viewed products for (e.g., 'abcat0502000' for Desktops & All-in-Ones). Use the listCategories endpoint to find category IDs. |
```json theme={null}
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID for the authenticated connection"
},
"categoryId": {
"type": "string",
"description": "The category ID to get most-viewed products for (e.g., 'abcat0502000' for Desktops & All-in-Ones). Use the listCategories endpoint to find category IDs."
}
},
"required": [
"PCID",
"categoryId"
]
}
```
***
## best-buy\_get\_product
Get product by SKU
**Parameters:**
| Parameter | Type | Required | Default | Description |
| --------- | ------- | -------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------- |
| `sku` | integer | Yes | — | The Best Buy product SKU number (e.g., 8880044) |
| `show` | string | No | — | Comma-separated list of product attributes to return. Use 'all' for all attributes. Example: 'sku,name,salePrice,regularPrice,onSale,description' |
```json theme={null}
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID for the authenticated connection"
},
"sku": {
"type": "integer",
"description": "The Best Buy product SKU number (e.g., 8880044)"
},
"show": {
"type": "string",
"description": "Comma-separated list of product attributes to return. Use 'all' for all attributes. Example: 'sku,name,salePrice,regularPrice,onSale,description'"
}
},
"required": [
"PCID",
"sku"
]
}
```
***
## best-buy\_get\_product\_store\_availability
Get product store availability
**Parameters:**
| Parameter | Type | Required | Default | Description |
| ------------ | ------- | -------- | ------- | --------------------------------------------------------------- |
| `sku` | integer | Yes | — | The product SKU number |
| `postalCode` | string | No | — | 5-digit ZIP/postal code to find nearby stores with availability |
| `storeId` | string | No | — | Specific store ID to check availability at |
```json theme={null}
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID for the authenticated connection"
},
"sku": {
"type": "integer",
"description": "The product SKU number"
},
"postalCode": {
"type": "string",
"description": "5-digit ZIP/postal code to find nearby stores with availability"
},
"storeId": {
"type": "string",
"description": "Specific store ID to check availability at"
}
},
"required": [
"PCID",
"sku"
]
}
```
***
## best-buy\_get\_product\_warranties
Get product warranties
**Parameters:**
| Parameter | Type | Required | Default | Description |
| --------- | ------- | -------- | ------- | ---------------------- |
| `sku` | integer | Yes | — | The product SKU number |
```json theme={null}
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID for the authenticated connection"
},
"sku": {
"type": "integer",
"description": "The product SKU number"
}
},
"required": [
"PCID",
"sku"
]
}
```
***
## best-buy\_get\_trending\_products
Get trending products by category
**Parameters:**
| Parameter | Type | Required | Default | Description |
| ------------ | ------ | -------- | ------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- |
| `categoryId` | string | Yes | — | The category ID to get trending products for (e.g., 'abcat0502000' for Desktops & All-in-Ones). Use the listCategories endpoint to find category IDs. |
```json theme={null}
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID for the authenticated connection"
},
"categoryId": {
"type": "string",
"description": "The category ID to get trending products for (e.g., 'abcat0502000' for Desktops & All-in-Ones). Use the listCategories endpoint to find category IDs."
}
},
"required": [
"PCID",
"categoryId"
]
}
```
***
## best-buy\_get\_viewed\_ultimately\_bought\_products
Get viewed-ultimately-bought recommendations
**Parameters:**
| Parameter | Type | Required | Default | Description |
| --------- | ------- | -------- | ------- | ------------------------------------------------- |
| `sku` | integer | Yes | — | The product SKU number to get recommendations for |
```json theme={null}
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID for the authenticated connection"
},
"sku": {
"type": "integer",
"description": "The product SKU number to get recommendations for"
}
},
"required": [
"PCID",
"sku"
]
}
```
***
## best-buy\_list\_categories
List product categories
**Parameters:**
| Parameter | Type | Required | Default | Description |
| ---------- | ------- | -------- | ------- | -------------------------------------------------------------------- |
| `show` | string | No | — | Comma-separated list of attributes to return. Example: 'id,name,url' |
| `pageSize` | integer | No | — | Number of results per page (max 100, default 10) |
| `page` | integer | No | — | Page number to retrieve |
```json theme={null}
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID for the authenticated connection"
},
"show": {
"type": "string",
"description": "Comma-separated list of attributes to return. Example: 'id,name,url'"
},
"pageSize": {
"type": "integer",
"description": "Number of results per page (max 100, default 10)"
},
"page": {
"type": "integer",
"description": "Page number to retrieve"
}
},
"required": [
"PCID"
]
}
```
***
## best-buy\_list\_stores
List Best Buy stores
**Parameters:**
| Parameter | Type | Required | Default | Description |
| ---------- | ------- | -------- | ------- | -------------------------------------------------------------------------------------------------- |
| `show` | string | No | — | Comma-separated list of attributes to return. Example: 'storeId,name,city,region,postalCode,phone' |
| `pageSize` | integer | No | — | Number of results per page (max 100, default 10) |
| `page` | integer | No | — | Page number to retrieve |
```json theme={null}
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID for the authenticated connection"
},
"show": {
"type": "string",
"description": "Comma-separated list of attributes to return. Example: 'storeId,name,city,region,postalCode,phone'"
},
"pageSize": {
"type": "integer",
"description": "Number of results per page (max 100, default 10)"
},
"page": {
"type": "integer",
"description": "Page number to retrieve"
}
},
"required": [
"PCID"
]
}
```
***
## best-buy\_search\_products
Search Best Buy products using keyword search or attribute filters. The Best Buy API uses a special search syntax embedded in the URL path. Use keyword search to find products by name, or attribute filters for precise queries. Examples: keyword search "laptop", attribute filter "name=ipad\*\&salePrice\<500", category filter "categoryPath.id=abcat0502000". Operators: = (equals), != (not equals), > \< >= \<= (comparison), in (list). Combine with & (AND) or | (OR). Use \* as wildcard.
**Parameters:**
| Parameter | Type | Required | Default | Description |
| ---------- | ------- | -------- | ------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `keyword` | string | No | — | Keyword to search for across product name, description, and other text fields. Example: "laptop", "iphone 15". Uses the search= parameter. |
| `filter` | string | No | — | Attribute-based filter expression using Best Buy query syntax. Example: "name=ipad\*\&salePrice\<500", "categoryPath.id=abcat0502000\&onSale=true", "manufacturer=Apple\&salePrice\<=1000". Do not URL-encode operators or spaces. Exception: if a filter value itself contains a literal ampersand (rare), pre-encode it as %26 so it is not treated as the AND combinator. |
| `show` | string | No | — | Comma-separated list of product attributes to return. Use 'all' for all attributes. Example: 'sku,name,salePrice,regularPrice,onSale,manufacturer,image' |
| `sort` | string | No | — | Sort results by attribute. Use 'attribute.asc' or 'attribute.dsc'. Example: 'salePrice.asc', 'customerReviewAverage.dsc' |
| `pageSize` | integer | No | — | Number of results per page (max 100, default 10) |
| `page` | integer | No | — | Page number to retrieve |
```json theme={null}
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID for the authenticated connection"
},
"keyword": {
"type": "string",
"description": "Keyword to search for across product name, description, and other text fields. Example: \"laptop\", \"iphone 15\". Uses the search= parameter."
},
"filter": {
"type": "string",
"description": "Attribute-based filter expression using Best Buy query syntax. Example: \"name=ipad*&salePrice<500\", \"categoryPath.id=abcat0502000&onSale=true\", \"manufacturer=Apple&salePrice<=1000\". Do not URL-encode operators or spaces. Exception: if a filter value itself contains a literal ampersand (rare), pre-encode it as %26 so it is not treated as the AND combinator."
},
"show": {
"type": "string",
"description": "Comma-separated list of product attributes to return. Use 'all' for all attributes. Example: 'sku,name,salePrice,regularPrice,onSale,manufacturer,image'"
},
"sort": {
"type": "string",
"description": "Sort results by attribute. Use 'attribute.asc' or 'attribute.dsc'. Example: 'salePrice.asc', 'customerReviewAverage.dsc'"
},
"pageSize": {
"type": "integer",
"description": "Number of results per page (max 100, default 10)"
},
"page": {
"type": "integer",
"description": "Page number to retrieve"
}
},
"required": [
"PCID"
]
}
```
***
## best-buy\_search\_stores
Search Best Buy store locations by attribute filters or find nearby stores by ZIP code and radius. For nearby stores, use the area parameter with a ZIP code and mile radius (e.g., area "55423,10" finds stores within 10 miles of ZIP 55423). For attribute search, use filter with Best Buy query syntax (e.g., "region=MN", "city=Minneapolis", "storeType=Big Box").
**Parameters:**
| Parameter | Type | Required | Default | Description |
| ---------- | ------- | -------- | ------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `area` | string | No | — | Find stores near a location. Format: "postalCode,radiusInMiles". Example: "55423,10" finds stores within 10 miles of ZIP 55423. Can also use lat/lng: "44.882942,-93.2775,10". |
| `filter` | string | No | — | Attribute-based filter expression. Example: "region=MN", "city=Minneapolis\&storeType=Big Box", "postalCode=55423". Do not URL-encode operators or spaces. Exception: if a filter value itself contains a literal ampersand (rare), pre-encode it as %26 so it is not treated as the AND combinator. |
| `show` | string | No | — | Comma-separated list of store attributes to return. Example: 'storeId,name,address,city,region,postalCode,phone,hours,distance' |
| `pageSize` | integer | No | — | Number of results per page (max 100, default 10) |
| `page` | integer | No | — | Page number to retrieve |
```json theme={null}
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID for the authenticated connection"
},
"area": {
"type": "string",
"description": "Find stores near a location. Format: \"postalCode,radiusInMiles\". Example: \"55423,10\" finds stores within 10 miles of ZIP 55423. Can also use lat/lng: \"44.882942,-93.2775,10\"."
},
"filter": {
"type": "string",
"description": "Attribute-based filter expression. Example: \"region=MN\", \"city=Minneapolis&storeType=Big Box\", \"postalCode=55423\". Do not URL-encode operators or spaces. Exception: if a filter value itself contains a literal ampersand (rare), pre-encode it as %26 so it is not treated as the AND combinator."
},
"show": {
"type": "string",
"description": "Comma-separated list of store attributes to return. Example: 'storeId,name,address,city,region,postalCode,phone,hours,distance'"
},
"pageSize": {
"type": "integer",
"description": "Number of results per page (max 100, default 10)"
},
"page": {
"type": "integer",
"description": "Page number to retrieve"
}
},
"required": [
"PCID"
]
}
```