{"openapi":"3.1.0","info":{"title":"Best Buy (BYOK) API","version":"0.1.0","description":"Best Buy (BYOK) lets an AI assistant read your own Best Buy data through the Best Buy API with a key you supply (Best Buy developer API key). Read-only: 11 tools (search_products, get_product, list_categories, get_category, search_stores, find_stores_near, list_trending_products, list_most_viewed_products, list_also_viewed, list_also_bought, get_open_box_offers). The BYOK key travels with each...\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://byok-bestbuy.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"agent@connectorbay.com","url":"https://connectorbay.com/byok-bestbuy/docs"},"termsOfService":"https://connectorbay.com/byok-bestbuy/terms"},"servers":[{"url":"https://byok-bestbuy.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/byok-bestbuy/docs"},"security":[{"upstreamKey":[]}],"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","description":"Optional. A Pro API key raises rate limits; no credentials are required."},"upstreamKey":{"type":"apiKey","in":"header","name":"X-Upstream-Key","description":"Your own key for the service this connector wraps (bring your own key). Used for that one call only; never stored, logged or cached."}},"schemas":{"Error":{"type":"object","properties":{"ok":{"const":false},"error":{"type":"object"}}}}},"paths":{"/v1/tools/search_products":{"post":{"operationId":"search_products","summary":"Keyword search of the Best Buy product catalog (name, manufacturer and descriptions) with price, reviews and availabilit","description":"Keyword search of the Best Buy product catalog (name, manufacturer and descriptions) with price, reviews and availability. Use a single word per search; results come 10 per page by default. Use for \"Which Best Buy products match the keyword 'oven' and what do they cost\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"term":{"description":"One search word, for example 'oven' or 'camera' (letters and digits).","maxLength":200,"title":"Term","type":"string"},"show":{"anyOf":[{"maxLength":300,"type":"string"},{"type":"null"}],"default":"sku,name,manufacturer,salePrice,regularPrice,onSale,customerReviewAverage,customerReviewCount,inStoreAvailability,onlineAvailability,url","description":"Comma-separated product attributes to return.","title":"Show"},"sort":{"anyOf":[{"maxLength":60,"type":"string"},{"type":"null"}],"default":null,"description":"Sort expression such as 'salePrice.asc' or 'customerReviewAverage.dsc'.","title":"Sort"},"page_size":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":10,"description":"How many results to return per page (1 to 100).","title":"Page Size"},"page":{"anyOf":[{"maximum":100000,"minimum":1,"type":"integer"},{"type":"null"}],"default":1,"description":"Page number, starting at 1.","title":"Page"},"format":{"anyOf":[{"const":"json","type":"string"},{"type":"null"}],"default":"json","description":"Response format; only json is supported here.","title":"Format"}},"required":["term"],"title":"search_productsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_product":{"post":{"operationId":"get_product","summary":"Get one Best Buy product by SKU with name, manufacturer, price, sale status, reviews and availability. Use for \"What is ","description":"Get one Best Buy product by SKU with name, manufacturer, price, sale status, reviews and availability. Use for \"What is the price and review score of Best Buy SKU 8880044\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"sku":{"description":"Best Buy product SKU, digits only, for example '6323759'.","maxLength":200,"title":"Sku","type":"string"},"show":{"anyOf":[{"maxLength":300,"type":"string"},{"type":"null"}],"default":"sku,name,manufacturer,salePrice,regularPrice,onSale,customerReviewAverage,customerReviewCount,inStoreAvailability,onlineAvailability,url","description":"Comma-separated product attributes to return.","title":"Show"}},"required":["sku"],"title":"get_productArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_categories":{"post":{"operationId":"list_categories","summary":"List Best Buy categories with id, name and web page, paged (up to 100 per page). Use for \"What Best Buy product categori","description":"List Best Buy categories with id, name and web page, paged (up to 100 per page). Use for \"What Best Buy product categories exist\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"show":{"anyOf":[{"maxLength":100,"type":"string"},{"type":"null"}],"default":"id,name,url","description":"Comma-separated category attributes to return.","title":"Show"},"page_size":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":10,"description":"How many results to return per page (1 to 100).","title":"Page Size"},"page":{"anyOf":[{"maximum":100000,"minimum":1,"type":"integer"},{"type":"null"}],"default":1,"description":"Page number, starting at 1.","title":"Page"},"format":{"anyOf":[{"const":"json","type":"string"},{"type":"null"}],"default":"json","description":"Response format; only json is supported here.","title":"Format"}},"title":"list_categoriesArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_category":{"post":{"operationId":"get_category","summary":"Get one Best Buy category by id with its name, web page, path from the root and subcategories. Use for \"What are the sub","description":"Get one Best Buy category by id with its name, web page, path from the root and subcategories. Use for \"What are the subcategories of Best Buy category abcat0400000\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"category_id":{"description":"Best Buy category id such as 'abcat0400000' (get ids from list_categories or search_categories).","maxLength":200,"title":"Category Id","type":"string"},"format":{"anyOf":[{"const":"json","type":"string"},{"type":"null"}],"default":"json","description":"Response format; only json is supported here.","title":"Format"}},"required":["category_id"],"title":"get_categoryArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/search_stores":{"post":{"operationId":"search_stores","summary":"Find Best Buy stores in a US ZIP code, with name, address, phone and hours. Use for \"Which Best Buy stores are in ZIP co","description":"Find Best Buy stores in a US ZIP code, with name, address, phone and hours. Use for \"Which Best Buy stores are in ZIP code 55423\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"postal_code":{"description":"Five-digit US ZIP code, for example '55423'.","maxLength":200,"title":"Postal Code","type":"string"},"page_size":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":10,"description":"How many results to return per page (1 to 100).","title":"Page Size"},"page":{"anyOf":[{"maximum":100000,"minimum":1,"type":"integer"},{"type":"null"}],"default":1,"description":"Page number, starting at 1.","title":"Page"},"format":{"anyOf":[{"const":"json","type":"string"},{"type":"null"}],"default":"json","description":"Response format; only json is supported here.","title":"Format"}},"required":["postal_code"],"title":"search_storesArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/find_stores_near":{"post":{"operationId":"find_stores_near","summary":"Find Best Buy stores within a distance in miles of a US ZIP code, nearest first. Use for \"Which Best Buy stores are with","description":"Find Best Buy stores within a distance in miles of a US ZIP code, nearest first. Use for \"Which Best Buy stores are within 10 miles of ZIP 55423\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"postal_code":{"description":"Five-digit US ZIP code at the center, for example '55423'.","maxLength":200,"title":"Postal Code","type":"string"},"distance":{"description":"Radius in miles, a whole number such as 10.","maximum":250,"minimum":1,"title":"Distance","type":"integer"},"page_size":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":10,"description":"How many results to return per page (1 to 100).","title":"Page Size"},"page":{"anyOf":[{"maximum":100000,"minimum":1,"type":"integer"},{"type":"null"}],"default":1,"description":"Page number, starting at 1.","title":"Page"},"format":{"anyOf":[{"const":"json","type":"string"},{"type":"null"}],"default":"json","description":"Response format; only json is supported here.","title":"Format"}},"required":["postal_code","distance"],"title":"find_stores_nearArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_trending_products":{"post":{"operationId":"list_trending_products","summary":"Top ten products trending on bestbuy.com in a category over a rolling three hours, by rank. Use for \"What is trending at","description":"Top ten products trending on bestbuy.com in a category over a rolling three hours, by rank. Use for \"What is trending at Best Buy in Cameras & Camcorders right now\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"category_id":{"description":"Best Buy category id such as 'abcat0400000' (get ids from list_categories or search_categories).","maxLength":200,"title":"Category Id","type":"string"}},"required":["category_id"],"title":"list_trending_productsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_most_viewed_products":{"post":{"operationId":"list_most_viewed_products","summary":"Most viewed products on bestbuy.com in a category, by rank. Use for \"What are the most viewed Best Buy products in categ","description":"Most viewed products on bestbuy.com in a category, by rank. Use for \"What are the most viewed Best Buy products in category abcat0107000\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"category_id":{"description":"Best Buy category id such as 'abcat0400000' (get ids from list_categories or search_categories).","maxLength":200,"title":"Category Id","type":"string"}},"required":["category_id"],"title":"list_most_viewed_productsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_also_viewed":{"post":{"operationId":"list_also_viewed","summary":"Products other shoppers also viewed after viewing a given Best Buy SKU. Use for \"What else do people view after looking ","description":"Products other shoppers also viewed after viewing a given Best Buy SKU. Use for \"What else do people view after looking at Best Buy SKU 8880044\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"sku":{"description":"Best Buy product SKU, digits only, for example '6323759'.","maxLength":200,"title":"Sku","type":"string"}},"required":["sku"],"title":"list_also_viewedArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_also_bought":{"post":{"operationId":"list_also_bought","summary":"Products other shoppers bought together with a given Best Buy SKU. Use for \"What do people buy together with Best Buy SK","description":"Products other shoppers bought together with a given Best Buy SKU. Use for \"What do people buy together with Best Buy SKU 8880044\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"sku":{"description":"Best Buy product SKU, digits only, for example '6323759'.","maxLength":200,"title":"Sku","type":"string"}},"required":["sku"],"title":"list_also_boughtArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_open_box_offers":{"post":{"operationId":"get_open_box_offers","summary":"Open box offers for one Best Buy SKU, with condition and discounted price for each offer. Use for \"Are there open box of","description":"Open box offers for one Best Buy SKU, with condition and discounted price for each offer. Use for \"Are there open box offers for Best Buy SKU 8610161\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"sku":{"description":"Best Buy product SKU, digits only, for example '6323759'.","maxLength":200,"title":"Sku","type":"string"}},"required":["sku"],"title":"get_open_box_offersArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}}}}