API Reference
Extract Best Buy category and search listings, product detail, reviews, customer questions, and related products as structured JSON. 11 endpoints documented below.
curl -X GET "https://api.crawlora.net/api/v1/bestbuy/search?q=laptop&page=1" \
-H "x-api-key: $CRAWLORA_API_KEY"Best Buy's public catalog spans department categories and free-text search, each paginated. Crawlora returns the listing itself plus, for any product, its full detail, reviews, customer Q&A, and the organic products shown in its own comparison table. A pull on 2026-10-27 listed 330 brands and returned only 5 homepage categories, so the brand directory is the deeper index.
Pass a Best Buy category id to /bestbuy/category, or free-text keywords to /bestbuy/search, both with an optional page.
Increment page to collect further pages of the same category or search listing (up to 24 products per page).
Pass a sku from a listing result to /bestbuy/product for name, brand, price, availability, rating, images, and breadcrumbs.
Use the same sku against /bestbuy/product/reviews, /bestbuy/product/questions, and /bestbuy/product/related for customer reviews, Q&A, and organic related products.
brands returned 330 entries with a category-style id such as pcmcat1596746025285 for Best Buy Brands, plus a URL. Use these ids with the category route.
categories returned 5 entries, the first named Him (id pcmcat1722626510773), which reads like a homepage shortcut. Use the category and subcategories routes for depth.
/bestbuy/brandsapiKey5 credits/requestReturns Best Buy's full brand directory (name, category id, url), sourced from the site's own "Name Brands" page. Each id is directly usable as bestbuy_category's category_id input.
Takes no parameters.
Sampled 14 Oct 2026: 328 items. Filled in every item: id, name, url. In the sample: name: “Best Buy Brands” and 327 other values; url: bestbuy.com.
/bestbuy/categoriesapiKey5 credits/requestReturns Best Buy's current top-level Shop departments (name, category id, url). Each id is directly usable as bestbuy_category's category_id input; this is not the full category tree.
Takes no parameters.
Sampled 14 Oct 2026: 21 items. Filled in every item: id, name, url. In the sample: name: “TV & Home Theater” and 20 other values; url: bestbuy.com.
/bestbuy/categories/trendingapiKey5 credits/requestReturns Best Buy's fine-grained, often deeply-nested product-type categories (e.g. "Windows Laptops", "55-Inch TVs (55 - 64 in)", "PS5 Consoles") sourced from the homepage's own "Best Selling" section -- much more specific than bestbuy_categories' 21 current top-level departments. Each id is directly usable as bestbuy_category's category_id input.
Takes no parameters.
/bestbuy/categoryapiKey8 credits/requestReturns one page (up to 24) of one Best Buy category's product listing (sku, title, url, image, price, rating, review count). category_id is a Best Buy category id, e.g. pcmcat138500050001, found in a category page URL's trailing <id>.c?id=<id> segment. page is the optional 1-indexed page number (defaults to 1); requesting a page past the last one returns an empty products list, not an error.
Required: category_id. Optional: page.
/bestbuy/category/subcategoriesapiKey5 credits/requestReturns a Best Buy category's own sibling/child category set (name, category id, url), sourced from that category page's own "Category" filter facet. Each id is directly usable as bestbuy_category's category_id input. category_id is a Best Buy category id, e.g. pcmcat138500050001, found in a category page URL's trailing <id>.c?id=<id> segment. A leaf category with no siblings returns an empty list, not an error.
Required: category_id.
Sampled 14 Oct 2026: 3 items. Filled in every item: id, name, url. In the sample: name: “2-in-1 Laptops” and 2 other values; url: bestbuy.com.
/bestbuy/productapiKey5 credits/requestReturns one Best Buy product's detail (name, brand, model, color, price, availability, rating, images, breadcrumbs). sku is the numeric Best Buy SKU shown on bestbuy.com product pages and URLs.
Required: sku.
/bestbuy/product/questionsapiKey5 credits/requestReturns the customer questions (with answers, when present) Best Buy embeds directly on a product's page: question text, answer text, who answered, and when. sku is the numeric Best Buy SKU shown on bestbuy.com product pages and URLs. A product with no questions asked yet returns an empty list, not an error.
Required: sku.
Sampled 14 Oct 2026: 2 fields returned with a value, 1 empty (questions). In the sample: count: 0.
/bestbuy/product/relatedapiKey5 credits/requestReturns the organic (non-sponsored) related products Best Buy embeds in a product page's own comparison table (sku, name, url, image, price). sku is the numeric Best Buy SKU shown on bestbuy.com product pages and URLs. A product page with no comparison table returns an empty list, not an error.
Required: sku.
Sampled 14 Oct 2026: 2 fields returned with a value, 1 empty (products). In the sample: count: 0.
/bestbuy/product/reviewsapiKey8 credits/requestReturns page 1 (up to 20) of one Best Buy product's customer reviews (rating, title, text, author, posted date, tags such as Verified Purchaser, recommended flag, helpful/unhelpful counts). sku is the numeric Best Buy SKU shown on bestbuy.com product pages and URLs.
Required: sku.
/bestbuy/searchapiKey8 credits/requestReturns one page (up to 24) of one Best Buy keyword search's product listing (sku, title, url, image, price, rating, review count). q is free-text search keywords, e.g. "laptop". page is the optional 1-indexed page number (defaults to 1); requesting a page past the last one returns an empty products list, not an error.
Required: q. Optional: page.
/bestbuy/storesapiKey3 credits/requestReturns Best Buy's physical store locations in one city (name, address, phone, coordinates, rating, hours), sourced from Best Buy's own SEO store directory. state is one of the 50 US state codes plus dc and pr: `al`, `ak`, `az`, `ar`, `ca`, `co`, `ct`, `de`, `dc`, `fl`, `ga`, `hi`, `id`, `il`, `in`, `ia`, `ks`, `ky`, `la`, `me`, `md`, `ma`, `mi`, `mn`, `ms`, `mo`, `mt`, `ne`, `nv`, `nh`, `nj`, `nm`, `ny`, `nc`, `nd`, `oh`, `ok`, `or`, `pa`, `pr`, `ri`, `sc`, `sd`, `tn`, `tx`, `ut`, `vt`, `va`, `wa`, `wv`, `wi`, `wy`. city is free text matched case-insensitively against that state's own directory (e.g. "Chicago").
Required: state, city.
Sampled 14 Oct 2026: 3 items. Filled in every item: name, address, city, state, postal_code, country, phone, latitude and 5 more. In the sample: rating: 4.1 to 4.2, median 4.13; name: “Best Buy”; url: stores.bestbuy.com; city: “Chicago”; state: “IL”; country: “US”; review_count: 2,112 to 4,258, median 3,659.
Results from the 7 days to 14 Oct 2026. Current status
| Endpoint | Request | Checks passed | Median response |
|---|---|---|---|
| Get Best Buy's full brand directory | GET /bestbuy/brands | 100% | 3.63 s |
| Get Best Buy's top-level shopping departments | GET /bestbuy/categories | 79.4% | 2.80 s |
| Get a Best Buy category's own sibling/child categories | GET /bestbuy/category/subcategories?category_id=pcmcat138500050001 | 100% | 33.62 s |
| Get a Best Buy product's customer questions and answers | GET /bestbuy/product/questions?sku=6673590 | 99.9% | 69.53 s |
| Get a Best Buy product's related products | GET /bestbuy/product/related?sku=6673590 | 100% | 69.38 s |
| Get Best Buy's physical stores in one city | GET /bestbuy/stores?city=Chicago&state=il | 99.9% | 9.25 s |