/best-buy | Type: Application | PCID required: Yes
Tools
| Tool | Description |
|---|---|
best-buy_get_also_bought_products | Get also-bought product recommendations |
best-buy_get_also_viewed_products | Get also-viewed product recommendations |
best-buy_get_most_viewed_products | Get most-viewed products by category |
best-buy_get_product | Get product by SKU |
best-buy_get_product_store_availability | Get product store availability |
best-buy_get_product_warranties | Get product warranties |
best-buy_get_trending_products | Get trending products by category |
best-buy_get_viewed_ultimately_bought_products | Get viewed-ultimately-bought recommendations |
best-buy_list_categories | List product categories |
best-buy_list_stores | List Best Buy stores |
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 | 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 |
Show inputSchema
Show inputSchema
{
"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 |
Show inputSchema
Show inputSchema
{
"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. |
Show inputSchema
Show inputSchema
{
"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’ |
Show inputSchema
Show inputSchema
{
"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 |
Show inputSchema
Show inputSchema
{
"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 |
Show inputSchema
Show inputSchema
{
"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. |
Show inputSchema
Show inputSchema
{
"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 |
Show inputSchema
Show inputSchema
{
"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 |
Show inputSchema
Show inputSchema
{
"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 |
Show inputSchema
Show inputSchema
{
"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 |
Show inputSchema
Show inputSchema
{
"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 |
Show inputSchema
Show inputSchema
{
"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"
]
}