API Reference
Use Crawlora's Best Buy API endpoints to extract supported public Best Buy data as structured JSON. This documentation covers 11 active endpoints including Get Best Buy's full brand directory, Get Best Buy's top-level shopping departments, Get Best Buy's fine-grained trending product-type categories, Get a Best Buy category's product listing, and related APIs. Developers can use these endpoints for monitoring, enrichment, research dashboards, internal data pipelines, and agent-native workflows without maintaining platform-specific scraping code. Each endpoint page documents authentication, request parameters such as category_id, sku, q, state, cURL examples, response examples, response schemas, errors, credit cost, and Playground testing. Send requests to the Crawlora API with an x-api-key header, review usage and plan limits on pricing, and test safe sample requests in Playground before moving the workflow into production.
Choose an endpoint, send an authenticated request with the x-api-key header, and inspect the normalized JSON response. The examples below use the public Crawlora API base URL and the same endpoint catalog used by Playground.
curl -X GET "https://api.crawlora.net/api/v1/bestbuy/search?q=coffee&page=1" \
-H "x-api-key: $CRAWLORA_API_KEY"These endpoint cards are generated from the active Crawlora endpoint catalog, including method, path, auth mode, credit cost, parameter summary, docs, and Playground links.
/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.
Required params: None
/bestbuy/categoriesapiKey5 credits/requestReturns Best Buy's top-level shopping departments (name, category id, url), sourced from the homepage's own category carousel. Each id is directly usable as bestbuy_category's category_id input.
Required params: None
/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' ~25 top-level departments. Each id is directly usable as bestbuy_category's category_id input.
Required params: None
/bestbuy/categoryapiKey8 credits/requestReturns one page (up to 24) of one Best Buy category's normalized 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 params: category_id:query
/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 params: category_id:query
/bestbuy/productapiKey5 credits/requestReturns one Best Buy product's normalized detail (name, brand, model, color, price, availability, rating, images, breadcrumbs), sourced from the product page's own schema.org Product structured-data block. sku is the numeric Best Buy SKU shown on bestbuy.com product pages and URLs.
Required params: sku:query
/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 params: sku:query
/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 params: sku:query
/bestbuy/product/reviewsapiKey8 credits/requestReturns page 1 (up to 20) of one Best Buy product's normalized customer reviews (rating, title, text, author, posted date, tags such as Verified Purchaser, recommended flag, helpful/unhelpful counts), sourced from the product's dedicated reviews page. sku is the numeric Best Buy SKU shown on bestbuy.com product pages and URLs.
Required params: sku:query
/bestbuy/searchapiKey8 credits/requestReturns one page (up to 24) of one Best Buy keyword search's normalized 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 params: q:query
/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 params: state:query, city:query
| Endpoint | API path | Method | Credits | Required params | Docs | Playground |
|---|---|---|---|---|---|---|
| Get Best Buy's full brand directory | /bestbuy/brands | GET | 5 credits/request | None | View docs | Try endpoint |
| Get Best Buy's top-level shopping departments | /bestbuy/categories | GET | 5 credits/request | None | View docs | Try endpoint |
| Get Best Buy's fine-grained trending product-type categories | /bestbuy/categories/trending | GET | 5 credits/request | None | View docs | Try endpoint |
| Get a Best Buy category's product listing | /bestbuy/category | GET | 8 credits/request | category_id:query | View docs | Try endpoint |
| Get a Best Buy category's own sibling/child categories | /bestbuy/category/subcategories | GET | 5 credits/request | category_id:query | View docs | Try endpoint |
| Get a Best Buy product's detail | /bestbuy/product | GET | 5 credits/request | sku:query | View docs | Try endpoint |
| Get a Best Buy product's customer questions and answers | /bestbuy/product/questions | GET | 5 credits/request | sku:query | View docs | Try endpoint |
| Get a Best Buy product's related products | /bestbuy/product/related | GET | 5 credits/request | sku:query | View docs | Try endpoint |
| Get a Best Buy product's customer reviews | /bestbuy/product/reviews | GET | 8 credits/request | sku:query | View docs | Try endpoint |
| Search Best Buy's product catalog | /bestbuy/search | GET | 8 credits/request | q:query | View docs | Try endpoint |
| Get Best Buy's physical stores in one city | /bestbuy/stores | GET | 3 credits/request | state:query, city:query | View docs | Try endpoint |