# BestBuy Listings Extractor (`kawsar/bestbuy-listings-extractor`) Actor BestBuy scraper that pulls product prices, ratings, and reviews from any search keyword, so you can monitor electronics pricing and catch deals without manual browsing. - **URL**: https://apify.com/kawsar/bestbuy-listings-extractor.md - **Developed by:** [Kawsar](https://apify.com/kawsar) (community) - **Categories:** E-commerce, Automation, Developer tools - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $3.99 / 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. 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 ## BestBuy Listings Extractor Extract product listings, prices, ratings, and reviews from Best Buy search results at scale. Enter one or more keywords, brands, or product categories and get back structured JSON data for every matching listing — including current price, list price, discount, star rating, review count, image URL, and a direct product link. Runs multiple search queries in a single go. Each query paginates automatically until your per-query item limit is reached. --- ### Features - Multiple search queries in one run (stringList input) - Per-query item limit — set how many results you want per keyword - Extracts current price, list price, savings amount, and savings percentage - Captures star rating and total review count per product - Returns product URL, image URL, and Best Buy SKU ID - Handles pagination automatically across all queries - Carrier-only or out-of-stock items return `null` price fields gracefully --- ### Input | Field | Type | Required | Default | Description | |---|---|---|---|---| | `searchQueries` | string[] | Yes | — | List of keywords, brands, or categories to search (e.g. `Samsung`, `laptop`, `iPhone 16`) | | `maxItemsPerQuery` | integer | No | `10` | Max product listings to collect **per query** | | `requestTimeoutSecs` | integer | No | `30` | Per-request HTTP timeout in seconds | #### Example input ```json { "searchQueries": ["Samsung Galaxy", "Sony headphones", "LG OLED TV"], "maxItemsPerQuery": 20 } ```` This collects up to 20 products per query — up to 60 total records across three searches. *** ### Output Each product returns one flat JSON record in the Apify dataset. | Field | Type | Description | |---|---|---| | `skuId` | string | Best Buy unique product identifier | | `productName` | string | Full product name as listed on Best Buy | | `productUrl` | string | Direct link to the product page | | `imageUrl` | string | Primary product image URL | | `imageAltText` | string | Image accessibility label | | `regularPrice` | number | Original list price in USD | | `salePrice` | number | Current customer price in USD | | `savings` | number | Dollar amount saved off list price | | `savingsPercent` | number | Percentage saved off list price | | `rating` | number | Average star rating (0–5) | | `reviewCount` | integer | Total number of customer reviews | | `searchQuery` | string | The search keyword that produced this result | | `scrapedAt` | string | ISO 8601 UTC timestamp of collection | #### Example output ```json [ { "skuId": "6665037", "productName": "Samsung - Galaxy Tab A11+ - 11\" 128GB - Wi-Fi - Gray", "productUrl": "https://www.bestbuy.com/product/samsung-galaxy-tab-a11-11-128gb-wi-fi-gray/JJGRF3QGQQ/sku/6665037", "imageUrl": "https://pisces.bbystatic.com/image2/BestBuy_US/images/products/1a55ef21-32ee-48af-af73-100b1adcb9c6.jpg", "imageAltText": "Front. Samsung - Galaxy Tab A11+ - 11\" 128GB - Wi-Fi - Gray.", "regularPrice": 349.99, "salePrice": 279.99, "savings": 70.00, "savingsPercent": 20.0, "rating": 4.7, "reviewCount": 267, "searchQuery": "Samsung Galaxy", "scrapedAt": "2026-06-30T10:00:00+00:00" }, { "skuId": "6552953", "productName": "Samsung - The Freestyle 2nd Gen Smart Portable Projector - White", "productUrl": "https://www.bestbuy.com/product/samsung-the-freestyle-2nd-gen/6552953", "imageUrl": "https://pisces.bbystatic.com/image2/BestBuy_US/images/products/6552/6552953_sd.jpg", "imageAltText": "Front. Samsung - The Freestyle 2nd Gen Smart Portable Projector - White.", "regularPrice": 799.99, "salePrice": 599.99, "savings": 200.00, "savingsPercent": 25.0, "rating": 4.5, "reviewCount": 412, "searchQuery": "Samsung Galaxy", "scrapedAt": "2026-06-30T10:00:05+00:00" } ] ``` *** ### Use cases **Price monitoring** — Track price changes on electronics, appliances, and consumer goods over time by scheduling recurring runs. **Competitor research** — See how competing brands are priced across the same product category. **Deal detection** — Filter output by `savingsPercent` to find discounted products automatically. **Market research** — Collect product names, ratings, and review counts to analyze brand reputation and product positioning. **E-commerce intelligence** — Compare your own catalog prices against Best Buy listings without manual browsing. *** ### Pagination Each Best Buy search page returns up to 24 products. The actor pages through results automatically for each query until it reaches `maxItemsPerQuery` or runs out of listings. Set `maxItemsPerQuery: 10` to get a quick sample. Set `maxItemsPerQuery: 500` for a full category sweep. *** ### Tips - Use brand names (`Samsung`, `Apple`, `Sony`) for broad product discovery across a brand - Use model-level terms (`Samsung QN90D 65 inch`) to target specific products - Add multiple queries to compare pricing across competing brands in one run - Products sold only on carrier contracts may return `null` for price fields — this is expected - Schedule the actor on a daily cron to build a price history dataset over time *** ### Legal For research and personal use only. Respect Best Buy's Terms of Service and robots.txt. Do not redistribute extracted data commercially without authorization. # Actor input Schema ## `searchQueries` (type: `array`): One or more keywords, brands, or product categories to search on Best Buy (e.g. Samsung, laptop, iPhone 16). Each query runs separately. ## `maxItemsPerQuery` (type: `integer`): Maximum number of product listings to collect for each search query. ## `requestTimeoutSecs` (type: `integer`): Per-request timeout in seconds. ## Actor input object example ```json { "searchQueries": [ "Samsung Galaxy", "Sony headphones" ], "maxItemsPerQuery": 10, "requestTimeoutSecs": 30 } ``` # 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 = { "searchQueries": [ "Samsung" ] }; // Run the Actor and wait for it to finish const run = await client.actor("kawsar/bestbuy-listings-extractor").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 = { "searchQueries": ["Samsung"] } # Run the Actor and wait for it to finish run = client.actor("kawsar/bestbuy-listings-extractor").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 '{ "searchQueries": [ "Samsung" ] }' | apify call kawsar/bestbuy-listings-extractor --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=kawsar/bestbuy-listings-extractor", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "BestBuy Listings Extractor", "description": "BestBuy scraper that pulls product prices, ratings, and reviews from any search keyword, so you can monitor electronics pricing and catch deals without manual browsing.", "version": "0.0", "x-build-id": "Iiyz11SYunXc8dumW" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/kawsar~bestbuy-listings-extractor/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-kawsar-bestbuy-listings-extractor", "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/kawsar~bestbuy-listings-extractor/runs": { "post": { "operationId": "runs-sync-kawsar-bestbuy-listings-extractor", "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/kawsar~bestbuy-listings-extractor/run-sync": { "post": { "operationId": "run-sync-kawsar-bestbuy-listings-extractor", "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", "required": [ "searchQueries" ], "properties": { "searchQueries": { "title": "Search queries", "type": "array", "description": "One or more keywords, brands, or product categories to search on Best Buy (e.g. Samsung, laptop, iPhone 16). Each query runs separately.", "items": { "type": "string" } }, "maxItemsPerQuery": { "title": "Max items per query", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Maximum number of product listings to collect for each search query.", "default": 10 }, "requestTimeoutSecs": { "title": "Request timeout (seconds)", "minimum": 5, "maximum": 120, "type": "integer", "description": "Per-request timeout in seconds.", "default": 30 } } }, "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 } } } } } } } } } } ```