# Best Buy Store Details Scraper (`datacach/best-buy-store-details-scraper`) Actor

Extracts full store details (address, phone, geolocation, hours) for Best Buy US store page links, output by the Best Buy Store Links Scraper.

- **URL**: https://apify.com/datacach/best-buy-store-details-scraper.md
- **Developed by:** [DataCach](https://apify.com/datacach) (community)
- **Categories:** E-commerce, Developer tools, Automation
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.99 / 1,000 stores

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 Details Scraper

Extract complete **Best Buy store data** — address, phone number, geolocation, and opening hours — for any US Best Buy location, in seconds.

### What is Best Buy Store Details Scraper?

Best Buy Store Details Scraper is an **Apify Actor** that extracts full store details from public [Best Buy store pages](https://stores.bestbuy.com/index.html). Feed it one or more store page URLs — typically the output of the companion [**Best Buy Store Links Scraper**](https://apify.com/datacach/best-buy-store-links-scraper) — and it **scrapes** each page's structured data to return a clean JSON record per store: name, street address, city, state, ZIP code, phone number, latitude/longitude, and raw opening hours.

No coding, no browser automation, no CSS selectors to maintain — just paste URLs and get structured **store data** back, ready to export as JSON, CSV, or Excel.

### What can Best Buy Store Details Scraper do?

- 📍 **Extract full store metadata** — name, street, city, state, ZIP, phone, latitude/longitude, and opening hours for any Best Buy US store page.
- 🔗 **Bulk input support** — paste a single URL or thousands of Best Buy store links at once.
- ⚡ **Fast, lightweight HTTP scraping** — no headless browser required, so runs finish quickly and cheaply.
- 🎚️ **Configurable concurrency** — tune how many store pages are fetched in parallel (1–20) to balance speed against anti-bot risk.
- 🛡️ **Automatic anti-bot detection** — blocked or failed pages are logged and skipped instead of crashing the whole run.
- 📤 **Multiple export formats** — download results as **JSON**, CSV, Excel, XML, or HTML directly from the Output tab.
- 🔄 **Full Apify platform integration** — schedule recurring runs, trigger via the **Apify API**, monitor run health, and connect to **Zapier**, **Make**, or any webhook-based workflow.
- 🧩 **Combine with Best Buy Store Links Scraper** to go from "all Best Buy locations" to "full store details" in one pipeline.

### What data does Best Buy Store Details Scraper extract?

| Field | Description |
|---|---|
| `name` | Store brand name (e.g. "Best Buy") |
| `street` | Street address |
| `city` | City |
| `state` | US state abbreviation |
| `zipcode` | ZIP / postal code |
| `phone` | Store phone number |
| `latitude` | Store geolocation latitude |
| `longitude` | Store geolocation longitude |
| `hours_raw` | Raw opening-hours list, as published in the store page's structured data |
| `url` | The source store page URL |
| `extraction_datetime` | UTC timestamp of extraction (ISO 8601) |
| `extraction_date` | Extraction date (`mm-dd-yyyy`) |

<!-- TODO: screenshot of a sample dataset / Output tab table view -->

### How do I scrape Best Buy store details?

1. **Get store page URLs.** Run the [**Best Buy Store Links Scraper**](https://apify.com/datacach/best-buy-store-links-scraper) to collect every Best Buy store URL, or gather them manually from the [Best Buy store directory](https://stores.bestbuy.com/index.html).
2. **Open this Actor's Input tab** and paste the URLs into the **Store page URLs** (`links`) field.
3. **Optionally adjust Max concurrency** (`maxConcurrency`, default `5`) — lower it if you want to be gentler on the target site, raise it (up to `20`) for faster runs.
4. **Click Start.** The Actor fetches each store page, extracts its embedded structured data, and pushes one item per store to the dataset.
5. **Download your results** from the **Output** tab in JSON, CSV, Excel, or any supported format — or pull them programmatically via the **Apify API**.

<!-- TODO: embed a demo video/GIF URL here, e.g. https://www.youtube.com/watch?v=XXXXXXXXXXX -->

### Input

Best Buy Store Details Scraper takes a simple, minimal input:

- **Store page URLs** (`links`) — one or more Best Buy US store page URLs, for example `https://stores.bestbuy.com/ri/warwick/24-universal-blvd-569.html`. This is typically the output of the **Best Buy Store Links** Actor.
- **Max concurrency** (`maxConcurrency`) — how many store pages to fetch in parallel (1–20, default `5`). Lower values are gentler on the target site; higher values finish faster.

> ⚠️ On the free plan, only the first 5 links are processed per run. Upgrade your plan to remove this limit.

![Best Buy Store Details Scraper input example](https://raw.githubusercontent.com/BenjaminFloresV/public-datacach-apify-actors-media/main/best-buy-store-detail-scraper/bestbuy-metadata-bot-input-example.png)

Example input:

```json
{
    "links": [
        "https://stores.bestbuy.com/ri/warwick/24-universal-blvd-569.html",
        "https://stores.bestbuy.com/ak/anchorage/1200-n-muldoon-rd-1760.html"
    ],
    "maxConcurrency": 5
}
````

### Output example

Each store produces one dataset item like this:

```json
{
    "url": "https://stores.bestbuy.com/ri/warwick/24-universal-blvd-569.html",
    "name": "Best Buy",
    "street": "24 Universal Blvd",
    "city": "Warwick",
    "state": "RI",
    "zipcode": "02886",
    "phone": "(401) 826-7007",
    "latitude": 41.701315,
    "longitude": -71.495997,
    "hours_raw": {
        "openingHours": [
            "Mo,Tu,We,Th,Fr,Sa 10:00-21:00",
            "Su 10:00-20:00"
        ]
    },
    "extraction_datetime": "2026-07-21T18:20:26.063411+00:00",
    "extraction_date": "07-21-2026"
}
```

You can download the dataset in various formats such as JSON, HTML, CSV, or Excel.

### Use cases

- 🗺️ **Store locator apps** — power an in-house store finder with accurate, up-to-date addresses and coordinates.
- 📊 **Retail market research** — analyze Best Buy's US footprint by state, city, or region.
- 📞 **Lead & contact databases** — build a directory of store phone numbers for outreach or customer service routing.
- 🧭 **Logistics & geolocation** — feed store latitude/longitude into routing, delivery radius, or mapping tools.
- ⏰ **Hours-of-operation tracking** — monitor opening-hours changes across store locations over time.
- 🔁 **Data pipelines** — combine with **Best Buy Store Links Scraper** as an automated two-step Apify pipeline: discover links, then enrich with full details.

### Best Buy-related Actors

| Actor | What it does |
|---|---|
| [Best Buy Store Links Scraper](https://apify.com/datacach/best-buy-store-links-scraper) | Collects all Best Buy US store page URLs — the recommended input source for this Actor |
| *(add more of your related Actors here)* | |

### FAQ

#### Is it legal to scrape Best Buy store data?

This Actor only extracts **publicly available data** already published in the structured data (`ld+json`) embedded in Best Buy's public store pages — the same data search engines index. Scraping publicly accessible data is generally considered legal, but you are responsible for complying with Best Buy's Terms of Service and applicable laws in your jurisdiction. Avoid scraping personal data or content behind a login, and use reasonable request rates.

#### Does this Actor need Best Buy store URLs to work?

Yes. It doesn't discover stores on its own — pass it store page URLs (from the **Best Buy Store Links** Actor or the [Best Buy store directory](https://stores.bestbuy.com/index.html)) and it extracts the details for each one.

#### Can I run this Actor via API or on a schedule?

Yes. Every Apify Actor, including this one, can be triggered via the **Apify API**, scheduled to run automatically (e.g. daily/weekly), and integrated with **Zapier**, **Make**, webhooks, or any HTTP client.

#### What happens if a store page is blocked or fails to load?

Blocked or failed links are logged and skipped — they don't stop the run. The run only fails if **no** link succeeds. Check the run log for per-link status.

#### What export formats are supported?

Results can be downloaded as **JSON**, CSV, Excel (XLSX), XML, or HTML directly from the **Output** tab, or fetched via the **Apify API** / **Dataset API**.

### Support

Found a bug, have a feature request, or need a custom version of this Actor for a specific use case? Open an issue on the Actor's **Issues** tab in Apify Console, or reach out for a tailored scraping solution.

# Actor input Schema

## `links` (type: `array`):

One or more Best Buy US store page URLs to extract metadata from — typically the output of the <b>Best Buy Store Links</b> Actor. Each URL should point to a single store page, for example <code>https://stores.bestbuy.com/ri/warwick/24-universal-blvd-569.html</code>. On the free plan, only the first 5 links are processed.

## `maxConcurrency` (type: `integer`):

Maximum number of store pages fetched in parallel (1–20). Higher values finish faster but increase the chance of being rate-limited or blocked by anti-bot protection. Lower values are gentler on the target site. Leave at 5 unless you have a reason to change it.

## Actor input object example

```json
{
  "links": [
    "https://stores.bestbuy.com/ri/warwick/24-universal-blvd-569.html",
    "https://stores.bestbuy.com/ak/anchorage/1200-n-muldoon-rd-1760.html"
  ],
  "maxConcurrency": 5
}
```

# 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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "links": [
        "https://stores.bestbuy.com/ri/warwick/24-universal-blvd-569.html",
        "https://stores.bestbuy.com/ak/anchorage/1200-n-muldoon-rd-1760.html"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("datacach/best-buy-store-details-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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = { "links": [
        "https://stores.bestbuy.com/ri/warwick/24-universal-blvd-569.html",
        "https://stores.bestbuy.com/ak/anchorage/1200-n-muldoon-rd-1760.html",
    ] }

# Run the Actor and wait for it to finish
run = client.actor("datacach/best-buy-store-details-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 '{
  "links": [
    "https://stores.bestbuy.com/ri/warwick/24-universal-blvd-569.html",
    "https://stores.bestbuy.com/ak/anchorage/1200-n-muldoon-rd-1760.html"
  ]
}' |
apify call datacach/best-buy-store-details-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=datacach/best-buy-store-details-scraper",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Best Buy Store Details Scraper",
        "description": "Extracts full store details (address, phone, geolocation, hours) for Best Buy US store page links, output by the Best Buy Store Links Scraper.",
        "version": "0.0",
        "x-build-id": "4Ht4FdkTmvR3UaUHa"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/datacach~best-buy-store-details-scraper/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-datacach-best-buy-store-details-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-details-scraper/runs": {
            "post": {
                "operationId": "runs-sync-datacach-best-buy-store-details-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-details-scraper/run-sync": {
            "post": {
                "operationId": "run-sync-datacach-best-buy-store-details-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",
                "required": [
                    "links"
                ],
                "properties": {
                    "links": {
                        "title": "Store page URLs",
                        "type": "array",
                        "description": "One or more Best Buy US store page URLs to extract metadata from — typically the output of the <b>Best Buy Store Links</b> Actor. Each URL should point to a single store page, for example <code>https://stores.bestbuy.com/ri/warwick/24-universal-blvd-569.html</code>. On the free plan, only the first 5 links are processed.",
                        "items": {
                            "type": "string"
                        }
                    },
                    "maxConcurrency": {
                        "title": "Max concurrency",
                        "minimum": 1,
                        "maximum": 20,
                        "type": "integer",
                        "description": "Maximum number of store pages fetched in parallel (1–20). Higher values finish faster but increase the chance of being rate-limited or blocked by anti-bot protection. Lower values are gentler on the target site. Leave at 5 unless you have a reason to change it.",
                        "default": 5
                    }
                }
            },
            "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
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
