# Best Buy Product & Price Scraper (`devilscrapes/bestbuy-price-scraper`) Actor Scrape Best Buy (bestbuy.com) product, price, discount, availability, seller, and rating data from category and product pages. Every row carries a stable sku\_id and a scrape-time captured\_at timestamp so you can diff price and availability across scheduled runs. - **URL**: https://apify.com/devilscrapes/bestbuy-price-scraper.md - **Developed by:** [DevilScrapes](https://apify.com/devilscrapes) (community) - **Categories:** E-commerce - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $2.40 / 1,000 results This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. - **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use). - **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`. - **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`. - **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`. - **Any other language** — the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README
Devil Scrapes mark ## Best Buy Product & Price Scraper **💰 $2.42 / 1 000 results**  ·  pay only for results  ·  no credit card to try *We do the dirty work so your dataset stays clean.* 😈 Scrape Best Buy (bestbuy.com) product, price, discount, availability, seller, and rating data from category pages. Every row carries a stable sku\_id and a scrape-time captured\_at timestamp so you can diff price and availability across scheduled runs.
*** ### 🎯 What this scrapes Point this Actor at one or more Best Buy category browse pages and it returns one clean row per SKU — current price, regular price, discount percent, savings amount, seller type (Best Buy vs. third-party marketplace), stock/pickup availability, and rating summary. Every row carries a stable `sku_id` and an explicit `captured_at` scrape-time timestamp, so scheduling repeat runs and diffing the dataset gives you a real price-history feed instead of a one-off snapshot. Built on `curl-cffi` with browser TLS impersonation against Best Buy's own JSON product payload — no fragile CSS-selector scraping. ### 🔥 What we handle for you - 🛡️ **Browser fingerprint rotation** — `curl-cffi` impersonates real Chrome / Firefox / Safari TLS handshakes so the target sees a browser, not Python. - 🌐 **Residential proxy rotation** via Apify Proxy — fresh session and exit IP on every block. - 🔁 **Retries with exponential backoff** on `408 / 429 / 5xx` — up to 5 attempts per page, `Retry-After` honoured. - 🧱 **Rate-limit-aware pacing** — when the target pushes back, we slow down instead of getting banned. - 🧊 **Clean, typed dataset rows** — Pydantic-validated, ISO-8601 timestamps, stable IDs, JSON / CSV / Excel export straight from the Apify Console. - 💰 **Pay-Per-Event pricing** — you only pay for results that hit your dataset. No data, no charge. ### 💡 Use cases - **Price-drop monitoring** — schedule repeat runs against a category or SKU list and diff current\_price/discount\_percent across runs to catch deals the moment they land. - **Competitor price intelligence** — track how Best Buy prices a category over time versus your own catalog. - **Marketplace-vs-Best Buy mix analysis** — use seller\_type to see which listings are Best Buy-fulfilled vs. third-party marketplace sellers. - **Stock/availability alerting** — diff availability\_status and in\_store\_pickup\_eligible across scheduled runs for restock notifications. - **Catalog enrichment** — resolve a category into stable sku\_id-keyed rows with rating, review count, and model number in one schema. ### ⚙️ How to use it 1. Click **Try for free** at the top of the page. 2. Fill in the input form — most fields have sensible defaults. 3. Click **Start**. Output streams into the run's dataset. 4. Export from **Storage → Dataset** as JSON, CSV, or Excel — or fetch via the API. ### 📥 Input | Field | Type | Required | Default | Notes | |---|---|:--:|---|---| | `startUrls` | `array` | **yes** | \['https://www.bestbuy.com/site/laptop-computers/all-laptops/pcmcat138500050001.c?id=pcmcat138500050001'] | Best Buy category browse URLs, e.g.… | | `maxItems` | `integer` | no | 200 | Cap on the total number of product rows emitted this run. | | `proxyConfiguration` | `object` | no | {'useApifyProxy': True} | Apify Proxy spec. No forced residential group in v1 — both datacenter and residential tiers are confirmed to reach Best… | #### Example input ```json { "startUrls": [ "https://www.bestbuy.com/site/laptop-computers/all-laptops/pcmcat138500050001.c?id=pcmcat138500050001" ], "maxItems": 3, "proxyConfiguration": { "useApifyProxy": true } } ``` ### 📤 Output Every row is one dataset item. | Field | Type | Notes | |---|---|---| | `sku_id` | `string` | Best Buy SKU identifier. | | `product_name` | `string` | Short product name. | | `model_number` | `['string', 'null']` | Manufacturer model number. | | `product_url` | `string` | Canonical product detail page URL. | | `category_hint` | `['string', 'null']` | The startUrls entry this row was found under (traceability). | | `condition` | `string` | Product condition, e.g. new. | | `open_box_condition` | `['string', 'null']` | Open-box condition grade, if applicable. | | `current_price` | `number` | Current customer-facing USD price. | | `regular_price` | `['number', 'null']` | Displayable regular (pre-discount) USD price. | | `discount_percent` | `['number', 'null']` | Percent off regular price — sourced from the page, or computed when absent. | | `savings_amount` | `['number', 'null']` | Absolute USD savings versus regular price. | | `seller_type` | `string` | best\_buy (1P, sold by Best Buy) or marketplace (3P, third-party seller). | | `seller_id` | `['string', 'null']` | Seller identifier. | | `availability_status` | `string` | Fulfillment button text, e.g. Add to Cart or Sold Out. | | `in_store_pickup_eligible` | `['boolean', 'null']` | Whether in-store pickup is available for this SKU. | | `rating` | `['number', 'null']` | Average customer star rating. | | `review_count` | `['integer', 'null']` | Number of customer reviews. | | `upc` | `['string', 'null']` | Always null in v1 — UPC is absent from Best Buy's wire format. | | `captured_at` | `string` | ISO 8601 UTC scrape-time timestamp (not page-sourced). | #### Example output ```json { "sku_id": "6667474", "product_name": "HP - 14\" Laptop - Intel N150 Processor - 4GB Memory - 128GB UFS - Natural Silver", "model_number": "14-dq6101dx", "product_url": "https://www.bestbuy.com/product/hp-14-laptop-intel-n150-processor-4gb-memory-128gb-ufs-natural-silver/JJGW3FGFPZ/sku/6667474", "category_hint": "https://www.bestbuy.com/site/laptop-computers/all-laptops/pcmcat138500050001.c?id=pcmcat138500050001", "condition": "new", "open_box_condition": null, "current_price": 229.99, "regular_price": 349.99, "discount_percent": 34, "savings_amount": 120, "seller_type": "best_buy", "seller_id": "bby", "availability_status": "Add to Cart", "in_store_pickup_eligible": true, "rating": 4.4, "review_count": 294, "upc": null, "captured_at": "2026-08-06T14:32:07.512381+00:00" } ``` ### 💰 Pricing Pay-Per-Event — you pay only when these events fire: | Event | USD | What it is | |---|---:|---| | `actor-start` | $0.02 | One-off warm-up charge per run | | `result-scraped` | $0.0024 | Per unique dataset item | Example: 1 000 results at the rates above ≈ **$2.42**. No subscription, no minimum, no card to start — Apify gives every new account $5 of free credit. ### 🚧 Limitations US bestbuy.com storefront only — no Canada or other regional storefronts. Direct product-page (PDP) URLs are not supported; supply category browse URLs. UPC is always null (absent from the source data). No free-text keyword search (?st= URLs are robots-disallowed and skipped). Category pagination is capped at cp=2-cp=5 per robots.txt (max ~5 pages per category per run). Review text/author/date is out of scope — only the aggregate rating and review count are included. Historical price trend charts are not built in — diff captured\_at-stamped rows across scheduled runs yourself. ### ❓ FAQ **Does this cover bestbuy.ca or other storefronts?** No — bestbuy.com (US) only in v1. See Limitations. **Does it return historical price charts?** No — each run is a point-in-time snapshot. Schedule repeat runs and diff rows by sku\_id yourself for a time series; the explicit captured\_at timestamp is designed for exactly this. **Why is upc always null?** Best Buy's underlying product data does not expose a UPC field on the pages this Actor reads — it's always null rather than a guess. **Can I pass a direct product page instead of a category page?** No — direct product-page (PDP) URLs are not supported. Best Buy's PDPs reset the connection on direct fetch independent of proxy or geography, so the Actor skips them with a clear error rather than silently returning nothing. Supply a category browse URL instead. **Does it search by keyword?** No — Best Buy's free-text keyword search path is disallowed by robots.txt and is deliberately never used. Supply category or product URLs instead. ### 💬 Your feedback Spotted a bug, hit a weird edge case, or need a new field? Open an issue on the Actor's **Issues** tab on Apify Console — we ship fixes weekly and we read every report. ***
Built by **[Devil Scrapes](https://apify.com/DevilScrapes)** 😈 — a small fleet of opinionated public-data Actors. Honest pricing, real engineering, zero fine print.
# Actor input Schema ## `startUrls` (type: `array`): Best Buy category browse URLs, e.g. bestbuy.com/site/\/\/\.c?id=\. Direct product (PDP) URLs are not supported — bestbuy.com resets the connection on direct PDP fetches. ## `maxItems` (type: `integer`): Cap on the total number of product rows emitted this run. ## `proxyConfiguration` (type: `object`): Apify Proxy spec. No forced residential group in v1 — both datacenter and residential tiers are confirmed to reach Best Buy successfully. The exit country is always pinned to the US regardless of any country set here, since bestbuy.com serves a country-selector page (not product data) to non-US exits. ## Actor input object example ```json { "startUrls": [ "https://www.bestbuy.com/site/laptop-computers/all-laptops/pcmcat138500050001.c?id=pcmcat138500050001" ], "maxItems": 200, "proxyConfiguration": { "useApifyProxy": true } } ``` # Actor output Schema ## `datasetItems` (type: `string`): All dataset items as JSON. ## `datasetItemsCsv` (type: `string`): Same data exported to CSV. ## `datasetView` (type: `string`): Open the run dataset in the Console. # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "startUrls": [ "https://www.bestbuy.com/site/laptop-computers/all-laptops/pcmcat138500050001.c?id=pcmcat138500050001" ], "maxItems": 200, "proxyConfiguration": { "useApifyProxy": true } }; // Run the Actor and wait for it to finish const run = await client.actor("devilscrapes/bestbuy-price-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "startUrls": ["https://www.bestbuy.com/site/laptop-computers/all-laptops/pcmcat138500050001.c?id=pcmcat138500050001"], "maxItems": 200, "proxyConfiguration": { "useApifyProxy": True }, } # Run the Actor and wait for it to finish run = client.actor("devilscrapes/bestbuy-price-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "startUrls": [ "https://www.bestbuy.com/site/laptop-computers/all-laptops/pcmcat138500050001.c?id=pcmcat138500050001" ], "maxItems": 200, "proxyConfiguration": { "useApifyProxy": true } }' | apify call devilscrapes/bestbuy-price-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=devilscrapes/bestbuy-price-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification Download the OpenAPI definition: https://api.apify.com/v2/actors/y2NdzjhavtQ5TjdxM/builds/lBnQeicZUskF8bd4a/openapi.json