API Reference
Use Crawlora's Best Buy API endpoints to extract supported public Best Buy data as structured JSON. This documentation covers 8 active endpoints including Get Best Buy's full brand directory, Get Best Buy's top-level shopping departments, Get a Best Buy category's product listing, Get a Best Buy product's detail, 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, 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/categoryapiKey5 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/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/reviewsapiKey5 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/searchapiKey5 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
| 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 a Best Buy category's product listing | /bestbuy/category | 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 | 5 credits/request | sku:query | View docs | Try endpoint |
| Search Best Buy's product catalog | /bestbuy/search | GET | 5 credits/request | q:query | View docs | Try endpoint |