Bowmark AIdocs

Best Buy

Best Buy's own documented Products API (api.bestbuy.com) — searches the live bestbuy.com catalog by query and returns price, availability and review data,…

Best Buy's own documented Products API (api.bestbuy.com) — searches the live bestbuy.com catalog by query and returns price, availability and review data, and looks up one product by Best Buy's own SKU, without scraping bestbuy.com's search page.

Domain: bestbuy.com

Also known as: Best Buy, BestBuy, bestbuy.com, Best Buy Co., Inc.

Prefer the capability

bowmark.retail covers this provider and routes around it when it is having a bad day. Reach for this page when you need bestbuy.com specifically.

Call it directly

bowmark.providers.bestbuy.search(args: string | { query: string; pageSize?: number }): Promise<bestbuyProduct[]>
bowmark.providers.bestbuy.getProduct(sku: string | number): Promise<bestbuyProduct>

Functions

FunctionWhat it does
searchRuns a Best Buy product search the way bestbuy.com's own search box does, via Best Buy's documented Products API, and returns the matching products — name, sale/regular price, online and…
getProductLooks up one product by Best Buy's own numeric SKU (the id search's rows carry) and returns its full detail — the same fields as search. Requires a Best Buy developer API key — see this…

Types

interface bestbuyProduct {
  sku: number;
  name: string;
  salePrice: number | null;
  regularPrice: number | null;
  url: string | null;
  imageUrl: string | null;
  onlineAvailability: boolean;
  inStoreAvailability: boolean;
  manufacturer: string | null;
  modelNumber: string | null;
  upc: string | null;
  customerReviewAverage: number | null;
  customerReviewCount: number | null;
}

Examples

const products = await bowmark.providers.bestbuy.search("laptop");
// products[0] -> { sku: 6418599, name: "Apple - MacBook Air 13-inch …",
//                   salePrice: 999.99, regularPrice: 1099.99, onlineAvailability: true, … }
const product = await bowmark.providers.bestbuy.getProduct(6418599);
// product -> { sku: 6418599, name: "Apple - MacBook Air 13-inch …", … }
retailRetail (general merchandise, multi-store) — the capability this provider backs.
targetAlso backs the same capability.
walmartAlso backs the same capability.