Under maintenance

Pricing

from $2.00 / 1,000 results

Try for free

Go to Apify Store

Google Maps Scraper

Under maintenance

Try for free

It will help you scrape the Google Maps leads with emails looking into the websites listed.

Pricing

from $2.00 / 1,000 results

Rating

5.0

(1)

Developer

COMMON_MAN

Actor stats

Bookmarked

Total users

Monthly active users

4 days ago

Last modified

Google Maps Leads

brilliant_ethics/google-maps-leads

Laurent Poyet

Google Maps Scraper

mohamedgb00714/Google-Maps-Scraper

mohamed el hadi msaid

Google Maps Scraper

johnadeolu401/google-maps-scraper

John Adeolu

Google Maps Scraper

creactivostudios/google-maps-scraper

Creactivo Studios

3.0

Google Maps Scraper

surigami/google-maps-scraper

📍 Google Maps Scraper Google Maps Scraper lets you extract business data from Google Maps.

surigami

Google Maps Scraper

rupom888/google-maps-scraper

Extract business listings from Google Maps.

Syed Rupom

Google Maps Scraper

paulwrsc/google-maps-scraper

Scrapes business data from Google Maps

Paul Würschinger

GOOGLE-MAPS-Scraper LEADS-CONTACT-DATA

cyber_orbit/n8n-feed-v1gmaps-scraper-apify-actor-main-website-urlactive

GOOGLE-MAPS-Scraper LEADS-CONTACT-DATA

Team Cyber Orbit

Fast Google Maps Scraper

majestic_gas/fast-google-maps-scraper

Fast Google Maps Scraper

MD Atick

Google Maps Lead Scraper

brennanthethird/google-maps-lead-scraper

Brennan Jones

{ "$schema": "https://apify.com/schemas/v1/actor.ide.json", "actorSpecification": 1, "name": "my-actor", "title": "Project Cheerio Crawler Javascript", "description": "Crawlee and Cheerio project in javascript.", "version": "0.0", "meta": { "templateId": "js-crawlee-cheerio", "generatedBy": "<FILL-IN-MODEL>" }, "input": "./input_schema.json", "output": "./output_schema.json", "storages": { "dataset": "./dataset_schema.json" }, "dockerfile": "../Dockerfile" }

{ "$schema": "https://apify.com/schemas/v1/dataset.ide.json", "actorSpecification": 1, "fields": {}, "views": { "overview": { "title": "Overview", "transformation": { "fields": ["title", "url"] }, "display": { "component": "table", "properties": { "title": { "label": "Title", "format": "text" }, "url": { "label": "URL", "format": "link" } } } } } }

{ "title": "Google Maps Business Scraper", "type": "object", "schemaVersion": 1, "properties": { "searchQuery": { "title": "Search Query", "type": "string", "description": "What to search on Google Maps. Example: 'restaurants in New York', 'dentists in London', 'hotels in Paris'", "editor": "textfield", "default": "restaurants in New York", "prefill": "restaurants in New York" }, "maxResults": { "title": "Maximum Results", "type": "integer", "description": "Maximum number of businesses to scrape (1–200). Higher numbers take longer to complete.", "editor": "number", "default": 3, "prefill": 3, "minimum": 1, "maximum": 200 } }, "required": ["searchQuery"] }

{ "$schema": "https://apify.com/schemas/v1/output.ide.json", "actorOutputSchemaVersion": 1, "title": "Output schema", "properties": { "results": { "type": "string", "title": "Results", "template": "{{links.apiDefaultDatasetUrl}}/items" } } }

name: CI on: pull_request: push: branches: [main, master] jobs: test: runs-on: ubuntu-latest steps: - uses: actions/checkout@v6 - uses: actions/setup-node@v6 with: node-version: 24 cache: npm - run: npm ci - run: npm test

1import { Actor } from 'apify'; 2import { PlaywrightCrawler, Dataset, sleep } from 'crawlee'; 3 4await Actor.init(); 5 6const input = await Actor.getInput() ?? {}; 7const { searchQuery = 'restaurants in Kathmandu', maxResults = 5 } = input; 8 9console.log(`🗺️ Google Maps Scraper started`); 10console.log(`🔍 Search: "${searchQuery}"`); 11 12const allResults = []; 13 14const crawler = new PlaywrightCrawler({ 15 headless: true, 16 navigationTimeoutSecs: 60, 17 requestHandlerTimeoutSecs: 300, 18 async requestHandler({ page, log }) { 19 try { 20 const acceptBtn = await page.$('button[aria-label*="Accept"], form[action*="consent"] button'); 21 if (acceptBtn) { await acceptBtn.click(); await sleep(1500); } 22 } catch {} 23 24 await page.waitForSelector('[role="feed"]', { timeout: 30000 }).catch(() => 25 log.warning('Feed not found') 26 ); 27 await sleep(2000); 28 29 log.info('Loading results by scrolling...'); 30 let prevCount = 0; 31 let noChangeCount = 0; 32 33 while (noChangeCount < 5) { 34 await page.evaluate(() => { 35 const feed = document.querySelector('[role="feed"]'); 36 if (feed) feed.scrollBy(0, 1200); 37 }); 38 await sleep(1800); 39 40 const currentLinks = await page.$$('[role="feed"] a[href*="/maps/place/"]'); 41 const count = currentLinks.length; 42 log.info(` Found ${count} places so far...`); 43 44 if (count === prevCount) { noChangeCount++; } else { noChangeCount = 0; prevCount = count; } 45 if (count >= maxResults) break; 46 } 47 48 const placeUrls = await page.evaluate((max) => { 49 const links = [...document.querySelectorAll('[role="feed"] a[href*="/maps/place/"]')]; 50 return [...new Set(links.map((l) => l.href))].slice(0, max); 51 }, maxResults); 52 53 log.info(`🏪 Scraping ${placeUrls.length} places...`); 54 55 for (const placeUrl of placeUrls) { 56 try { 57 await page.goto(placeUrl, { waitUntil: 'domcontentloaded', timeout: 30000 }); 58 await sleep(2500); 59 60 const placeData = await page.evaluate(() => { 61 const q = (sel) => document.querySelector(sel)?.textContent?.trim() ?? null; 62 const qa = (sel, attr) => document.querySelector(sel)?.getAttribute(attr) ?? null; 63 const name = q('h1'); 64 const ratingLabel = qa('[aria-label*="stars"]', 'aria-label') || qa('[aria-label*=" star"]', 'aria-label'); 65 const rating = ratingLabel ? parseFloat(ratingLabel) : null; 66 const reviewLabel = qa('[aria-label*="review"]', 'aria-label'); 67 const reviewMatch = reviewLabel?.match(/([\d,]+)/); 68 const reviewCount = reviewMatch ? parseInt(reviewMatch[1].replace(',', '')) : null; 69 const category = q('button.DkEaL'); 70 let address = null, phone = null, website = null; 71 const infoItems = [...document.querySelectorAll('[data-item-id]')]; 72 for (const item of infoItems) { 73 const id = item.getAttribute('data-item-id') || ''; 74 if (id === 'address') address = item.textContent.trim(); 75 if (id.startsWith('phone:')) phone = id.replace('phone:', ''); 76 if (id === 'authority') website = item.querySelector('a')?.href || item.textContent.trim(); 77 } 78 const coords = window.location.href.match(/@(-?\d+\.\d+),(-?\d+\.\d+)/); 79 return { 80 name, category, rating, reviewCount, address, phone, website, 81 latitude: coords ? parseFloat(coords[1]) : null, 82 longitude: coords ? parseFloat(coords[2]) : null, 83 googleMapsUrl: window.location.href, 84 }; 85 }); 86 87 if (placeData.name) { 88 allResults.push(placeData); 89 await Dataset.pushData(placeData); 90 log.info(`✅ [${allResults.length}/${placeUrls.length}] ${placeData.name}`); 91 } 92 await sleep(1200); 93 } catch (err) { 94 log.error(`❌ Skipped: ${err.message}`); 95 } 96 } 97 }, 98}); 99 100const startUrl = `https://www.google.com/maps/search/${encodeURIComponent(searchQuery)}/?hl=en`; 101await crawler.run([startUrl]); 102console.log(`\n🎉 Done! Scraped ${allResults.length} places.`); 103await Actor.exit();

1import { createCheerioRouter } from '@crawlee/cheerio'; 2 3export const router = createCheerioRouter(); 4 5router.addDefaultHandler(async ({ enqueueLinks, request, $, log, pushData }) => { 6 log.info('enqueueing new URLs'); 7 await enqueueLinks(); 8 9 // Extract title from the page. 10 const title = $('title').text(); 11 log.info(`${title}`, { url: request.loadedUrl }); 12 13 // Save url and title to Dataset - a table-like storage. 14 await pushData({ url: request.loadedUrl, title }); 15});

1import { CheerioCrawler, purgeDefaultStorages } from '@crawlee/cheerio'; 2import { beforeAll, describe, expect, it } from 'vitest'; 3 4import { router } from '../src/routes.js'; 5 6describe('CheerioCrawler', () => { 7 beforeAll(async () => { 8 await purgeDefaultStorages(); 9 }); 10 11 it('should crawl a page and extract data to dataset', async () => { 12 const crawler = new CheerioCrawler({ 13 maxRequestsPerCrawl: 10, 14 requestHandler: router, 15 }); 16 17 await crawler.run(['https://www.example.com']); 18 19 expect(crawler.stats.state.requestsFinished).toBeGreaterThanOrEqual(1); 20 21 const { items } = await crawler.getData(); 22 expect(items.length).toBeGreaterThan(0); 23 expect(items[0].url).toContain('example.com'); 24 expect(items[0].title).toContain('Example Domain'); 25 }, 30_000); 26});

1# Apify Actors Development Guide 2 3Important: Before you begin, fill in the `generatedBy` property in the meta section of `.actor/actor.json`. Replace it with the tool and model you're currently using, such as "Claude Code with Claude Sonnet 4.5". This helps Apify monitor and improve AGENTS.md for specific AI tools and models. 4 5## What are Apify Actors? 6 7- Actors are serverless programs that run in the cloud. They're inspired by the UNIX philosophy - programs that do one thing well and can be easily combined to build complex systems. 8- Actors are programs packaged as Docker images that run in isolated containers 9 10## Core Concepts 11 12- Accept well-defined JSON input 13- Perform isolated tasks (web scraping, automation, data processing) 14- Produce structured JSON output to datasets and/or store data in key-value stores 15- Can run from seconds to hours or even indefinitely 16- Persist state and can be restarted 17 18## Do 19 20- accept well-defined JSON input and produce structured JSON output 21- use Apify SDK (`apify`) for code running ON Apify platform 22- validate input early with proper error handling and fail gracefully 23- use CheerioCrawler for static HTML content (10x faster than browsers) 24- use PlaywrightCrawler only for JavaScript-heavy sites and dynamic content 25- use router pattern (createCheerioRouter/createPlaywrightRouter) for complex crawls 26- implement retry strategies with exponential backoff for failed requests 27- use proper concurrency settings (HTTP: 10-50, Browser: 1-5) 28- set sensible defaults in `.actor/input_schema.json` for all optional fields 29- set up output schema in `.actor/output_schema.json` 30- clean and validate data before pushing to dataset 31- use semantic CSS selectors and fallback strategies for missing elements 32- respect robots.txt, ToS, and implement rate limiting with delays 33- check which tools (cheerio/playwright/crawlee) are installed before applying guidance 34- use `apify/log` package for logging (censors sensitive data) 35- implement readiness probe handler for standby Actors 36- handle the `aborting` event to gracefully shut down when Actor is stopped 37 38## Don't 39 40- do not rely on `Dataset.getInfo()` for final counts on Cloud platform 41- do not use browser crawlers when HTTP/Cheerio works (massive performance gains with HTTP) 42- do not hard code values that should be in input schema or environment variables 43- do not skip input validation or error handling 44- do not overload servers - use appropriate concurrency and delays 45- do not scrape prohibited content or ignore Terms of Service 46- do not store personal/sensitive data unless explicitly permitted 47- do not use deprecated options like `requestHandlerTimeoutMillis` on CheerioCrawler (v3.x) 48- do not use `additionalHttpHeaders` - use `preNavigationHooks` instead 49- do not assume that local storage is persistent or automatically synced to Apify Console - when running locally with `apify run`, the `storage/` directory is local-only and is NOT pushed to the Cloud 50- do not disable standby mode (`usesStandbyMode: false`) without explicit permission 51 52## Logging 53 54- **ALWAYS use the `apify/log` package for logging** - This package contains critical security logic including censoring sensitive data (Apify tokens, API keys, credentials) to prevent accidental exposure in logs 55 56### Available Log Levels in `apify/log` 57 58The Apify log package provides the following methods for logging: 59 60- `log.debug()` - Debug level logs (detailed diagnostic information) 61- `log.info()` - Info level logs (general informational messages) 62- `log.warning()` - Warning level logs (warning messages for potentially problematic situations) 63- `log.warningOnce()` - Warning level logs (same warning message logged only once) 64- `log.error()` - Error level logs (error messages for failures) 65- `log.exception()` - Exception level logs (for exceptions with stack traces) 66- `log.perf()` - Performance level logs (performance metrics and timing information) 67- `log.deprecated()` - Deprecation level logs (warnings about deprecated code) 68- `log.softFail()` - Soft failure logs (non-critical failures that don't stop execution, e.g., input validation errors, skipped items) 69- `log.internal()` - Internal level logs (internal/system messages) 70 71**Best practices:** 72 73- Use `log.debug()` for detailed operation-level diagnostics (inside functions) 74- Use `log.info()` for general informational messages (API requests, successful operations) 75- Use `log.warning()` for potentially problematic situations (validation failures, unexpected states) 76- Use `log.error()` for actual errors and failures 77- Use `log.exception()` for caught exceptions with stack traces 78 79## Graceful Abort Handling 80 81Handle the `aborting` event to terminate the Actor quickly when stopped by user or platform, minimizing costs especially for PPU/PPE+U billing. 82 83```javascript 84import { setTimeout } from 'node:timers/promises'; 85 86Actor.on('aborting', async () => { 87 // Persist any state, do any cleanup you need, and terminate the Actor using `await Actor.exit()` explicitly as soon as possible 88 // This will help ensure that the Actor is doing best effort to honor any potential limits on costs of a single run set by the user 89 // Wait 1 second to allow Crawlee/SDK useState and other state persistence operations to complete 90 // This is a temporary workaround until SDK implements proper state persistence in the aborting event 91 await setTimeout(1000); 92 await Actor.exit(); 93}); 94``` 95 96## Standby Mode 97 98- **NEVER disable standby mode (`usesStandbyMode: false`) in `.actor/actor.json` without explicit permission** - Actor Standby mode solves this problem by letting you have the Actor ready in the background, waiting for the incoming HTTP requests. In a sense, the Actor behaves like a real-time web server or standard API server instead of running the logic once to process everything in batch. Always keep `usesStandbyMode: true` unless there is a specific documented reason to disable it 99- **ALWAYS implement readiness probe handler for standby Actors** - Handle the `x-apify-container-server-readiness-probe` header at GET / endpoint to ensure proper Actor lifecycle management 100 101You can recognize a standby Actor by checking the `usesStandbyMode` property in `.actor/actor.json`. Only implement the readiness probe if this property is set to `true`. 102 103### Readiness Probe Implementation Example 104 105```javascript 106// Apify standby readiness probe at root path 107app.get('/', (req, res) => { 108 res.writeHead(200, { 'Content-Type': 'text/plain' }); 109 if (req.headers['x-apify-container-server-readiness-probe']) { 110 res.end('Readiness probe OK\n'); 111 } else { 112 res.end('Actor is ready\n'); 113 } 114}); 115``` 116 117Key points: 118 119- Detect the `x-apify-container-server-readiness-probe` header in incoming requests 120- Respond with HTTP 200 status code for both readiness probe and normal requests 121- This enables proper Actor lifecycle management in standby mode 122 123## Commands 124 125```bash 126# Local development 127apify run # Run Actor locally 128 129# Authentication & deployment 130apify login # Authenticate account 131apify push # Deploy to Apify platform 132 133# Help 134apify help # List all commands 135``` 136 137## Safety and Permissions 138 139Allowed without prompt: 140 141- read files with `Actor.getValue()` 142- push data with `Actor.pushData()` 143- set values with `Actor.setValue()` 144- enqueue requests to RequestQueue 145- run locally with `apify run` 146 147Ask first: 148 149- npm/pip package installations 150- apify push (deployment to cloud) 151- proxy configuration changes (requires paid plan) 152- Dockerfile changes affecting builds 153- deleting datasets or key-value stores 154 155## Project Structure 156 157.actor/ 158├── actor.json # Actor config: name, version, env vars, runtime settings 159├── input_schema.json # Input validation & Console form definition 160└── output_schema.json # Specifies where an Actor stores its output 161src/ 162└── main.js # Actor entry point and orchestrator 163storage/ # Local-only storage for development (NOT synced to Cloud) 164├── datasets/ # Output items (JSON objects) 165├── key_value_stores/ # Files, config, INPUT 166└── request_queues/ # Pending crawl requests 167Dockerfile # Container image definition 168AGENTS.md # AI agent instructions (this file) 169 170## Local vs Cloud Storage 171 172When running locally with `apify run`, the Apify SDK emulates Cloud storage APIs using the local `storage/` directory. This local storage behaves differently from Cloud storage: 173 174- **Local storage is NOT persistent** - The `storage/` directory is meant for local development and testing only. Data stored there (datasets, key-value stores, request queues) exists only on your local disk. 175- **Local storage is NOT automatically pushed to Apify Console** - Running `apify run` does not upload any storage data to the Apify platform. The data stays local. 176- **Each local run may overwrite previous data** - The local `storage/` directory is reused between runs, but this is local-only behavior, not Cloud persistence. 177- **Cloud storage only works when running on Apify platform** - After deploying with `apify push` and running the Actor in the Cloud, storage calls (`Actor.pushData()`, `Actor.setValue()`, etc.) interact with real Apify Cloud storage, which is then visible in the Apify Console. 178- **To verify Actor output, deploy and run in Cloud** - Do not rely on local `storage/` contents as proof that data will appear in the Apify Console. Always test by deploying (`apify push`) and running the Actor on the platform. 179 180## Actor Input Schema 181 182The input schema defines the input parameters for an Actor. It's a JSON object comprising various field types supported by the Apify platform. 183 184### Structure 185 186```json 187{ 188 "title": "<INPUT-SCHEMA-TITLE>", 189 "type": "object", 190 "schemaVersion": 1, 191 "properties": { 192 /* define input fields here */ 193 }, 194 "required": [] 195} 196``` 197 198### Example 199 200```json 201{ 202 "title": "E-commerce Product Scraper Input", 203 "type": "object", 204 "schemaVersion": 1, 205 "properties": { 206 "startUrls": { 207 "title": "Start URLs", 208 "type": "array", 209 "description": "URLs to start scraping from (category pages or product pages)", 210 "editor": "requestListSources", 211 "default": [{ "url": "https://example.com/category" }], 212 "prefill": [{ "url": "https://example.com/category" }] 213 }, 214 "followVariants": { 215 "title": "Follow Product Variants", 216 "type": "boolean", 217 "description": "Whether to scrape product variants (different colors, sizes)", 218 "default": true 219 }, 220 "maxRequestsPerCrawl": { 221 "title": "Max Requests per Crawl", 222 "type": "integer", 223 "description": "Maximum number of pages to scrape (0 = unlimited)", 224 "default": 1000, 225 "minimum": 0 226 }, 227 "proxyConfiguration": { 228 "title": "Proxy Configuration", 229 "type": "object", 230 "description": "Proxy settings for anti-bot protection", 231 "editor": "proxy", 232 "default": { "useApifyProxy": false } 233 }, 234 "locale": { 235 "title": "Locale", 236 "type": "string", 237 "description": "Language/country code for localized content", 238 "default": "cs", 239 "enum": ["cs", "en", "de", "sk"], 240 "enumTitles": ["Czech", "English", "German", "Slovak"] 241 } 242 }, 243 "required": ["startUrls"] 244} 245``` 246 247## Actor Output Schema 248 249The Actor output schema builds upon the schemas for the dataset and key-value store. It specifies where an Actor stores its output and defines templates for accessing that output. Apify Console uses these output definitions to display run results. 250 251### Structure 252 253```json 254{ 255 "actorOutputSchemaVersion": 1, 256 "title": "<OUTPUT-SCHEMA-TITLE>", 257 "properties": { 258 /* define your outputs here */ 259 } 260} 261``` 262 263### Example 264 265```json 266{ 267 "actorOutputSchemaVersion": 1, 268 "title": "Output schema of the files scraper", 269 "properties": { 270 "files": { 271 "type": "string", 272 "title": "Files", 273 "template": "{{links.apiDefaultKeyValueStoreUrl}}/keys" 274 }, 275 "dataset": { 276 "type": "string", 277 "title": "Dataset", 278 "template": "{{links.apiDefaultDatasetUrl}}/items" 279 } 280 } 281} 282``` 283 284### Output Schema Template Variables 285 286- `links` (object) - Contains quick links to most commonly used URLs 287- `links.publicRunUrl` (string) - Public run url in format `https://console.apify.com/view/runs/:runId` 288- `links.consoleRunUrl` (string) - Console run url in format `https://console.apify.com/actors/runs/:runId` 289- `links.apiRunUrl` (string) - API run url in format `https://api.apify.com/v2/actor-runs/:runId` 290- `links.apiDefaultDatasetUrl` (string) - API url of default dataset in format `https://api.apify.com/v2/datasets/:defaultDatasetId` 291- `links.apiDefaultKeyValueStoreUrl` (string) - API url of default key-value store in format `https://api.apify.com/v2/key-value-stores/:defaultKeyValueStoreId` 292- `links.containerRunUrl` (string) - URL of a webserver running inside the run in format `https://<containerId>.runs.apify.net/` 293- `run` (object) - Contains information about the run same as it is returned from the `GET Run` API endpoint 294- `run.defaultDatasetId` (string) - ID of the default dataset 295- `run.defaultKeyValueStoreId` (string) - ID of the default key-value store 296 297## Dataset Schema Specification 298 299The dataset schema defines how your Actor's output data is structured, transformed, and displayed in the Output tab in the Apify Console. 300 301### Example 302 303Consider an example Actor that calls `Actor.pushData()` to store data into dataset: 304 305```javascript 306import { Actor } from 'apify'; 307// Initialize the JavaScript SDK 308await Actor.init(); 309 310/** 311 * Actor code 312 */ 313await Actor.pushData({ 314 numericField: 10, 315 pictureUrl: 'https://www.google.com/images/branding/googlelogo/2x/googlelogo_color_92x30dp.png', 316 linkUrl: 'https://google.com', 317 textField: 'Google', 318 booleanField: true, 319 dateField: new Date(), 320 arrayField: ['#hello', '#world'], 321 objectField: {}, 322}); 323 324// Exit successfully 325await Actor.exit(); 326``` 327 328To set up the Actor's output tab UI, reference a dataset schema file in `.actor/actor.json`: 329 330```json 331{ 332 "actorSpecification": 1, 333 "name": "book-library-scraper", 334 "title": "Book Library Scraper", 335 "version": "1.0.0", 336 "storages": { 337 "dataset": "./dataset_schema.json" 338 } 339} 340``` 341 342Then create the dataset schema in `.actor/dataset_schema.json`: 343 344```json 345{ 346 "actorSpecification": 1, 347 "fields": {}, 348 "views": { 349 "overview": { 350 "title": "Overview", 351 "transformation": { 352 "fields": [ 353 "pictureUrl", 354 "linkUrl", 355 "textField", 356 "booleanField", 357 "arrayField", 358 "objectField", 359 "dateField", 360 "numericField" 361 ] 362 }, 363 "display": { 364 "component": "table", 365 "properties": { 366 "pictureUrl": { 367 "label": "Image", 368 "format": "image" 369 }, 370 "linkUrl": { 371 "label": "Link", 372 "format": "link" 373 }, 374 "textField": { 375 "label": "Text", 376 "format": "text" 377 }, 378 "booleanField": { 379 "label": "Boolean", 380 "format": "boolean" 381 }, 382 "arrayField": { 383 "label": "Array", 384 "format": "array" 385 }, 386 "objectField": { 387 "label": "Object", 388 "format": "object" 389 }, 390 "dateField": { 391 "label": "Date", 392 "format": "date" 393 }, 394 "numericField": { 395 "label": "Number", 396 "format": "number" 397 } 398 } 399 } 400 } 401 } 402} 403``` 404 405### Structure 406 407```json 408{ 409 "actorSpecification": 1, 410 "fields": {}, 411 "views": { 412 "<VIEW_NAME>": { 413 "title": "string (required)", 414 "description": "string (optional)", 415 "transformation": { 416 "fields": ["string (required)"], 417 "unwind": ["string (optional)"], 418 "flatten": ["string (optional)"], 419 "omit": ["string (optional)"], 420 "limit": "integer (optional)", 421 "desc": "boolean (optional)" 422 }, 423 "display": { 424 "component": "table (required)", 425 "properties": { 426 "<FIELD_NAME>": { 427 "label": "string (optional)", 428 "format": "text|number|date|link|boolean|image|array|object (optional)" 429 } 430 } 431 } 432 } 433 } 434} 435``` 436 437**Dataset Schema Properties:** 438 439- `actorSpecification` (integer, required) - Specifies the version of dataset schema structure document (currently only version 1) 440- `fields` (JSONSchema object, required) - Schema of one dataset object (use JsonSchema Draft 2020-12 or compatible) 441- `views` (DatasetView object, required) - Object with API and UI views description 442 443**DatasetView Properties:** 444 445- `title` (string, required) - Visible in UI Output tab and API 446- `description` (string, optional) - Only available in API response 447- `transformation` (ViewTransformation object, required) - Data transformation applied when loading from Dataset API 448- `display` (ViewDisplay object, required) - Output tab UI visualization definition 449 450**ViewTransformation Properties:** 451 452- `fields` (string[], required) - Fields to present in output (order matches column order) 453- `unwind` (string[], optional) - Deconstructs nested children into parent object 454- `flatten` (string[], optional) - Transforms nested object into flat structure 455- `omit` (string[], optional) - Removes specified fields from output 456- `limit` (integer, optional) - Maximum number of results (default: all) 457- `desc` (boolean, optional) - Sort order (true = newest first) 458 459**ViewDisplay Properties:** 460 461- `component` (string, required) - Only `table` is available 462- `properties` (Object, optional) - Keys matching `transformation.fields` with ViewDisplayProperty values 463 464**ViewDisplayProperty Properties:** 465 466- `label` (string, optional) - Table column header 467- `format` (string, optional) - One of: `text`, `number`, `date`, `link`, `boolean`, `image`, `array`, `object` 468 469## Key-Value Store Schema Specification 470 471The key-value store schema organizes keys into logical groups called collections for easier data management. 472 473### Example 474 475Consider an example Actor that calls `Actor.setValue()` to save records into the key-value store: 476 477```javascript 478import { Actor } from 'apify'; 479// Initialize the JavaScript SDK 480await Actor.init(); 481 482/** 483 * Actor code 484 */ 485await Actor.setValue('document-1', 'my text data', { contentType: 'text/plain' }); 486 487await Actor.setValue(`image-${imageID}`, imageBuffer, { contentType: 'image/jpeg' }); 488 489// Exit successfully 490await Actor.exit(); 491``` 492 493To configure the key-value store schema, reference a schema file in `.actor/actor.json`: 494 495```json 496{ 497 "actorSpecification": 1, 498 "name": "data-collector", 499 "title": "Data Collector", 500 "version": "1.0.0", 501 "storages": { 502 "keyValueStore": "./key_value_store_schema.json" 503 } 504} 505``` 506 507Then create the key-value store schema in `.actor/key_value_store_schema.json`: 508 509```json 510{ 511 "actorKeyValueStoreSchemaVersion": 1, 512 "title": "Key-Value Store Schema", 513 "collections": { 514 "documents": { 515 "title": "Documents", 516 "description": "Text documents stored by the Actor", 517 "keyPrefix": "document-" 518 }, 519 "images": { 520 "title": "Images", 521 "description": "Images stored by the Actor", 522 "keyPrefix": "image-", 523 "contentTypes": ["image/jpeg"] 524 } 525 } 526} 527``` 528 529### Structure 530 531```json 532{ 533 "actorKeyValueStoreSchemaVersion": 1, 534 "title": "string (required)", 535 "description": "string (optional)", 536 "collections": { 537 "<COLLECTION_NAME>": { 538 "title": "string (required)", 539 "description": "string (optional)", 540 "key": "string (conditional - use key OR keyPrefix)", 541 "keyPrefix": "string (conditional - use key OR keyPrefix)", 542 "contentTypes": ["string (optional)"], 543 "jsonSchema": "object (optional)" 544 } 545 } 546} 547``` 548 549**Key-Value Store Schema Properties:** 550 551- `actorKeyValueStoreSchemaVersion` (integer, required) - Version of key-value store schema structure document (currently only version 1) 552- `title` (string, required) - Title of the schema 553- `description` (string, optional) - Description of the schema 554- `collections` (Object, required) - Object where each key is a collection ID and value is a Collection object 555 556**Collection Properties:** 557 558- `title` (string, required) - Collection title shown in UI tabs 559- `description` (string, optional) - Description appearing in UI tooltips 560- `key` (string, conditional) - Single specific key for this collection 561- `keyPrefix` (string, conditional) - Prefix for keys included in this collection 562- `contentTypes` (string[], optional) - Allowed content types for validation 563- `jsonSchema` (object, optional) - JSON Schema Draft 07 format for `application/json` content type validation 564 565Either `key` or `keyPrefix` must be specified for each collection, but not both. 566 567## Actor README 568 569**Always generate a README.md file as part of Actor development.** The README is the Actor's public landing page on Apify Store - it serves as SEO, first impression, documentation, and support page combined. 570 571### Required: Generate README automatically 572 573When building an Actor, always create a `README.md` in the project root. Do not wait for the user to ask for it. The README is a critical part of a complete Actor. 574 575### README structure 576 577Write in Markdown. Use H2 (`##`) for main sections (these become the table of contents) and H3 (`###`) for subsections. Do not use H1 - the Actor name is automatically the H1. Aim for at least 300 words. 578 579Include these sections in order: 580 5811. **What does [Actor name] do?** - 2-3 sentences explaining what it does, what data it extracts, and how to try it. Link to the target website. Mention Apify platform advantages (API access, scheduling, integrations, proxy rotation, monitoring). 5822. **Why use [Actor name]?** - Business use cases and benefits. 5833. **How to use [Actor name]** - Numbered step-by-step tutorial. Keep it simple and reassuring. 5844. **Input** - Describe input fields. Reference the Input tab. Optionally include a screenshot or JSON example of the input schema. 5855. **Output** - Show a simplified JSON output example. Mention "You can download the dataset in various formats such as JSON, HTML, CSV, or Excel." 5866. **Data table** - If the Actor extracts data, include a table of the main data fields it outputs. 5877. **Pricing / Cost estimation** - Set expectations on cost. Mention free tier limits if applicable. Frame as "How much does it cost to scrape [target site]?" 5888. **Tips or Advanced options** - How to optimize runs, limit compute units, improve speed or accuracy. 5899. **FAQ, disclaimers, and support** - Legality disclaimer for scrapers, known limitations, link to Issues tab for feedback, mention custom solution availability. 590 591### README best practices 592 593- Write SEO-friendly headings with relevant keywords (e.g., "How to scrape [site] data" not just "Tutorial") 594- Bold the most important words in the intro 595- The first 25% of the README matters most - front-load the value proposition 596- Match the tone to the target audience: simple language for no-code users, technical details for developers 597- Include a JSON output example showing 1-2 representative items 598- Reference these top Actors for README best practices: https://apify.com/apify/instagram-scraper and https://apify.com/compass/crawler-google-places 599- Embed YouTube video URLs on their own line (Apify Console auto-renders them) 600- Use HTML for image sizing if needed; CSS is not supported 601 602## Apify MCP Tools 603 604If MCP server is configured, use these tools for documentation: 605 606- `search-apify-docs` - Search documentation 607- `fetch-apify-docs` - Get full doc pages 608 609Otherwise, reference: `@https://mcp.apify.com/` 610 611## Resources 612 613- [docs.apify.com/llms.txt](https://docs.apify.com/llms.txt) - Quick reference 614- [docs.apify.com/llms-full.txt](https://docs.apify.com/llms-full.txt) - Complete docs 615- [crawlee.dev](https://crawlee.dev) - Crawlee documentation 616- [whitepaper.actor](https://raw.githubusercontent.com/apify/actor-whitepaper/refs/heads/master/README.md) - Complete Actor specification

1import prettier from 'eslint-config-prettier'; 2 3import apify from '@apify/eslint-config/js.js'; 4 5// eslint-disable-next-line import-x/no-default-export 6export default [{ ignores: ['**/dist'] }, ...apify, prettier];

1import { Actor } from 'apify'; 2import { PlaywrightCrawler, Dataset, sleep, RequestQueue } from 'crawlee'; 3 4await Actor.init(); 5 6const input = await Actor.getInput() ?? {}; 7const { 8 searchQuery = 'hotels in kathmandu', 9 maxResults = 3, 10 fetchEmailFromWebsite = false, 11} = input; 12 13console.log('Google Maps Scraper'); 14console.log(`Search: "${searchQuery}" | Max: ${maxResults} | Fetch email: ${fetchEmailFromWebsite}`); 15 16// Use RESIDENTIAL proxy if available, fall back gracefully 17let proxyConfiguration; 18try { 19 proxyConfiguration = await Actor.createProxyConfiguration({ 20 groups: ['RESIDENTIAL'], 21 countryCode: 'US', 22 }); 23} catch (err) { 24 console.warn('RESIDENTIAL proxy unavailable, running without proxy:', err.message); 25 proxyConfiguration = undefined; 26} 27 28function normalizeImageUrl(url) { 29 if (!url) return null; 30 let normalized = url.replace(/[=?&](w|h|s|k-no|k|p|f|g|r|scale|rotate|size|width|height)=\d+(-[a-z0-9]+)?/gi, ''); 31 normalized = normalized.replace(/=s\d+(-[a-z0-9]+)?$/i, ''); 32 normalized = normalized.replace(/[?&]$/, ''); 33 return normalized; 34} 35 36function formatPhone(phoneRaw) { 37 if (!phoneRaw) return null; 38 let cleaned = phoneRaw.replace(/^tel:/, ''); 39 let digits = cleaned.replace(/[^\d+]/g, ''); 40 if (digits.startsWith('+1') && digits.length === 12) { 41 return `+1 ${digits.slice(2, 5)}-${digits.slice(5, 8)}-${digits.slice(8)}`; 42 } else if (digits.startsWith('1') && digits.length === 11) { 43 return `+${digits.slice(0, 1)} ${digits.slice(1, 4)}-${digits.slice(4, 7)}-${digits.slice(7)}`; 44 } else if (digits.length === 10) { 45 return `+1 ${digits.slice(0, 3)}-${digits.slice(3, 6)}-${digits.slice(6)}`; 46 } 47 return cleaned; 48} 49 50function parseAddressComponents(addressStr) { 51 if (!addressStr) return { fullAddress: '', streetAddress: '', city: '', state: '', zipCode: '', country: '', locality: '' }; 52 const parts = addressStr.split(',').map(s => s.trim()); 53 const streetAddress = parts[0] || ''; 54 let city = '', state = '', zipCode = '', country = '', locality = ''; 55 56 if (parts.length >= 2) country = parts[parts.length - 1]; 57 if (parts.length >= 2) { 58 const stateZipPart = parts[parts.length - 2]; 59 const match = stateZipPart.match(/([A-Z]{2})\s+(\d{5}(?:-\d{4})?)/); 60 if (match) { state = match[1]; zipCode = match[2]; } 61 else state = stateZipPart; 62 } 63 if (parts.length >= 3) city = parts[parts.length - 3]; 64 locality = city; 65 return { fullAddress: addressStr, streetAddress, city, state, zipCode, country, locality }; 66} 67 68async function fetchEmailFromWebsiteUrl(page, websiteUrl) { 69 if (!websiteUrl) return null; 70 try { 71 const context = page.context(); 72 const newPage = await context.newPage(); 73 await newPage.goto(websiteUrl, { timeout: 15000, waitUntil: 'domcontentloaded' }); 74 const email = await newPage.evaluate(() => { 75 const mailto = document.querySelector('a[href^="mailto:"]'); 76 if (mailto) return mailto.href.replace('mailto:', '').split('?')[0]; 77 const text = document.body?.innerText ?? ''; 78 const match = text.match(/[\w\.-]+@[\w\.-]+\.\w+/); 79 return match ? match[0] : null; 80 }); 81 await newPage.close(); 82 return email; 83 } catch (_) { 84 return null; 85 } 86} 87 88// Robust consent dismissal: try multiple strategies with generous timeouts 89async function dismissConsent(page, log) { 90 const consentSelectors = [ 91 'button[jsname="higCR"]', 92 'button[aria-label*="Accept all"]', 93 'button[aria-label*="Agree"]', 94 'button[aria-label*="Accept"]', 95 'form[action*="consent"] button', 96 '#L2AGLb', // "I agree" button id seen in some regions 97 '.tHlp8d button', 98 ]; 99 for (const sel of consentSelectors) { 100 try { 101 const btn = await page.waitForSelector(sel, { timeout: 3000 }); 102 if (btn) { 103 await btn.click(); 104 log.info(`Dismissed consent via: ${sel}`); 105 await sleep(1000); 106 return; 107 } 108 } catch (_) {} 109 } 110} 111 112// Robust feed detection: try multiple selectors for the results list 113async function waitForFeed(page, log) { 114 const feedSelectors = [ 115 '[role="feed"]', 116 'div[aria-label*="Results for"]', 117 'div[aria-label*="result"]', 118 '.Nv2PK', // individual result card class (fallback) 119 ]; 120 for (const sel of feedSelectors) { 121 try { 122 await page.waitForSelector(sel, { timeout: 10000 }); 123 log.info(`Feed found via selector: ${sel}`); 124 return sel; 125 } catch (_) {} 126 } 127 log.warning('Could not detect results feed with any known selector.'); 128 return null; 129} 130 131// Collect place URLs using both feed links and card links as fallback 132async function collectPlaceUrls(page, feedSel, maxResults) { 133 return page.evaluate(({ max, sel }) => { 134 // Primary: anchor tags inside the feed 135 let links = []; 136 if (sel) { 137 links = [...document.querySelectorAll(`${sel} a[href*="/maps/place/"]`)]; 138 } 139 // Fallback: any place link on the page 140 if (links.length === 0) { 141 links = [...document.querySelectorAll('a[href*="/maps/place/"]')]; 142 } 143 return [...new Set(links.map(l => l.href))].slice(0, max); 144 }, { max: maxResults, sel: feedSel }); 145} 146 147const queue = await RequestQueue.open(); 148await queue.addRequest({ 149 url: `https://www.google.com/maps/search/${encodeURIComponent(searchQuery)}/?hl=en`, 150 label: 'SEARCH', 151}); 152 153let scraped = 0; 154 155const crawler = new PlaywrightCrawler({ 156 requestQueue: queue, 157 proxyConfiguration, 158 headless: true, 159 navigationTimeoutSecs: 60, 160 requestHandlerTimeoutSecs: 180, // extended to handle slow Maps loads 161 maxConcurrency: 1, 162 // Retry failed requests up to 2 more times before giving up 163 maxRequestRetries: 2, 164 launchContext: { 165 launchOptions: { 166 args: [ 167 '--disable-blink-features=AutomationControlled', 168 '--no-sandbox', 169 '--disable-setuid-sandbox', 170 '--disable-dev-shm-usage', 171 ], 172 }, 173 }, 174 preNavigationHooks: [ 175 async ({ page }) => { 176 await page.setExtraHTTPHeaders({ 'Accept-Language': 'en-US,en;q=0.9' }); 177 // Spoof navigator.webdriver to reduce bot detection 178 await page.addInitScript(() => { 179 Object.defineProperty(navigator, 'webdriver', { get: () => false }); 180 }); 181 }, 182 ], 183 requestHandler: async ({ page, request, log }) => { 184 if (request.label === 'SEARCH') { 185 await dismissConsent(page, log); 186 187 const feedSel = await waitForFeed(page, log); 188 await sleep(800); 189 190 // Scroll to load enough results 191 let prevCount = 0, noChange = 0; 192 while (noChange < 4) { 193 const scrollTarget = feedSel 194 ? await page.$(feedSel) 195 : null; 196 if (scrollTarget) { 197 await page.evaluate(el => el.scrollBy(0, 1200), scrollTarget); 198 } else { 199 await page.evaluate(() => window.scrollBy(0, 1200)); 200 } 201 await sleep(600); 202 203 const count = (await page.$$('a[href*="/maps/place/"]')).length; 204 if (count === prevCount) noChange++; 205 else { noChange = 0; prevCount = count; } 206 if (count >= maxResults) break; 207 } 208 209 const placeUrls = await collectPlaceUrls(page, feedSel, maxResults); 210 211 if (placeUrls.length === 0) { 212 // Capture a screenshot for debugging before throwing 213 try { 214 await page.screenshot({ path: './search-debug.png' }); 215 log.warning('Saved search-debug.png for inspection.'); 216 } catch (_) {} 217 throw new Error('No place URLs found on search results page.'); 218 } 219 220 log.info(`Queuing ${placeUrls.length} place(s)…`); 221 for (const url of placeUrls) { 222 await queue.addRequest({ url, label: 'PLACE' }); 223 } 224 225 } else if (request.label === 'PLACE') { 226 if (scraped >= maxResults) return; 227 228 // Wait for the title – retry-friendly 229 try { 230 await page.waitForSelector('h1', { timeout: 20000 }); 231 } catch (_) { 232 log.warning(`No h1 found for ${request.url} — skipping.`); 233 return; 234 } 235 await sleep(600); 236 237 // Expand opening hours if collapsed 238 try { 239 const hourBtns = await page.$$('[data-item-id="oh"] button[aria-expanded="false"]'); 240 for (const btn of hourBtns) await btn.click(); 241 await sleep(400); 242 } catch (_) {} 243 244 const pageUrl = page.url(); 245 const placeIdMatch = pageUrl.match(/!1s([a-zA-Z0-9_\-:]+)/); 246 const placeId = placeIdMatch ? placeIdMatch[1] : null; 247 const coordsMatch = pageUrl.match(/@(-?\d+\.\d+),(-?\d+\.\d+)/); 248 const latitude = coordsMatch ? parseFloat(coordsMatch[1]) : null; 249 const longitude = coordsMatch ? parseFloat(coordsMatch[2]) : null; 250 251 const data = await page.evaluate(() => { 252 const getText = sel => document.querySelector(sel)?.textContent.trim() ?? null; 253 const getAttr = (sel, attr) => document.querySelector(sel)?.getAttribute(attr) ?? null; 254 255 const title = getText('h1'); 256 if (!title) return null; 257 258 // Rating & reviews 259 let rating = null, reviewsCount = null; 260 const ratingAttr = getAttr('[aria-label*="stars"]', 'aria-label') 261 || getAttr('[aria-label*=" star"]', 'aria-label'); 262 if (ratingAttr) rating = parseFloat(ratingAttr); 263 const reviewAttr = getAttr('[aria-label*="review"]', 'aria-label'); 264 if (reviewAttr) { 265 const m = reviewAttr.match(/([\d,]+)/); 266 if (m) reviewsCount = parseInt(m[1].replace(',', '')); 267 } 268 269 let address = null, phone = null, website = null, email = null, plusCode = null, price = null; 270 for (const el of document.querySelectorAll('[data-item-id]')) { 271 const id = el.getAttribute('data-item-id') || ''; 272 if (id === 'address') address = el.textContent.trim(); 273 else if (id === 'plus_code') plusCode = el.textContent.trim(); 274 else if (id.startsWith('phone:')) phone = id.replace('phone:', ''); 275 else if (id === 'authority') { 276 const link = el.querySelector('a'); 277 if (link) website = link.href; 278 } else if (id === 'email') email = el.textContent.trim(); 279 else if (id === 'price') price = el.textContent.trim(); 280 } 281 282 // Fallbacks 283 if (!website) { 284 const wb = document.querySelector('a[aria-label*="website" i]'); 285 if (wb) website = wb.href; 286 } 287 if (website?.includes('google.com/url?')) { 288 try { website = new URL(website).searchParams.get('q') || website; } catch (_) {} 289 } 290 if (!email) { 291 const mailLink = document.querySelector('a[href^="mailto:"]'); 292 if (mailLink) email = mailLink.href.replace('mailto:', '').split('?')[0]; 293 } 294 295 // Categories 296 let categories = null; 297 for (const sel of ['button.DkEaL', '[jsaction*="category"]', '.CQYjG', 'button[aria-label*="category"]']) { 298 const el = document.querySelector(sel); 299 if (el) { categories = el.textContent.trim(); break; } 300 } 301 302 // Locality 303 let locality = null; 304 for (const sel of ['[data-item-id="locality"]', '[aria-label*="Neighborhood"]', '.RcCsl', '[jsaction*="locality"]']) { 305 const el = document.querySelector(sel); 306 if (el) { locality = el.textContent.trim(); break; } 307 } 308 309 // Opening hours 310 let openingHours = null; 311 const hourRows = document.querySelectorAll('table.eK4R0e tr, [data-item-id="oh"] table tr'); 312 if (hourRows.length) { 313 const rows = [...hourRows] 314 .map(row => [...row.querySelectorAll('td, th')].map(c => c.textContent.trim()).join(': ')) 315 .filter(r => r); 316 if (rows.length) openingHours = rows.join(' | '); 317 } 318 if (!openingHours) { 319 const ohEl = document.querySelector('[data-item-id="oh"]'); 320 if (ohEl) openingHours = ohEl.innerText?.replace(/\n+/g, ' | ').trim(); 321 } 322 323 let facebookLink = null; 324 const fbLink = document.querySelector('a[href*="facebook.com"]'); 325 if (fbLink) facebookLink = fbLink.href; 326 327 const rawImages = [...document.querySelectorAll( 328 'img[src*="googleusercontent"], img[src*="lh3.google"], img[src*="lh5.google"]' 329 )] 330 .map(img => img.src) 331 .filter(src => src && !src.includes('data:') && src.length > 60); 332 333 return { title, address, phone, website, email, plusCode, price, categories, locality, openingHours, facebookLink, rawImages, rating, reviewsCount }; 334 }); 335 336 if (!data?.title) { 337 log.warning(`Failed to extract data for ${request.url}`); 338 return; 339 } 340 341 data.latitude = latitude; 342 data.longitude = longitude; 343 344 if (!data.email && fetchEmailFromWebsite && data.website) { 345 data.email = await fetchEmailFromWebsiteUrl(page, data.website); 346 } 347 348 // Deduplicate images 349 const uniqueNormalized = new Map(); 350 for (const img of data.rawImages ?? []) { 351 const normalized = normalizeImageUrl(img); 352 if (normalized && !uniqueNormalized.has(normalized)) uniqueNormalized.set(normalized, img); 353 } 354 355 let addressComponents = parseAddressComponents(data.address || ''); 356 if (data.locality) addressComponents.locality = data.locality; 357 if (!addressComponents.city && addressComponents.fullAddress) { 358 const parts = addressComponents.fullAddress.split(','); 359 if (parts.length >= 2) addressComponents.city = parts[parts.length - 3]?.trim() || ''; 360 } 361 if (!addressComponents.country) addressComponents.country = 'United States'; 362 363 const finalRecord = { 364 searchUrl: `https://www.google.com/maps/search/${encodeURIComponent(searchQuery)}/?hl=en`, 365 searchKeyword: searchQuery, 366 placeId, 367 uniqueId: placeId, 368 url: pageUrl, 369 title: data.title, 370 fullAddress: addressComponents.fullAddress, 371 streetAddress: addressComponents.streetAddress, 372 city: addressComponents.city, 373 state: addressComponents.state, 374 zipCode: addressComponents.zipCode, 375 country: addressComponents.country, 376 locality: addressComponents.locality || addressComponents.city, 377 latitude: data.latitude, 378 longitude: data.longitude, 379 phone: formatPhone(data.phone), 380 email: data.email, 381 website: data.website, 382 plusCode: data.plusCode, 383 categories: data.categories, 384 rating: data.rating, 385 reviewsCount: data.reviewsCount, 386 openingHours: data.openingHours, 387 price: data.price, 388 image: Array.from(uniqueNormalized.values()).join(', '), 389 facebookLink: data.facebookLink, 390 additionalAttributes: {}, 391 about: null, 392 prices: data.price ? [data.price] : [], 393 scrapedAt: new Date().toISOString(), 394 }; 395 396 const requiredFields = ['title', 'fullAddress', 'streetAddress', 'city', 'state', 'zipCode', 397 'country', 'locality', 'latitude', 'longitude', 'phone', 'placeId', 'plusCode', 398 'rating', 'reviewsCount', 'scrapedAt', 'searchKeyword', 'searchUrl', 'url', 'website']; 399 for (const field of requiredFields) { 400 if (finalRecord[field] == null) { 401 log.warning(`Missing field "${field}" for ${finalRecord.title}`); 402 } 403 } 404 405 scraped++; 406 await Dataset.pushData(finalRecord); 407 log.info(`[${scraped}/${maxResults}] ${finalRecord.title} | rating: ${finalRecord.rating} | hours: ${finalRecord.openingHours ? 'yes' : 'no'} | email: ${finalRecord.email || 'none'}`); 408 } 409 }, 410 411 // Log but don't re-throw failed requests so the actor still exits cleanly 412 failedRequestHandler: async ({ request }, error) => { 413 console.error(`Request ${request.url} failed after retries: ${error.message}`); 414 }, 415}); 416 417await crawler.run(); 418 419// Exit cleanly even with 0 results — Apify marks throws as failures 420if (scraped === 0) { 421 console.warn('Scraper finished with 0 results. Check the failed run logs and debug screenshot.'); 422} else { 423 console.log(`Done! Scraped ${scraped} place(s).`); 424} 425 426await Actor.exit();

{ "name": "google-maps-scraper", "version": "1.0.0", "type": "module", "main": "main.js", "scripts": { "start": "node main.js" }, "dependencies": { "apify": "^3.0.0", "crawlee": "^3.0.0", "playwright": "^1.44.0" } }