# Staples Store Details & Hours Scraper (`datacach/staples-store-details-scraper`) Actor
Extract full Staples store details from locator page URLs — name, address, phone, hours, and GPS coordinates. Export data as JSON, CSV, or Excel.
- **URL**: https://apify.com/datacach/staples-store-details-scraper.md
- **Developed by:** [DataCach](https://apify.com/datacach) (community)
- **Categories:** Automation, Developer tools, Lead generation
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet
## Pricing
from $0.50 / 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 web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".
## How to integrate an Actor?
If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.
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
## Staples Store Details & Hours Scraper
Extract **Staples store details, hours, services, and contact data** as clean, structured JSON — no coding or CSS selectors required. Feed in a list of [Staples store locator](https://stores.staples.com/) page URLs and get back one complete record per store: name, full address, phone, fax, GPS coordinates, timezone, opening hours, in-store services, accepted payment methods, and more.
### What is Staples Store Details & Hours Scraper?
Staples Store Details & Hours Scraper is an [Apify Actor](https://apify.com/actors) that turns a list of Staples store page URLs into **structured store data** — ready to export as JSON, CSV, or Excel. It reads the store data embedded directly in each Staples locator page, so results are accurate, fast, and don't require browser automation.
This Actor is designed to run as a second step after a **link-discovery Actor** (such as the [Staples Store Locator Scraper](https://apify.com/datacach/staples-store-locator-scraper)) that finds store page URLs for a state, city, or ZIP code. You paste those URLs in, click **Start**, and get back complete store profiles — address, hours, services, payment options, and geolocation — for every store link you provide.
### What can Staples Store Details & Hours Scraper do?
- 🏬 **Extract full store profiles** — name, street address, city, state, ZIP, phone, fax, latitude/longitude, and IANA timezone for every Staples location you submit.
- 🕒 **Pull structured opening hours** — per-day open/close intervals, ready to parse or display.
- 🖨️ **List in-store services** — both a flat summary (Print Services, Tech Services, Shipping Services, Recycling Services, etc.) and a detailed breakdown with descriptions and clickthrough URLs.
- 💳 **Capture accepted payment methods** for each store.
- 🆔 **Return internal store identifiers** (`store_id`, `business_id`, `uid`) useful for deduplication or joining with other datasets.
- ⏱️ **Timestamp every record** with `extraction_datetime` (UTC, ISO 8601) and `extraction_date` (`mm-dd-yyyy`) so you always know when data was collected.
- 📤 **Export in multiple formats** — JSON, CSV, Excel, XML, or RSS, straight from the Apify Console or API.
- ⚙️ **Run at scale on the Apify platform** — schedule recurring runs, trigger via the [Apify API](https://docs.apify.com/api/v2) or SDKs, integrate with Zapier/Make, monitor runs, and use Apify Proxy for reliable, rate-limit-friendly fetching.
- 🔁 **Fault-tolerant by design** — links that are blocked or fail are logged and skipped instead of failing the whole run.
### What data does Staples Store Details & Hours Scraper extract?
| Field | Description |
|---|---|
| `url` | The Staples store page URL that was scraped |
| `name` | Store brand name |
| `street`, `city`, `state`, `zipcode` | Full store address |
| `phone`, `fax` | Store phone and fax numbers |
| `latitude`, `longitude` | Store geolocation (GPS coordinates) |
| `timezone` | IANA timezone of the store, for interpreting `hours_raw` |
| `hours_raw` | Structured opening hours, per day with open/close intervals |
| `description` | Store-specific marketing description |
| `services` | Flat list of in-store service names (e.g. Print Services, Tech Services) |
| `payment_options` | Accepted payment methods |
| `store_id`, `business_id`, `uid` | Internal Staples/Yext store identifiers, useful for dedup or joins |
| `services_detailed` | Per-service name, description, and clickthrough URL |
| `extraction_datetime` | UTC timestamp when the item was extracted (ISO 8601) |
| `extraction_date` | Extraction date in `mm-dd-yyyy` format |
### How do I scrape Staples store details and hours?
1. Get a list of Staples store page URLs — for example, from the [Staples Store Locator Scraper](https://apify.com/datacach/staples-store-locator-scraper) Actor, or your own list of `stores.staples.com` URLs.
2. Open this Actor's **Input** tab and paste the URLs into the `links` field, one per line or as a JSON array.
3. Optionally adjust `maxConcurrency` (default `5`) to control how many stores are fetched in parallel.
4. Click **Start**.
5. When the run finishes, open the **Output** tab (or call the [Apify API](https://docs.apify.com/api/v2)) to download your data as JSON, CSV, Excel, or another supported format.
### Input
The input is intentionally simple — just two fields:
- **Staples store URLs** (`links`, required) — an array of Staples store page URLs to extract details from, e.g. `https://stores.staples.com/al/athens/1036-highway-72-east`. These typically come straight from the output of the [Staples Store Locator Scraper](https://apify.com/datacach/staples-store-locator-scraper).
- **Max concurrency** (`maxConcurrency`, optional, default `5`) — how many store pages to fetch in parallel. Higher values finish faster but increase the chance of being rate-limited or blocked; a value between 5 and 10 works well for most runs.
```json
{
"links": [
"https://stores.staples.com/al/athens/1036-highway-72-east",
"https://stores.staples.com/ca/los-angeles/5410-wilshire-blvd"
],
"maxConcurrency": 5
}
````
### Free vs. paid Apify plans: how many Staples stores can I scrape?
This Actor's per-run limit depends on your **Apify account plan**, not on how many URLs you submit:
| Plan | Links processed per run |
|---|---|
| 🆓 **Free Apify account** | Only the **first 5** unique links in your `links` array are processed, no matter how many you submit. |
| 💎 **Paid / premium Apify account** | **All** links you submit are processed — no cap. |
The Actor automatically detects your account's billing status at runtime. If you're on a free plan, it logs a warning and silently trims your `links` array down to the first 5 unique URLs before processing; everything beyond that is skipped for that run. If you're on a paid plan, the full list you provide is processed with no artificial limit.
**In short:** to extract details for more than 5 Staples stores in a single run, your Apify account needs to be on a paid plan. This limit exists purely to let you try the Actor risk-free on a free account — it is not related to the target website and does not affect data quality or accuracy, only the number of stores processed per run.
### Output example
```json
{
"url": "https://stores.staples.com/al/birmingham/1905-edwards-lake-road",
"name": "Staples",
"street": "1905 Edwards Lake Road",
"city": "Birmingham",
"state": "AL",
"zipcode": "35235",
"phone": "+12056613214",
"fax": "+12566971190",
"latitude": 33.5957121,
"longitude": -86.649088,
"timezone": "America/Chicago",
"hours_raw": {
"monday": { "openIntervals": [{ "start": "08:00", "end": "20:00" }] },
"saturday": { "openIntervals": [{ "start": "10:00", "end": "19:00" }] },
"sunday": { "openIntervals": [{ "start": "11:00", "end": "18:00" }] }
},
"description": "With a focus on the community of small businesses and consumers, Staples in Birmingham, AL provides innovative printing, shipping, technology, travel and recycling services...",
"services": ["Print Services", "Tech Services", "Shipping Services", "Recycling Services", "Direct Mail", "Design Services", "Passport Photos"],
"payment_options": ["American Express", "Google Pay", "Apple Pay", "Cash", "Check", "Discover", "MasterCard", "Visa"],
"store_id": "1204",
"business_id": 383700,
"uid": 1016842,
"services_detailed": [
{
"name": "Document Printing",
"details": "Professional-quality printing for presentations, reports, booklets, and blueprints—order online and pickup same-day in store.",
"url": "https://www.staples.com/services/printing/copies-documents-printing/"
}
],
"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.
### Use cases
- **Store locator apps** — power a store-finder UI with fresh Staples address, hours, and geolocation data.
- **Competitive & market research** — analyze Staples' store footprint, service offerings, and coverage by state or region.
- **Business intelligence & lead lists** — build a database of Staples locations with contact details for outreach or partnership analysis.
- **Logistics & routing** — use GPS coordinates and addresses to plan delivery routes or territory coverage near Staples stores.
- **Data enrichment** — join `store_id`, `business_id`, and `uid` with your existing retail datasets for deduplication and record linking.
- **Monitoring** — schedule recurring runs on Apify to track changes in store hours, services, or descriptions over time.
### Staples-related Actors
| Actor | What it does |
|---|---|
| [Staples Store Locator Scraper](https://apify.com/datacach/staples-store-locator-scraper) | Discovers Staples store page URLs by state, city, or ZIP — feed its output directly into this Actor. |
### FAQ
#### Is it legal to scrape Staples store data?
This Actor only extracts publicly available store information that Staples itself publishes on its public store locator pages (`stores.staples.com`). It's generally accepted that scraping publicly available data is legal, but you're responsible for how you use the collected data and should review Staples' Terms of Service and applicable laws (e.g. GDPR, CCPA) if you plan to store or process personal data. Consult a legal professional if you're unsure.
#### How many Staples stores can I scrape per run?
It depends on your Apify plan: **free accounts are limited to the first 5 links** submitted per run, while **paid/premium accounts can process the full list** of links with no cap. See the [Free vs. paid Apify plans](#free-vs-paid-apify-plans-how-many-staples-stores-can-i-scrape) section above for details.
#### Does this Actor find Staples store URLs for me?
No — this Actor extracts details from store URLs you already have. Use the companion [Staples Store Locator Scraper](https://apify.com/datacach/staples-store-locator-scraper) Actor to generate the list of `stores.staples.com` URLs first, then feed them into this Actor.
#### What happens if a store link is blocked or fails?
The Actor logs the failure and skips that link, continuing with the rest of the batch. The run only fails if **no** link succeeds. Check the run log for per-link status (`blocked` vs `failed`).
#### Can I access this data via API?
Yes. Every Apify Actor run can be triggered and its results retrieved via the [Apify API](https://docs.apify.com/api/v2) and official SDKs for Python and JavaScript, so you can integrate Staples store data directly into your own applications, or connect it to Zapier/Make for no-code automation.
#### Does this Actor use browser automation?
No — it reads structured store data embedded in the page response directly, which makes runs fast and lightweight compared to full browser-based scrapers.
### Support
Found a bug or have a feature request? Open an issue in this Actor's **Issues** tab in Apify Console. Need a custom scraper, extra fields, or a tailored data pipeline? Reach out — custom development and integration support are available.
# Actor input Schema
## `links` (type: `array`):
Staples store page URLs to extract details from, e.g. https://stores.staples.com/al/athens/1036-highway-72-east. Typically these come straight from the output of the Staples Store Locator Scraper. Free-plan accounts process only the first 5 links.
## `maxConcurrency` (type: `integer`):
How many store pages to fetch in parallel. Higher values finish faster but increase the chance of being rate-limited or blocked.
## Actor input object example
```json
{
"links": [
"https://stores.staples.com/al/athens/1036-highway-72-east",
"https://stores.staples.com/ca/los-angeles/5410-wilshire-blvd"
],
"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 '' with your token
const client = new ApifyClient({
token: '',
});
// Prepare Actor input
const input = {
"links": [
"https://stores.staples.com/al/athens/1036-highway-72-east",
"https://stores.staples.com/ca/los-angeles/5410-wilshire-blvd"
]
};
// Run the Actor and wait for it to finish
const run = await client.actor("datacach/staples-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 '' with your token.
client = ApifyClient("")
# Prepare the Actor input
run_input = { "links": [
"https://stores.staples.com/al/athens/1036-highway-72-east",
"https://stores.staples.com/ca/los-angeles/5410-wilshire-blvd",
] }
# Run the Actor and wait for it to finish
run = client.actor("datacach/staples-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.staples.com/al/athens/1036-highway-72-east",
"https://stores.staples.com/ca/los-angeles/5410-wilshire-blvd"
]
}' |
apify call datacach/staples-store-details-scraper --silent --output-dataset
```
## MCP server setup
```json
{
"mcpServers": {
"apify": {
"command": "npx",
"args": [
"mcp-remote",
"https://mcp.apify.com/?tools=datacach/staples-store-details-scraper",
"--header",
"Authorization: Bearer "
]
}
}
}
```
## OpenAPI specification
```json
{
"openapi": "3.0.1",
"info": {
"title": "Staples Store Details & Hours Scraper",
"description": "Extract full Staples store details from locator page URLs — name, address, phone, hours, and GPS coordinates. Export data as JSON, CSV, or Excel.",
"version": "0.0",
"x-build-id": "lRsniXmHB2dHVFwUy"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/datacach~staples-store-details-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-datacach-staples-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~staples-store-details-scraper/runs": {
"post": {
"operationId": "runs-sync-datacach-staples-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~staples-store-details-scraper/run-sync": {
"post": {
"operationId": "run-sync-datacach-staples-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": "Staples store URLs",
"type": "array",
"description": "Staples store page URLs to extract details from, e.g. https://stores.staples.com/al/athens/1036-highway-72-east. Typically these come straight from the output of the Staples Store Locator Scraper. Free-plan accounts process only the first 5 links.",
"items": {
"type": "string"
}
},
"maxConcurrency": {
"title": "Max concurrency",
"minimum": 1,
"maximum": 20,
"type": "integer",
"description": "How many store pages to fetch in parallel. Higher values finish faster but increase the chance of being rate-limited or blocked.",
"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
}
}
}
}
}
}
}
}
}
}
```