# Best Buy Store Links Scraper (`datacach/best-buy-store-links-scraper`) Actor
Scrape Best Buy US store page links by crawling the public store directory (states, cities, stores). Returns a deduplicated list of store URLs β export to JSON, CSV, or Excel.
- **URL**: https://apify.com/datacach/best-buy-store-links-scraper.md
- **Developed by:** [DataCach](https://apify.com/datacach) (community)
- **Categories:** Automation, E-commerce, Developer tools
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet
## Pricing
from $0.60 / 1,000 store links
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/docs.md):
```bash
npm install apify-client
```
In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.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/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 Store Links Scraper
> Scrape every **Best Buy US store page URL** from the public Best Buy store directory β fast, deduplicated, and export-ready.
### What is Best Buy Store Links Scraper?
**Best Buy Store Links Scraper** is an Apify **scraper** that collects **links to every Best Buy US store page** by crawling the public [Best Buy store directory](https://stores.bestbuy.com/index.html). It walks the directory from the index page through each **state** and **city** listing and returns the **store page URL** of every Best Buy location it finds β fully **deduplicated** and ready to **export to JSON, CSV, or Excel**.
It's the ideal first step in a two-stage pipeline: use this Actor to **extract the full list of store links**, then feed those URLs into the companion **Best Buy Store Locations Scraper** Actor to pull each store's address, phone, geolocation, and opening hours.
### What can Best Buy Store Links Scraper do?
- πΊοΈ **Crawl the Best Buy US store directory** (index β states β cities β stores).
- π **Extract clean, deduplicated store page URLs** β no repeats across states or cities.
- π’ **Cap the number of results** with `maxResults`, and **stop early** once the cap is reached for faster, cheaper runs.
- β© **Paginate across runs** with `startIndex` and skip links you already have with `excludeUrls` β only collect (and pay for) new stores.
- β‘ **Crawl concurrently** with 5 parallel workers for faster full-directory runs, while keeping output order stable.
- π‘οΈ **Rotate IPs via Apify Proxy** (datacenter, US by default) to reduce anti-bot blocks.
- β»οΈ **Resume automatically** if a run is interrupted β it never re-saves links it already delivered.
- π¦ **Export data** to **JSON, CSV, Excel, or HTML**, or pull it straight from the **Apify API**.
- β±οΈ **Schedule automatic runs** to keep your Best Buy store list up to date.
- π **Monitor runs and get notified** through the Apify platform.
- π **Integrate with Zapier, Make, and webhooks** to push store links into your own tools.
### What data does Best Buy Store Links Scraper extract?
Each result is one Best Buy store link. The primary output fields are:
| Field | Description | Example |
|-------|-------------|---------|
| `url` | The public Best Buy store page URL | `https://stores.bestbuy.com/al/dothan/4863-montgomery-hwy-793.html` |
| `coordinate` | Source label for where the link was found | `static source` |
| `extraction_datetime` | UTC timestamp when the link was extracted (ISO 8601) | `2026-07-21T14:30:00.123456+00:00` |
| `extraction_date` | Extraction date in `mm-dd-yyyy` format | `07-21-2026` |
### How do I use Best Buy Store Links Scraper to scrape Best Buy store locations?
1. Click **Try for free** / open the Actor in the Apify Console.
2. Go to the **Input** tab.
3. (Optional) Set **Max results** to cap how many store links are stored β leave it at `0` to collect the entire directory. To paginate across runs, set **Start index** or **Exclude URLs** (paid plans).
4. Click **Start**.
5. When the run finishes, open the **Output** tab and **download your Best Buy store links** as JSON, CSV, Excel, or HTML β or fetch them via the **Apify API**.
### Input
The Actor is designed to run with **zero configuration** β just click Start. All inputs are optional:
- **Max results** (`maxResults`) β the maximum number of unique store links to save. Use `0` for **unlimited** (the whole directory). The crawl **stops early** once the cap is reached, so a small value makes the run faster and cheaper.
- **Start index** (`startIndex`) β skip this many links from the start before saving any. Use it to **paginate across runs**: already have the first 500? Set `500` to begin from link 501. The crawl order is stable, so index N is reproducible between runs. (Note: it still crawls up to that point, so it changes *which* links are saved, not the run speed.)
- **Exclude URLs** (`excludeUrls`) β store links you already have; any listed here is **never saved again**, regardless of order. Ideal when you keep a running list and only want new stores.
- **Proxy configuration** (`proxyConfiguration`) β proxy used for every request. Defaults to Apify **datacenter** proxy with a **US** target (recommended). You can supply your own proxy instead. Residential is unnecessary here; non-datacenter Apify groups are normalized to datacenter.
```json
{
"maxResults": 100,
"startIndex": 0,
"excludeUrls": [
"https://stores.bestbuy.com/al/dothan/4863-montgomery-hwy-793.html"
],
"proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [], "apifyProxyCountry": "US" }
}
````
#### Free vs. paid plans
`startIndex` and `excludeUrls` let you paginate through the full directory across runs. To keep the free tier free, those pagination controls are restricted on free-plan accounts:
| Capability | Free plan | Paid plan |
|---|---|---|
| **Store links per run** (`maxResults`) | Up to **10** | **Unlimited** (`0`) or any value |
| **Start index** (`startIndex`) | Ignored β always starts from the **first** link | Any value (paginate from anywhere) |
| **Exclude URLs** (`excludeUrls`) | At most **1** URL | **Unlimited** list |
| **Apify Proxy** (datacenter/US) | β
(subject to account proxy access) | β
|
| Deduplicated output | β
| β
|
| Auto-resume on interruption | β
| β
|
| Export to JSON / CSV / Excel / HTML | β
| β
|
| API, scheduling, integrations | β
| β
|
On the free plan you always receive the first β€10 store links; upgrade to a paid plan to raise the cap and use `startIndex` / `excludeUrls` to collect the rest of the directory.
### Output example
Each dataset item is one Best Buy store link:
```json
{
"url": "https://stores.bestbuy.com/al/dothan/4863-montgomery-hwy-793.html",
"coordinate": "static source",
"extraction_datetime": "2026-07-21T14:30:00.123456+00:00",
"extraction_date": "07-21-2026"
}
```
You can **download the dataset** in various formats such as **JSON, HTML, CSV, or Excel**, or access it programmatically through the **Apify API**.
### Use cases
- π¬ **Build a complete list of Best Buy US store locations** for market or competitor research.
- π **Seed a store-metadata pipeline** β feed these URLs into the Best Buy Store Locations Scraper Actor to extract addresses, phone numbers, geolocation, and hours.
- π§ **Power a store locator** or "find a store near me" feature with an up-to-date URL list.
- π **Track store openings and closures** over time by scheduling recurring runs and comparing results.
- π **Integrate Best Buy store data** into a CRM, data warehouse, or BI dashboard via the API or Zapier/Make.
### Other Best Buy Actors you might like
| Actor | What it does |
|-------|--------------|
| **Best Buy Store Locations Scraper** | Takes these store links and extracts full store details β address, phone, geolocation, and opening hours. |
### FAQ
#### Is it legal to scrape Best Buy store data?
This Actor only collects **publicly available data** from the same public Best Buy store directory that the Best Buy website itself serves to visitors. It does not access any private, personal, or authenticated data. As with any web scraping, you are responsible for how you use the collected data and for complying with Best Buy's Terms of Service and applicable laws. If in doubt, consult legal counsel.
#### Can I get Best Buy store links through an API?
Yes. Every run's dataset is available through the **Apify API**, so you can trigger the Actor and pull store links programmatically, or connect it to **Zapier, Make, and webhooks**.
#### How many Best Buy store links will I get?
By default (`maxResults: 0`) the Actor collects the **entire Best Buy US store directory**, deduplicated. Set `maxResults` to a positive number to cap the output β the crawl stops early once the cap is reached. On the **free plan**, results are limited to **10 links**, and the `startIndex` / `excludeUrls` pagination controls are restricted (see [Free vs. paid plans](#free-vs-paid-plans)). Upgrade to a paid plan to collect the full directory across runs.
#### What export formats are supported?
You can export your Best Buy store links as **JSON, CSV, Excel, or HTML**, or read them directly from the Apify API.
#### What happens if Best Buy blocks a request?
The Actor crawls the directory page by page with a short delay between requests. If the directory blocks a request (anti-bot protection), it is logged, and the run only fails if **no links at all** could be collected.
### Support
Found a bug or have a feature request? Open an issue on the Actor's **Issues** tab in the Apify Console and we'll take a look. Need a **custom Best Buy scraping solution** or additional store fields? Reach out β we're happy to help.
# Actor input Schema
## `maxResults` (type: `integer`):
Maximum number of unique store links to save (0 = unlimited, the default). The Actor crawls the stores.bestbuy.com directory (index β states β cities β stores) and stops early once this many links are collected, so a small value makes the run faster and cheaper. On the free plan, output is capped at 10 links regardless of this value.
## `startIndex` (type: `integer`):
Skip this many store links from the start of the crawl before saving any. Use it to paginate across runs: if you already have the first 500 links, set 500 to begin from link 501 and avoid paying for links you already have. Links are discovered in a stable order, so index N is reproducible between runs. Combined with Max results, the saved range is \[startIndex, startIndex + maxResults). Note: the Actor still crawls up to that point, so a large value changes which links are saved, not the run speed β and it is ignored on the free plan (free runs always start from the first link).
## `excludeUrls` (type: `array`):
Store links you already have. Any URL listed here is never saved again, regardless of crawl order. Unlike Start index, this is order-independent β ideal when you keep a running list of collected stores and only want new ones. Applied after Start index. Note: free-plan runs may list at most 1 URL here.
## `proxyConfiguration` (type: `object`):
Proxy used for every request. Recommended: leave the default β Apify datacenter proxy with a US target, the fastest and most reliable option for the Best Buy US directory. Only switch to your own proxy if you have a specific reason; residential proxies are unnecessary here and slower. Non-datacenter Apify groups are automatically normalized to datacenter.
## Actor input object example
```json
{
"maxResults": 0,
"startIndex": 0,
"excludeUrls": [
"https://stores.bestbuy.com/al/dothan/4863-montgomery-hwy-793.html"
],
"proxyConfiguration": {
"useApifyProxy": true,
"apifyProxyGroups": [],
"apifyProxyCountry": "US"
}
}
```
# Actor output Schema
## `dataset` (type: `string`):
No description
# 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 = {
"excludeUrls": [
"https://stores.bestbuy.com/al/dothan/4863-montgomery-hwy-793.html"
],
"proxyConfiguration": {
"useApifyProxy": true,
"apifyProxyGroups": [],
"apifyProxyCountry": "US"
}
};
// Run the Actor and wait for it to finish
const run = await client.actor("datacach/best-buy-store-links-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 = {
"excludeUrls": ["https://stores.bestbuy.com/al/dothan/4863-montgomery-hwy-793.html"],
"proxyConfiguration": {
"useApifyProxy": True,
"apifyProxyGroups": [],
"apifyProxyCountry": "US",
},
}
# Run the Actor and wait for it to finish
run = client.actor("datacach/best-buy-store-links-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 '{
"excludeUrls": [
"https://stores.bestbuy.com/al/dothan/4863-montgomery-hwy-793.html"
],
"proxyConfiguration": {
"useApifyProxy": true,
"apifyProxyGroups": [],
"apifyProxyCountry": "US"
}
}' |
apify call datacach/best-buy-store-links-scraper --silent --output-dataset
```
## MCP server setup
```json
{
"mcpServers": {
"apify": {
"command": "npx",
"args": [
"mcp-remote",
"https://mcp.apify.com/?tools=datacach/best-buy-store-links-scraper",
"--header",
"Authorization: Bearer "
]
}
}
}
```
## OpenAPI specification
```json
{
"openapi": "3.0.1",
"info": {
"title": "Best Buy Store Links Scraper",
"description": "Scrape Best Buy US store page links by crawling the public store directory (states, cities, stores). Returns a deduplicated list of store URLs β export to JSON, CSV, or Excel.",
"version": "0.0",
"x-build-id": "L3YO61Be9PwzPAkyh"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/datacach~best-buy-store-links-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-datacach-best-buy-store-links-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/datacach~best-buy-store-links-scraper/runs": {
"post": {
"operationId": "runs-sync-datacach-best-buy-store-links-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/datacach~best-buy-store-links-scraper/run-sync": {
"post": {
"operationId": "run-sync-datacach-best-buy-store-links-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": {
"maxResults": {
"title": "Max results",
"minimum": 0,
"type": "integer",
"description": "Maximum number of unique store links to save (0 = unlimited, the default). The Actor crawls the stores.bestbuy.com directory (index β states β cities β stores) and stops early once this many links are collected, so a small value makes the run faster and cheaper. On the free plan, output is capped at 10 links regardless of this value.",
"default": 0
},
"startIndex": {
"title": "Start index",
"minimum": 0,
"type": "integer",
"description": "Skip this many store links from the start of the crawl before saving any. Use it to paginate across runs: if you already have the first 500 links, set 500 to begin from link 501 and avoid paying for links you already have. Links are discovered in a stable order, so index N is reproducible between runs. Combined with Max results, the saved range is [startIndex, startIndex + maxResults). Note: the Actor still crawls up to that point, so a large value changes which links are saved, not the run speed β and it is ignored on the free plan (free runs always start from the first link).",
"default": 0
},
"excludeUrls": {
"title": "Exclude URLs",
"type": "array",
"description": "Store links you already have. Any URL listed here is never saved again, regardless of crawl order. Unlike Start index, this is order-independent β ideal when you keep a running list of collected stores and only want new ones. Applied after Start index. Note: free-plan runs may list at most 1 URL here.",
"default": [],
"items": {
"type": "string"
}
},
"proxyConfiguration": {
"title": "Proxy configuration",
"type": "object",
"description": "Proxy used for every request. Recommended: leave the default β Apify datacenter proxy with a US target, the fastest and most reliable option for the Best Buy US directory. Only switch to your own proxy if you have a specific reason; residential proxies are unnecessary here and slower. Non-datacenter Apify groups are automatically normalized to datacenter.",
"default": {
"useApifyProxy": true,
"apifyProxyGroups": [],
"apifyProxyCountry": "US"
}
}
}
},
"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
}
}
}
}
}
}
}
}
}
}
```