# Best Buy Product Scraper (`sian.agency/best-buy-product-scraper`) Actor Scrape Best Buy products โ€” price, ratings, reviews, images, specs & availability. Keyword or category search, full detail enrichment, clean JSON/CSV, no code. - **URL**: https://apify.com/sian.agency/best-buy-product-scraper.md - **Developed by:** [SIรN Oรœ](https://apify.com/sian.agency) (community) - **Categories:** E-commerce, Business - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $4.00 / 1,000 overview product extracteds This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. 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. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use 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 ## Best Buy Product Scraper โ€” Prices, Specs & Deals to JSON/CSV ๐Ÿš€ [![SIรN Agency Store](https://img.shields.io/badge/Store-SI%C3%81N%20Agency-1AE392)](https://apify.com/sian.agency?fpr=sian) [![Walmart Data Scraper](https://img.shields.io/badge/Store-Walmart%20Data%20Scraper-0071CE)](https://apify.com/sian.agency/walmart-data-scraper?fpr=sian) [![Amazon Product Scraper](https://img.shields.io/badge/Store-Amazon%20Product%20Scraper-FF9900)](https://apify.com/sian.agency/amazon-product-scraper?fpr=sian) [![Google Shopping Price Scraper](https://img.shields.io/badge/Store-Google%20Shopping%20Price%20Scraper-4285F4)](https://apify.com/sian.agency/google-shopping-price-scraper?fpr=sian) #### ๐ŸŽ‰ Turn any Best Buy search, category, or product page into a clean dataset โ€” SKUs, live prices, savings, ratings, and full specification tables in a single run. ##### Perfect for pricing analysts, competitor-monitoring teams, ecommerce sellers, and catalog researchers who need reliable Best Buy data without lifting a finger. --- ### ๐Ÿ“‹ Overview **The Best Buy Product Scraper turns bestbuy.com into structured data in seconds.** Search by keyword or category, or paste Best Buy product-listing (PLP) URLs, and get a clean JSON/CSV dataset with one row per product โ€” prices, promotions, ratings, availability, and complete specifications. No account, no API key, no setup. Just enter what you want, click Run, and download export-ready data for pricing intelligence, catalog research, and market analysis. **Why professionals choose us:** - โœ… **Zero Setup**: No Best Buy account or API key โ€” enter keywords and go - โšก **Fast Overview Mode**: Pull search-results data at scale (~18 products per results page) - ๐ŸŽฏ **Deep Detail Mode**: Enrich every product with a full specifications table (30โ€“90 rows), long description, and full image gallery - ๐Ÿ’ฐ **Pay-Per-Result Pricing**: Only pay for products you actually extract โ€” plus a free tier to test risk-free - ๐Ÿ’Ž **One Clean Record Per Product**: Overview and detail are merged into a single row โ€” no stitching, no duplicates - โœจ **NEW: Built-In Filters & Sorting**: Filter by brand, price band, and Top-Rated, and sort by price, best selling, top rated, or newest --- ### โœจ Features - ๐Ÿ” **Keyword & Category Search**: Find products by free-text search or Best Buy category IDs - ๐Ÿ”— **Paste PLP URLs**: Drop in any Best Buy product-listing URL and scrape it directly - โšก **Overview Mode**: Fast search-results extraction โ€” SKU, title, brand, price, savings, rating, availability, and more - ๐Ÿ“Š **Detail Mode**: Full spec sheet, long description, complete image gallery, model number, UPC, color, and breadcrumb category path - ๐Ÿท๏ธ **Complete Pricing Data**: Current price, regular/was price, savings amount, percent off, on-sale flag, and deal expiry - โญ **Ratings & Reviews**: Star rating and total review count for every product - ๐Ÿ“ฆ **Availability Intelligence**: In-stock status, availability, fulfillment, product condition, and seller - ๐ŸŽš๏ธ **Sorting & Filters**: Featured, Price lowโ†’high, Price highโ†’low, Best selling, Top rated, Newest โ€” plus brand, min/max price, and Top-Rated filters - ๐Ÿงพ **Identifiers for Feeds**: Model number, UPC, SKU, and product-family ID (bsin) ready for catalog matching - ๐Ÿ’พ **Clean JSON & CSV**: Export-ready dataset with one row per product, priced in USD --- ### ๐ŸŽฌ Quick Start Enter keywords, categories, or Best Buy PLP URLs, pick a mode, and click Run. Results land in your dataset ready to export. ```bash ## Run via API - one line curl -X POST https://api.apify.com/v2/acts/sian.agency~best-buy-product-scraper/runs?token=[YOUR_TOKEN] \ -d '{"keywords": ["laptop"], "scrapeMode": "overview"}' ```` *** ### ๐Ÿš€ Getting Started (3 Simple Steps) #### Step 1: Tell It What to Scrape Enter search keywords (e.g. `4k tv`, `gaming laptop`), add category IDs, or paste Best Buy product-listing URLs. Mix and match as needed. #### Step 2: Choose Mode & Filters Pick **Overview** (fast search-results data) or **Detail** (enriched with full specs). Optionally set a sort order, brand, min/max price, or Top-Rated filter. #### Step 3: Run & Download Click Run and download clean, structured data as JSON, CSV, or Excel โ€” ready for spreadsheets, databases, and analytics tools. **That's it! In minutes, you'll have:** - Live prices, regular/was prices, savings, and percent off - Ratings, review counts, images, and availability for every product - Full specification tables, descriptions, and identifiers (detail mode) - Clean export-ready data priced in USD, one row per product *** ### ๐Ÿ“ฅ Input Configuration | Field | Type | Required | Description | |-------|------|----------|-------------| | keywords | array | No | Free-text Best Buy searches (e.g. `"laptop"`, `"4k tv"`) | | categoryIds | array | No | Best Buy category IDs to scrape (advanced) | | urls | array | No | Best Buy product-listing (PLP) URLs to scrape directly | | scrapeMode | string | No | `overview` (fast) or `detail` (enriched with full specs) | | sort | string | No | Featured, Price lowโ†’high, Price highโ†’low, Best selling, Top rated, Newest | | brand | string | No | Limit results to a single brand | | minPrice | number | No | Minimum price band (USD) | | maxPrice | number | No | Maximum price band (USD) | | topRated | boolean | No | Only return Top-Rated products | | maxResults | integer | No | Maximum number of products to return | **Example โ€” keyword search, detail mode:** ```json { "keywords": ["gaming laptop"], "scrapeMode": "detail", "sort": "Top rated", "brand": "ASUS", "minPrice": 800, "maxPrice": 2000, "topRated": true, "maxResults": 100 } ``` **Example โ€” scrape product-listing URLs:** ```json { "urls": [ "https://www.bestbuy.com/site/laptops/all-laptops/pcmcat138500050001.c", "https://www.bestbuy.com/site/tvs/4k-ultra-hd-tvs/pcmcat333800050000.c" ], "scrapeMode": "overview" } ``` *** ### ๐Ÿ“ค Output Results are saved to the Apify dataset with **30+ fields per product**, one clean row each. In detail mode, the overview row is enriched in place with specs, gallery, and identifiers โ€” no separate records to merge. | Field | Type | Description | |-------|------|-------------| | sku | string | Best Buy SKU (unique product ID) | | productTitle | string | Full product name | | brand | string | Manufacturer / brand | | price | number | Current price (USD) | | regular\_price | number | Regular / was price (USD) | | savings | number | Amount saved vs. regular price | | savings\_percent | number | Percent off | | on\_sale | boolean | Whether the product is currently on sale | | rating | number | Average star rating | | review\_count | number | Total number of reviews | | in\_stock | boolean | Whether the product is currently in stock | | availability | string | Availability / delivery status | | condition | string | New, open-box, refurbished, etc. | | model\_number | string | Manufacturer model number (detail) | | upc | string | UPC barcode (detail) | | specs | object | Full specifications table, 30โ€“90 rows (detail) | | images | array | Full product image gallery (detail) | **Full example (detail mode):** ```json { "thumbnail": "https://pisces.bbystatic.com/image.jpg", "sku": "6535401", "productTitle": "ASUS - ROG Zephyrus 16\" Gaming Laptop", "url": "https://www.bestbuy.com/site/.../6535401.p", "source": "detail", "brand": "ASUS", "bsin": "pcmcat138500050001", "model_number": "GU603ZM-211.ZG16", "upc": "195553771016", "color": "Off Black", "price": 1499.99, "regular_price": 1799.99, "savings": 300.00, "savings_percent": 17, "currency": "USD", "on_sale": true, "deal_expires": "2026-07-20", "rating": 4.7, "review_count": 1284, "images": ["https://pisces.bbystatic.com/1.jpg", "https://pisces.bbystatic.com/2.jpg"], "image_count": 8, "in_stock": true, "availability": "Available to ship", "fulfillment": "Ships in 1-2 days", "condition": "New", "seller": "Best Buy", "category": "Laptops", "subcategory": "Gaming Laptops", "breadcrumbs": ["Computers & Tablets", "Laptops", "Gaming Laptops"], "what_it_is": "16-inch gaming laptop with RTX graphics", "description": "Power through demanding games and creative workloads...", "features": ["QHD 165Hz display", "RTX 3060 GPU", "16GB DDR5 RAM"], "specs": { "Processor": "Intel Core i7-12700H", "Memory": "16GB DDR5", "Storage": "1TB SSD", "Graphics": "NVIDIA GeForce RTX 3060", "Screen Size": "16 inches" }, "metadata": { "scrapedAt": "2026-07-14T10:30:00.000Z" } } ``` *** ### ๐Ÿ’ผ Use Cases & Examples #### 1. Price & Promo Monitoring **Retail and pricing teams tracking Best Buy prices and deals over time.** **Input:** Keywords or category IDs for your product lines **Output:** Current price, regular/was price, savings, percent off, on-sale flag, and deal expiry **Use:** Detect price drops and promotions the moment they go live and react faster. #### 2. Competitor Pricing Intelligence **Brands and sellers benchmarking their catalog against Best Buy.** **Input:** SKUs, brands, or category URLs you compete on **Output:** Live prices, ratings, and availability per product **Use:** Build a repricing feed and stay competitive without manual checks. #### 3. Catalog & Assortment Research **Category managers mapping what Best Buy carries in a niche.** **Input:** Category IDs or PLP URLs, overview mode **Output:** Full product lists with SKU, brand, price, and rating **Use:** Understand assortment breadth, brand mix, and price distribution at a glance. #### 4. In-Stock & Availability Checks **Resellers and dropshippers monitoring stock and fulfillment.** **Input:** Keywords or URLs for the products you source **Output:** In-stock status, availability, fulfillment, condition, and seller **Use:** Only list what's actually available and avoid overselling. #### 5. Product-Spec Extraction for Feeds **Ecommerce and feed teams enriching product catalogs.** **Input:** Product URLs or keywords, detail mode **Output:** Full specification tables, descriptions, model number, UPC, color, and image gallery **Use:** Populate product feeds and comparison pages with rich, accurate specs. #### 6. Market & Demand Research **Analysts studying demand signals across electronics categories.** **Input:** Category IDs sorted by Best selling or Top rated **Output:** Ratings, review counts, prices, and rankings **Use:** Identify best-sellers, top-rated products, and pricing trends by category. *** ### ๐Ÿ”— Integration Examples #### JavaScript/Node.js ```javascript import { ApifyClient } from 'apify-client'; const client = new ApifyClient({ token: 'YOUR_TOKEN' }); const run = await client.actor('sian.agency/best-buy-product-scraper').call({ keywords: ['gaming laptop'], scrapeMode: 'detail', maxResults: 100 }); const { items } = await client.dataset(run.defaultDatasetId).listItems(); console.log(items[0]); ``` #### Python ```python from apify_client import ApifyClient client = ApifyClient('YOUR_TOKEN') run = client.actor('sian.agency/best-buy-product-scraper').call( run_input={'keywords': ['gaming laptop'], 'scrapeMode': 'detail'} ) for item in client.dataset(run['defaultDatasetId']).iterate_items(): print(item) ``` #### cURL ```bash curl -X POST 'https://api.apify.com/v2/acts/sian.agency~best-buy-product-scraper/runs?token=YOUR_TOKEN' \ -H 'Content-Type: application/json' \ -d '{"keywords": ["gaming laptop"], "scrapeMode": "detail"}' ``` #### Automation Workflows (N8N / Zapier / Make) 1. **Trigger**: Schedule or webhook 2. **HTTP Request**: Call the actor API 3. **Process**: Handle the JSON product results 4. **Action**: Save to a database, update a pricing sheet, or send an alert *** ### ๐Ÿ“Š Performance & Pricing #### FREE Tier (Try It Now) - **Up to 25 products** per run โ€” full feature access, same data quality - No credit card required - Perfect for testing keywords, categories, and detail mode #### PAID Tier (Production Ready) - **Unlimited** products per run - Faster, at-scale extraction with no caps - **Pay-per-result**: you're only charged for products that are successfully extracted ๐Ÿ’ฐ **Fair, transparent pricing** โ€” pay for the products you get, nothing more. ๐Ÿ”— [View current pricing](https://apify.com/sian.agency/best-buy-product-scraper?fpr=sian) *** ### โ“ Frequently Asked Questions **Q: How many products can I scrape?** A: FREE tier: up to 25 products per run. PAID tier: unlimited. **Q: Do I need a Best Buy account or API key?** A: No. There's nothing to sign up for or configure โ€” just enter keywords, categories, or URLs and run. **Q: What's the difference between Overview and Detail mode?** A: Overview is the fast path โ€” search-results data like SKU, title, brand, price, savings, rating, and availability. Detail enriches each product with the full specifications table, long description, complete image gallery, model number, UPC, color, and breadcrumb category path. **Q: Can I filter and sort results?** A: Yes โ€” sort by Featured, Price lowโ†’high, Price highโ†’low, Best selling, Top rated, or Newest, and filter by brand, min/max price, and Top-Rated. **Q: What output formats are available?** A: JSON, CSV, and Excel โ€” export directly from the Apify dataset. **Q: Which region and currency does it cover?** A: The US storefront (bestbuy.com), with prices in USD. **Q: Is this legal?** A: Yes โ€” the actor accesses only publicly available data. See the [legal section](#-is-it-legal-to-scrape-data) below. *** ### ๐Ÿ› Troubleshooting **No results returned** - Check keyword spelling and try broader terms (e.g. `laptop` instead of an exact model) - Remove or widen filters (brand, min/max price, Top-Rated) - Verify any PLP URLs open correctly in a browser **Specifications are missing** - Switch `scrapeMode` to `detail` โ€” full spec tables, descriptions, and galleries are only extracted in detail mode **Fewer products than expected** - FREE tier is capped at 25 products per run โ€” upgrade to PAID for unlimited results - Some categories or filtered searches simply contain fewer products **Prices look different from what I expect** - Results reflect the US storefront (bestbuy.com) in USD; regional pricing may differ from other markets *** ### โš–๏ธ Is it legal to scrape data? Our actors are ethical and do not extract any private user data, such as email addresses, gender, or location. They only extract what is publicly available. We therefore believe that our actors, when used for ethical purposes by Apify users, are safe. However, you should be aware that your results could contain personal data (for example, seller or reviewer names). Personal data is protected by the **GDPR** in the European Union and by other regulations around the world. You should not scrape personal data unless you have a legitimate reason to do so. If you're unsure whether your reason is legitimate, consult your lawyers. You can also read Apify's blog post on the [legality of web scraping](https://blog.apify.com/is-web-scraping-legal/). **Trademark & affiliation disclaimer:** SIรN Agency is an independent provider and is **not affiliated with, endorsed by, or sponsored by Best Buy**. "Best Buy" and related names, marks, and logos are trademarks of their respective owner. This actor is not an official Best Buy product or service and accesses only publicly available data. *** ### ๐Ÿค Support [![Telegram Support](https://img.shields.io/badge/Telegram-Support%20Group-0088cc?logo=telegram)](https://t.me/+vyh1sRE08sAxMGRi) **Join our active support community** - For issues or questions, open an issue in the actor's repository - Check the [SIรN Agency Store](https://apify.com/sian.agency?fpr=sian) for more automation tools - โœ‰๏ธ *** **Built by [SIรN Agency](https://www.sian-agency.online)** | **[More Tools](https://apify.com/sian.agency?fpr=sian)** # Actor input Schema ## `keywords` (type: `array`): ๐Ÿ” **KEYWORD SEARCH:** Free-text Best Buy searches โ€” exactly what you'd type into the site's search bar. ๐Ÿ“ **EXAMPLES:** `laptop` ยท `4k tv` ยท `sony headphones` ยท `wireless mouse` ยท `air fryer` ๐Ÿ’ก **TIP:** Add one keyword per line โ€” each runs as its own search and all results land in the same dataset. ๐Ÿ–Š๏ธ **BULK EDIT:** Click "Bulk edit" to paste many keywords at once (one per line). โœ… **IMPORTANT:** Provide either keywords, category ids, OR Best Buy URLs (at least one is needed to have something to scrape). ## `scrapeMode` (type: `string`): โš™๏ธ **SCRAPE DEPTH:** Choose how much data to pull per product. โšก **Overview (fast):** Search results only โ€” SKU, title, brand, price, was-price, savings, rating, review count, image, availability, condition & seller. Fastest and cheapest path. ๐Ÿ”ฌ **Detail (enriched specs + description):** Everything in Overview PLUS the full specifications table (30โ€“90 rows), the long product description, the full image gallery, model number, UPC, color and the breadcrumb category path scraped from each product page. ๐Ÿ’ก **TIP:** Start with Overview to scope your catalog, then switch to Detail when you need the complete spec sheet for feeds or comparisons. ## `sort` (type: `string`): ๐Ÿ”ƒ **RESULT ORDERING:** Order search results using Best Buy's own native sort options โ€” so you get the same ranking real shoppers see. ๐Ÿ† **Best selling** surfaces the most popular products first ยท ๐Ÿ’ฒ **Price** sorts ascending or descending ยท โญ **Top rated** leads with the highest-reviewed items ยท ๐Ÿ†• **Newest** prioritizes the latest arrivals. ## `brand` (type: `string`): โ„ข๏ธ **BRAND FILTER:** Restrict results to a single brand (e.g. `Sony`, `Apple`, `Samsung`, `HP`). Uses Best Buy's own brand facet, so it mirrors the site's brand filter. ๐Ÿ’ก **TIP:** Leave blank to include every brand. ## `minPrice` (type: `integer`): ๐Ÿ’ต **MINIMUM PRICE:** Only return products at or above this price (USD). Leave blank for no lower bound. ## `maxPrice` (type: `integer`): ๐Ÿ’ฐ **MAXIMUM PRICE:** Only return products at or below this price (USD). Leave blank for no upper bound. ## `topRated` (type: `boolean`): โญ **TOP-RATED ONLY:** When on, limits results to Best Buy's "Top-Rated" customer-rating facet โ€” the highest-reviewed products. ## `categoryIds` (type: `array`): ๐Ÿงญ **CATEGORY BROWSING (Advanced):** Scrape a whole Best Buy category instead of a keyword search. ๐Ÿ”ง **HOW TO GET IT:** Open any Best Buy category page and copy the numeric id from the URL after the category slug (e.g. for `bestbuy.com/site/laptops/all-laptops/pcmcat138500050001.c?id=pcmcat138500050001` use `pcmcat138500050001`). ๐Ÿ’ก **TIP:** Leave this empty if you're only using keywords โ€” it's purely an advanced alternative for category-level harvesting. ๐Ÿ–Š๏ธ **BULK EDIT:** Add one category id per line to sweep multiple categories in a single run. ## `urls` (type: `array`): ๐Ÿ”— **PASTE RESULT-PAGE URLs:** Paste full Best Buy search or category result-page URLs to scrape them verbatim โ€” filters and sorting you already set in the URL are preserved. ๐Ÿ“ **EXAMPLE:** `https://www.bestbuy.com/site/searchpage.jsp?st=4k+tv` ๐Ÿ–Š๏ธ **BULK EDIT:** Add one URL per line to sweep several pages in a single run. ## `maxResults` (type: `integer`): ๐Ÿ”ข **RESULT CAP:** Maximum number of products to return across all keywords, categories and URLs combined. ๐ŸŽ **TIER-BASED LIMITS:** - **FREE users:** Up to 25 products per run - **PAID users:** Unlimited โ€” scrape entire catalogs in a single run ๐Ÿ’ก **TIP:** Keep this low while you dial in your keywords, then raise it once the output looks right. ## Actor input object example ```json { "keywords": [ "laptop" ], "scrapeMode": "overview", "sort": "featured", "topRated": false, "maxResults": 100 } ``` # Actor output Schema ## `bestBuyProducts` (type: `string`): Scraped Best Buy products with prices, promotions, ratings, images, specs and availability. # 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 = { "keywords": [ "laptop" ] }; // Run the Actor and wait for it to finish const run = await client.actor("sian.agency/best-buy-product-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 = { "keywords": ["laptop"] } # Run the Actor and wait for it to finish run = client.actor("sian.agency/best-buy-product-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 '{ "keywords": [ "laptop" ] }' | apify call sian.agency/best-buy-product-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=sian.agency/best-buy-product-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Best Buy Product Scraper", "description": "Scrape Best Buy products โ€” price, ratings, reviews, images, specs & availability. Keyword or category search, full detail enrichment, clean JSON/CSV, no code.", "version": "1.0", "x-build-id": "uea7UPB4lz76ht1xx" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/sian.agency~best-buy-product-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-sian.agency-best-buy-product-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/sian.agency~best-buy-product-scraper/runs": { "post": { "operationId": "runs-sync-sian.agency-best-buy-product-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/sian.agency~best-buy-product-scraper/run-sync": { "post": { "operationId": "run-sync-sian.agency-best-buy-product-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "keywords": { "title": "๐Ÿ” Search Keywords", "type": "array", "description": "๐Ÿ” **KEYWORD SEARCH:** Free-text Best Buy searches โ€” exactly what you'd type into the site's search bar.\n\n๐Ÿ“ **EXAMPLES:** `laptop` ยท `4k tv` ยท `sony headphones` ยท `wireless mouse` ยท `air fryer`\n\n๐Ÿ’ก **TIP:** Add one keyword per line โ€” each runs as its own search and all results land in the same dataset.\n\n๐Ÿ–Š๏ธ **BULK EDIT:** Click \"Bulk edit\" to paste many keywords at once (one per line).\n\nโœ… **IMPORTANT:** Provide either keywords, category ids, OR Best Buy URLs (at least one is needed to have something to scrape).", "default": [ "laptop" ], "items": { "type": "string" } }, "scrapeMode": { "title": "โš™๏ธ Scrape Mode", "enum": [ "overview", "detail" ], "type": "string", "description": "โš™๏ธ **SCRAPE DEPTH:** Choose how much data to pull per product.\n\nโšก **Overview (fast):** Search results only โ€” SKU, title, brand, price, was-price, savings, rating, review count, image, availability, condition & seller. Fastest and cheapest path.\n\n๐Ÿ”ฌ **Detail (enriched specs + description):** Everything in Overview PLUS the full specifications table (30โ€“90 rows), the long product description, the full image gallery, model number, UPC, color and the breadcrumb category path scraped from each product page.\n\n๐Ÿ’ก **TIP:** Start with Overview to scope your catalog, then switch to Detail when you need the complete spec sheet for feeds or comparisons.", "default": "overview" }, "sort": { "title": "๐Ÿ”ƒ Sort Order", "enum": [ "featured", "price_low", "price_high", "best_selling", "top_rated", "newest" ], "type": "string", "description": "๐Ÿ”ƒ **RESULT ORDERING:** Order search results using Best Buy's own native sort options โ€” so you get the same ranking real shoppers see.\n\n๐Ÿ† **Best selling** surfaces the most popular products first ยท ๐Ÿ’ฒ **Price** sorts ascending or descending ยท โญ **Top rated** leads with the highest-reviewed items ยท ๐Ÿ†• **Newest** prioritizes the latest arrivals.", "default": "featured" }, "brand": { "title": "โ„ข๏ธ Brand Filter", "type": "string", "description": "โ„ข๏ธ **BRAND FILTER:** Restrict results to a single brand (e.g. `Sony`, `Apple`, `Samsung`, `HP`). Uses Best Buy's own brand facet, so it mirrors the site's brand filter.\n\n๐Ÿ’ก **TIP:** Leave blank to include every brand." }, "minPrice": { "title": "๐Ÿ’ต Min Price (USD)", "minimum": 0, "type": "integer", "description": "๐Ÿ’ต **MINIMUM PRICE:** Only return products at or above this price (USD). Leave blank for no lower bound." }, "maxPrice": { "title": "๐Ÿ’ฐ Max Price (USD)", "minimum": 0, "type": "integer", "description": "๐Ÿ’ฐ **MAXIMUM PRICE:** Only return products at or below this price (USD). Leave blank for no upper bound." }, "topRated": { "title": "โญ Top-Rated Only", "type": "boolean", "description": "โญ **TOP-RATED ONLY:** When on, limits results to Best Buy's \"Top-Rated\" customer-rating facet โ€” the highest-reviewed products.", "default": false }, "categoryIds": { "title": "๐Ÿงญ Category IDs (Advanced)", "type": "array", "description": "๐Ÿงญ **CATEGORY BROWSING (Advanced):** Scrape a whole Best Buy category instead of a keyword search.\n\n๐Ÿ”ง **HOW TO GET IT:** Open any Best Buy category page and copy the numeric id from the URL after the category slug (e.g. for `bestbuy.com/site/laptops/all-laptops/pcmcat138500050001.c?id=pcmcat138500050001` use `pcmcat138500050001`).\n\n๐Ÿ’ก **TIP:** Leave this empty if you're only using keywords โ€” it's purely an advanced alternative for category-level harvesting.\n\n๐Ÿ–Š๏ธ **BULK EDIT:** Add one category id per line to sweep multiple categories in a single run.", "items": { "type": "string" } }, "urls": { "title": "๐Ÿ”— Best Buy URLs (Advanced)", "type": "array", "description": "๐Ÿ”— **PASTE RESULT-PAGE URLs:** Paste full Best Buy search or category result-page URLs to scrape them verbatim โ€” filters and sorting you already set in the URL are preserved.\n\n๐Ÿ“ **EXAMPLE:** `https://www.bestbuy.com/site/searchpage.jsp?st=4k+tv`\n\n๐Ÿ–Š๏ธ **BULK EDIT:** Add one URL per line to sweep several pages in a single run.", "items": { "type": "string" } }, "maxResults": { "title": "๐Ÿ”ข Max Results", "minimum": 1, "type": "integer", "description": "๐Ÿ”ข **RESULT CAP:** Maximum number of products to return across all keywords, categories and URLs combined.\n\n๐ŸŽ **TIER-BASED LIMITS:**\n- **FREE users:** Up to 25 products per run\n- **PAID users:** Unlimited โ€” scrape entire catalogs in a single run\n\n๐Ÿ’ก **TIP:** Keep this low while you dial in your keywords, then raise it once the output looks right.", "default": 100 } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```