# Google Maps Business Hours Scraper (`crawlerbros/google-maps-business-hours`) Actor Extract structured opening hours for all 7 days plus live open/closed status from any Google Maps place page. Supports batch input of multiple place URLs. - **URL**: https://apify.com/crawlerbros/google-maps-business-hours.md - **Developed by:** [Crawler Bros](https://apify.com/crawlerbros) (community) - **Categories:** Automation, Developer tools, SEO tools - **Stats:** 1 total users, 0 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $3.00 / 1,000 results This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage. 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 ## Google Maps Business Hours Scraper Extract structured opening hours for all 7 days and the live open/closed status from any Google Maps place page — in one click. ### What It Does Provide one or more Google Maps place URLs and this actor returns: - **Structured hours for every day of the week** (open time, close time, or "closed") - **Live open/closed status** (`isOpenNow`) at the moment of scraping - **Inline status badge** like "Open - Closes 11 PM" (`hoursStatus`) - **Next open / next close** computed in the business's local timezone — useful for "closes in 2 hours" UX - **Human-readable countdown** such as "Closes in 2 hours" or "Opens in 3 days" - **Weekly summary**: `is24Hours`, `totalHoursPerWeek`, and a `weeklyPattern` (e.g. "Mon-Fri 9 AM - 5 PM, Sat-Sun closed") - **Holiday / special hours** when Google flags a day as "Hours might differ" - **Temporarily closed** badge detection - **Business location** (lat/lng) and IANA **timezone** - **Raw opening hours text** as shown on the place page - **Place ID** for cross-referencing with the Google Maps API ### Use Cases - Build a database of business hours across many locations - Monitor schedule changes for franchise locations - Power local-SEO dashboards with up-to-date hours - Feed hours data into CRMs, booking tools, or notification systems ### Input | Field | Type | Description | |---|---|---| | `placeUrl` | String | Google Maps URL of a single place | | `placeUrls` | Array of strings | Scrape multiple places in one run | | `proxyConfiguration` | Object | Apify proxy settings (recommended) | **Example input:** ```json { "placeUrl": "https://www.google.com/maps/place/Starbucks/@40.7127281,-74.0060152,17z/" } ```` **Batch input:** ```json { "placeUrls": [ "https://www.google.com/maps/place/Starbucks/@40.7127281,-74.0060152,17z/", "https://www.google.com/maps/place/McDonald%27s/@40.7580,−73.9855,17z/" ], "proxyConfiguration": { "useApifyProxy": true } } ``` > **Tip:** Copy the URL directly from the address bar after opening a place on Google Maps. ### Output Each place produces one dataset record: ```json { "businessName": "Starbucks", "placeId": "0x89c259a15b1ac3ad:0x9a0c4ba6e15b7f3", "placeUrl": "https://www.google.com/maps/place/Starbucks/@40.7127281,-74.0060152,17z/", "location": { "lat": 40.7127281, "lng": -74.0060152 }, "isOpenNow": true, "openingHoursText": "Open · Closes 9 PM", "hoursStatus": "Open - Closes 9 PM", "hours": { "monday": { "open": "5:30 AM", "close": "9:00 PM" }, "tuesday": { "open": "5:30 AM", "close": "9:00 PM" }, "wednesday": { "open": "5:30 AM", "close": "9:00 PM" }, "thursday": { "open": "5:30 AM", "close": "9:00 PM" }, "friday": { "open": "5:30 AM", "close": "9:00 PM" }, "saturday": { "open": "6:00 AM", "close": "8:00 PM" }, "sunday": { "closed": true } }, "weeklyPattern": "Mon-Fri 5:30 AM - 9:00 PM, Sat 6:00 AM - 8:00 PM, Sun closed", "totalHoursPerWeek": 91.5, "holidayHours": [ { "day": "friday", "label": "Juneteenth", "note": "Hours might differ", "open": "5:30 AM", "close": "8:00 PM" } ], "timezone": "America/New_York", "currentLocalTime": "2026-06-17T14:23:11-04:00", "nextOpenTime": "2026-06-18T05:30:00-04:00", "nextCloseTime": "2026-06-17T21:00:00-04:00", "timeUntilNextChange": "Closes in 6 hours", "scrapedAt": "2026-06-17T18:23:11+00:00" } ``` #### Hours object format Each day in `hours` is one of: | Format | Meaning | |---|---| | `{"open": "9:00 AM", "close": "5:00 PM"}` | Regular open hours | | `{"closed": true}` | The place is closed that day | | `{"open": "12:00 AM", "close": "11:59 PM", "is24Hours": true}` | Open 24 hours | | `{"raw": "..."}` | Unusual format — raw text preserved | Fields with no data are **never included** in the output (no null values). ### FAQ **Which Google Maps URLs are supported?** Any `google.com/maps/place/...` URL. Copy it from the browser address bar after opening a place card. **Can I scrape hundreds of places?** Yes — use the `placeUrls` array. The actor processes them sequentially with a short delay between requests. For very large batches, split into separate runs. **Why might hours be missing?** Google Maps occasionally renders hours behind an additional interaction or varies the page structure by location/IP. When hours cannot be extracted the `hours` field is omitted from the record; `openingHoursText` may still be present. **Is a proxy required?** Not required, but strongly recommended for reliability. Enable `"useApifyProxy": true` in `proxyConfiguration` to reduce the chance of rate-limiting. **Does this scrape the Google Maps API?** No. It uses a headless browser (Playwright + Chromium) to load the public-facing Google Maps web page, exactly as a human user would. **What is `placeId`?** The internal Google Maps identifier extracted from the URL. It matches the `place_id` returned by the Google Maps Places API and can be used to query additional data from Google's API. ### Data Source Data is extracted from the public Google Maps website (`google.com/maps`). No Google API key or login is required. ### 🗺️ Complete Google Maps Scraper Suite This actor is part of a comprehensive Google Maps data extraction toolkit by **crawlerbros**. All actors run on the free Apify plan, use no proxy by default, and return clean, structured data. | Actor | What it does | |---|---| | 🏢 [Google Maps Business Scraper](https://apify.com/crawlerbros/google-maps-scraper) | Extract business data — name, address, phone, website, rating, reviews, hours, amenities | | ⭐ [Google Maps Reviews Scraper](https://apify.com/crawlerbros/google-maps-reviews-scraper) | Scrape reviews with reviewer Local Guide level, photos, mentioned items, owner replies | | 📸 [Google Maps Photos Scraper](https://apify.com/crawlerbros/google-maps-photos) | Extract all photos from any place — max-resolution URLs, contributor info, categories | | 📊 [Google Maps Popular Times Scraper](https://apify.com/crawlerbros/google-maps-popular-times) | Busy hours histogram for all 7 days + current busyness + typical visit time | | 📧 [Google Maps Email Extractor](https://apify.com/crawlerbros/google-maps-email-extractor) | Find business emails + social media links by crawling websites | | 🗺️ [Google Maps Area Scanner](https://apify.com/crawlerbros/google-maps-area-scanner) | Geographic grid scanning — bypass the 120-place limit with bounding box / circle / polygon | | 💼 [Google Maps Leads Scraper](https://apify.com/crawlerbros/google-maps-leads) | B2B lead generation with email + phone enrichment, US states + global countries | | 🤖 [Google Maps MCP Server](https://apify.com/crawlerbros/google-maps-mcp) | Unified MCP server combining search + reviews for AI assistants | | 🧭 [Google Maps Directions Scraper](https://apify.com/crawlerbros/google-maps-directions) | A→B routing — distance, duration, traffic, route alternatives for driving/walking/transit | | 📍 [Google Maps Geocoding Scraper](https://apify.com/crawlerbros/google-maps-geocoding) | Bidirectional geocoding — address ↔ coordinates, with address components | | 🔗 [Google Maps Similar Places Scraper](https://apify.com/crawlerbros/google-maps-similar-places) | "People also search for" / related place discovery — competitor & alternative finder | | 🍽️ [Google Maps Menu Scraper](https://apify.com/crawlerbros/google-maps-menu) | Restaurant menu items, prices, descriptions, photos | | 📌 [Google Maps Nearby Scraper](https://apify.com/crawlerbros/google-maps-nearby) | Find places near a coordinate point — lightweight POI search by category | | 📋 [Google Maps Place List Scraper](https://apify.com/crawlerbros/google-maps-place-list) | Extract Google's curated "Top X in Y" lists — best hotels/restaurants/things to do | | 🌍 [Google Maps Timezone Scraper](https://apify.com/crawlerbros/google-maps-timezone) | IANA timezone + current local time from coordinates | # Actor input Schema ## `placeUrl` (type: `string`): Google Maps URL of the place to scrape hours from. ## `placeUrls` (type: `array`): Scrape hours from multiple places at once. ## `proxyConfiguration` (type: `object`): Proxy settings to avoid rate limiting. Apify proxy recommended. ## Actor input object example ```json { "placeUrl": "https://www.google.com/maps/place/Starbucks+Reserve+Roastery+New+York/@40.7416,-74.0053,17z/data=!3m1!4b1!4m6!3m5!1s0x89c259bf6dd90021:0x645ce21be1b31735!8m2!3d40.7416!4d-74.0053!16s%2Fg%2F11j7w8j09h?hl=en", "proxyConfiguration": { "useApifyProxy": true } } ``` # Actor output Schema ## `businessHours` (type: `string`): Dataset containing all scraped Google Maps business hours records. # 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 = { "placeUrl": "https://www.google.com/maps/place/Starbucks+Reserve+Roastery+New+York/@40.7416,-74.0053,17z/data=!3m1!4b1!4m6!3m5!1s0x89c259bf6dd90021:0x645ce21be1b31735!8m2!3d40.7416!4d-74.0053!16s%2Fg%2F11j7w8j09h?hl=en", "proxyConfiguration": { "useApifyProxy": true } }; // Run the Actor and wait for it to finish const run = await client.actor("crawlerbros/google-maps-business-hours").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 = { "placeUrl": "https://www.google.com/maps/place/Starbucks+Reserve+Roastery+New+York/@40.7416,-74.0053,17z/data=!3m1!4b1!4m6!3m5!1s0x89c259bf6dd90021:0x645ce21be1b31735!8m2!3d40.7416!4d-74.0053!16s%2Fg%2F11j7w8j09h?hl=en", "proxyConfiguration": { "useApifyProxy": True }, } # Run the Actor and wait for it to finish run = client.actor("crawlerbros/google-maps-business-hours").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 '{ "placeUrl": "https://www.google.com/maps/place/Starbucks+Reserve+Roastery+New+York/@40.7416,-74.0053,17z/data=!3m1!4b1!4m6!3m5!1s0x89c259bf6dd90021:0x645ce21be1b31735!8m2!3d40.7416!4d-74.0053!16s%2Fg%2F11j7w8j09h?hl=en", "proxyConfiguration": { "useApifyProxy": true } }' | apify call crawlerbros/google-maps-business-hours --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=crawlerbros/google-maps-business-hours", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Google Maps Business Hours Scraper", "description": "Extract structured opening hours for all 7 days plus live open/closed status from any Google Maps place page. Supports batch input of multiple place URLs.", "version": "1.4", "x-build-id": "9eoBfUpdJQZFqZjWn" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/crawlerbros~google-maps-business-hours/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-crawlerbros-google-maps-business-hours", "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/crawlerbros~google-maps-business-hours/runs": { "post": { "operationId": "runs-sync-crawlerbros-google-maps-business-hours", "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/crawlerbros~google-maps-business-hours/run-sync": { "post": { "operationId": "run-sync-crawlerbros-google-maps-business-hours", "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": { "placeUrl": { "title": "Place URL", "type": "string", "description": "Google Maps URL of the place to scrape hours from." }, "placeUrls": { "title": "Multiple Place URLs", "type": "array", "description": "Scrape hours from multiple places at once.", "items": { "type": "string" } }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Proxy settings to avoid rate limiting. Apify proxy recommended." } } }, "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 } } } } } } } } } } ```