Google Maps Scraper
Try for free
1 day trial then $25.00/month - No credit card required now
Go to Store
Google Maps Scraper
onidivo/google-maps-scraper
Try for free
1 day trial then $25.00/month - No credit card required now
Obtain more significant and quicker amounts of data from Google Maps compared to what is available through the official Google Places API.
Developer
Onidivo TechnologiesMaintained by Community
Actor Metrics
5 Monthly users
No reviews yet
2 bookmarks
86% runs succeeded
Created in Feb 2024
Modified 10 months ago
Categories
You can access the Google Maps Scraper programmatically from your own applications by using the Apify API. You can also choose the language preference from below. To use the Apify API, you’ll need an Apify account and your API token, found in Integrations settings in Apify Console.
1{
2 "openapi": "3.0.1",
3 "info": {
4 "version": "0.0",
5 "x-build-id": "q6Uklg2OQf0CJjmai"
6 },
7 "servers": [
8 {
9 "url": "https://api.apify.com/v2"
10 }
11 ],
12 "paths": {
13 "/acts/onidivo~google-maps-scraper/run-sync-get-dataset-items": {
14 "post": {
15 "operationId": "run-sync-get-dataset-items-onidivo-google-maps-scraper",
16 "x-openai-isConsequential": false,
17 "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
18 "tags": [
19 "Run Actor"
20 ],
21 "requestBody": {
22 "required": true,
23 "content": {
24 "application/json": {
25 "schema": {
26 "$ref": "#/components/schemas/inputSchema"
27 }
28 }
29 }
30 },
31 "parameters": [
32 {
33 "name": "token",
34 "in": "query",
35 "required": true,
36 "schema": {
37 "type": "string"
38 },
39 "description": "Enter your Apify token here"
40 }
41 ],
42 "responses": {
43 "200": {
44 "description": "OK"
45 }
46 }
47 }
48 },
49 "/acts/onidivo~google-maps-scraper/runs": {
50 "post": {
51 "operationId": "runs-sync-onidivo-google-maps-scraper",
52 "x-openai-isConsequential": false,
53 "summary": "Executes an Actor and returns information about the initiated run in response.",
54 "tags": [
55 "Run Actor"
56 ],
57 "requestBody": {
58 "required": true,
59 "content": {
60 "application/json": {
61 "schema": {
62 "$ref": "#/components/schemas/inputSchema"
63 }
64 }
65 }
66 },
67 "parameters": [
68 {
69 "name": "token",
70 "in": "query",
71 "required": true,
72 "schema": {
73 "type": "string"
74 },
75 "description": "Enter your Apify token here"
76 }
77 ],
78 "responses": {
79 "200": {
80 "description": "OK",
81 "content": {
82 "application/json": {
83 "schema": {
84 "$ref": "#/components/schemas/runsResponseSchema"
85 }
86 }
87 }
88 }
89 }
90 }
91 },
92 "/acts/onidivo~google-maps-scraper/run-sync": {
93 "post": {
94 "operationId": "run-sync-onidivo-google-maps-scraper",
95 "x-openai-isConsequential": false,
96 "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
97 "tags": [
98 "Run Actor"
99 ],
100 "requestBody": {
101 "required": true,
102 "content": {
103 "application/json": {
104 "schema": {
105 "$ref": "#/components/schemas/inputSchema"
106 }
107 }
108 }
109 },
110 "parameters": [
111 {
112 "name": "token",
113 "in": "query",
114 "required": true,
115 "schema": {
116 "type": "string"
117 },
118 "description": "Enter your Apify token here"
119 }
120 ],
121 "responses": {
122 "200": {
123 "description": "OK"
124 }
125 }
126 }
127 }
128 },
129 "components": {
130 "schemas": {
131 "inputSchema": {
132 "type": "object",
133 "required": [
134 "proxyConfig"
135 ],
136 "properties": {
137 "searchStringsArray": {
138 "title": "Search term(s)",
139 "type": "array",
140 "description": "The search terms you want to use.",
141 "items": {
142 "type": "string"
143 }
144 },
145 "countryCode": {
146 "title": "Country",
147 "enum": [
148 "",
149 "us",
150 "af",
151 "al",
152 "dz",
153 "as",
154 "ad",
155 "ao",
156 "ai",
157 "aq",
158 "ag",
159 "ar",
160 "am",
161 "aw",
162 "au",
163 "at",
164 "az",
165 "bs",
166 "bh",
167 "bd",
168 "bb",
169 "by",
170 "be",
171 "bz",
172 "bj",
173 "bm",
174 "bt",
175 "bo",
176 "ba",
177 "bw",
178 "bv",
179 "br",
180 "io",
181 "bn",
182 "bg",
183 "bf",
184 "bi",
185 "kh",
186 "cm",
187 "ca",
188 "cv",
189 "ky",
190 "cf",
191 "td",
192 "cl",
193 "cn",
194 "cx",
195 "cc",
196 "co",
197 "km",
198 "cg",
199 "cd",
200 "ck",
201 "cr",
202 "ci",
203 "hr",
204 "cu",
205 "cy",
206 "cz",
207 "dk",
208 "dj",
209 "dm",
210 "do",
211 "ec",
212 "eg",
213 "sv",
214 "gq",
215 "er",
216 "ee",
217 "et",
218 "fk",
219 "fo",
220 "fj",
221 "fi",
222 "fr",
223 "gf",
224 "pf",
225 "tf",
226 "ga",
227 "gm",
228 "ge",
229 "de",
230 "gh",
231 "gi",
232 "gr",
233 "gl",
234 "gd",
235 "gp",
236 "gu",
237 "gt",
238 "gn",
239 "gw",
240 "gy",
241 "ht",
242 "hm",
243 "va",
244 "hn",
245 "hk",
246 "hu",
247 "is",
248 "in",
249 "id",
250 "ir",
251 "iq",
252 "ie",
253 "il",
254 "it",
255 "jm",
256 "jp",
257 "jo",
258 "kz",
259 "ke",
260 "ki",
261 "kp",
262 "kr",
263 "kw",
264 "kg",
265 "la",
266 "lv",
267 "lb",
268 "ls",
269 "lr",
270 "ly",
271 "li",
272 "lt",
273 "lu",
274 "mo",
275 "mk",
276 "mg",
277 "mw",
278 "my",
279 "mv",
280 "ml",
281 "mt",
282 "mh",
283 "mq",
284 "mr",
285 "mu",
286 "yt",
287 "mx",
288 "fm",
289 "md",
290 "mc",
291 "mn",
292 "me",
293 "ms",
294 "ma",
295 "mz",
296 "mm",
297 "na",
298 "nr",
299 "np",
300 "nl",
301 "an",
302 "nc",
303 "nz",
304 "ni",
305 "ne",
306 "ng",
307 "nu",
308 "nf",
309 "mp",
310 "no",
311 "om",
312 "pk",
313 "pw",
314 "ps",
315 "pa",
316 "pg",
317 "py",
318 "pe",
319 "ph",
320 "pn",
321 "pl",
322 "pt",
323 "pr",
324 "qa",
325 "re",
326 "ro",
327 "ru",
328 "rw",
329 "sh",
330 "kn",
331 "lc",
332 "pm",
333 "vc",
334 "ws",
335 "sm",
336 "st",
337 "sa",
338 "sn",
339 "rs",
340 "sc",
341 "sl",
342 "sg",
343 "sk",
344 "si",
345 "sb",
346 "so",
347 "za",
348 "gs",
349 "ss",
350 "es",
351 "lk",
352 "sd",
353 "sr",
354 "sj",
355 "sz",
356 "se",
357 "ch",
358 "sy",
359 "tw",
360 "tj",
361 "tz",
362 "th",
363 "tl",
364 "tg",
365 "tk",
366 "to",
367 "tt",
368 "tn",
369 "tr",
370 "tm",
371 "tc",
372 "tv",
373 "ug",
374 "ua",
375 "ae",
376 "gb",
377 "um",
378 "uy",
379 "uz",
380 "vu",
381 "ve",
382 "vn",
383 "vg",
384 "vi",
385 "wf",
386 "eh",
387 "ye",
388 "zm",
389 "zw"
390 ],
391 "type": "string",
392 "description": "The country where you want to search in."
393 },
394 "city": {
395 "title": "City",
396 "type": "string",
397 "description": "The city where you want to search in."
398 },
399 "startUrls": {
400 "title": "Google Maps URLs",
401 "type": "array",
402 "description": "A list of Google Maps URLs. The URLs should contains either <code>/maps/search</code> or <code>/maps/place</code> (e.g., <code>https://www.google.com/maps/search/dentist+california/</code>)",
403 "items": {
404 "type": "object",
405 "required": [
406 "url"
407 ],
408 "properties": {
409 "url": {
410 "type": "string",
411 "title": "URL of a web page",
412 "format": "uri"
413 }
414 }
415 }
416 },
417 "language": {
418 "title": "Language",
419 "enum": [
420 "en",
421 "af",
422 "az",
423 "id",
424 "ms",
425 "bs",
426 "ca",
427 "cs",
428 "da",
429 "de",
430 "et",
431 "es",
432 "es-419",
433 "eu",
434 "fil",
435 "fr",
436 "gl",
437 "hr",
438 "zu",
439 "is",
440 "it",
441 "sw",
442 "lv",
443 "lt",
444 "hu",
445 "nl",
446 "no",
447 "uz",
448 "pl",
449 "pt-BR",
450 "pt-PT",
451 "ro",
452 "sq",
453 "sk",
454 "sl",
455 "fi",
456 "sv",
457 "vi",
458 "tr",
459 "el",
460 "bg",
461 "ky",
462 "kk",
463 "mk",
464 "mn",
465 "ru",
466 "sr",
467 "uk",
468 "ka",
469 "hy",
470 "iw",
471 "ur",
472 "ar",
473 "fa",
474 "am",
475 "ne",
476 "hi",
477 "mr",
478 "bn",
479 "pa",
480 "gu",
481 "ta",
482 "te",
483 "kn",
484 "ml",
485 "si",
486 "th",
487 "lo",
488 "my",
489 "km",
490 "ko",
491 "ja",
492 "zh-CN",
493 "zh-TW"
494 ],
495 "type": "string",
496 "description": "The details of the results will be in this language..",
497 "default": "en"
498 },
499 "maxCrawledPlacesPerSearch": {
500 "title": "Maximum number of places per each search term/URL",
501 "minimum": 1,
502 "type": "integer",
503 "description": "This is the maximum number of results you will obtain for each search term or URL. <br> To scrape all places available, set this value to <code>9999999</code>."
504 },
505 "maxImages": {
506 "title": "Maximum number of images per place",
507 "type": "integer",
508 "description": "Maximum number of images per place. If you fill in 0 or nothing, no images will be scraped. To extract all images, type <code>99999</code> into the field. The higher the number, the slower the search."
509 },
510 "searchMatching": {
511 "title": "Match search with place title",
512 "enum": [
513 "all",
514 "only_includes",
515 "only_exact"
516 ],
517 "type": "string",
518 "description": "Match search with place title"
519 },
520 "exportPlaceUrls": {
521 "title": "Scrape only the place URLs (no place details)",
522 "type": "boolean",
523 "description": "This is helpful in case you want post process the URLs later.",
524 "default": false
525 },
526 "proxyConfig": {
527 "title": "Proxy configuration",
528 "type": "object",
529 "description": "Using proxies is needed to prevent blocking.",
530 "default": {
531 "useApifyProxy": true
532 }
533 },
534 "maxReviews": {
535 "title": "Limit number of reviews",
536 "type": "integer",
537 "description": "The maximum number of reviews per place."
538 },
539 "oneReviewPerRow": {
540 "title": "One review per output result",
541 "type": "boolean",
542 "description": "Save each review as a separated result.",
543 "default": false
544 },
545 "reviewsStartDate": {
546 "title": "Reviews since this date",
547 "type": "string",
548 "description": "Scrape reviews since this date (e.g., 2024-02-21)"
549 },
550 "reviewsSort": {
551 "title": "Reviews sort",
552 "enum": [
553 "newest",
554 "mostRelevant",
555 "highestRanking",
556 "lowestRanking"
557 ],
558 "type": "string",
559 "description": "Set the sort order of reviews.",
560 "default": "newest"
561 },
562 "reviewsTranslation": {
563 "title": "Reviews translation",
564 "enum": [
565 "originalAndTranslated",
566 "onlyOriginal",
567 "onlyTranslated"
568 ],
569 "type": "string",
570 "description": "Choose the output of reviews.",
571 "default": "originalAndTranslated"
572 },
573 "reviewsFilterString": {
574 "title": "Filter reviews by keyword(s)",
575 "type": "string",
576 "description": "List of keyword(s) to filter and scrape reviews containing them.",
577 "default": ""
578 },
579 "scrapeReviewerName": {
580 "title": "Reviewer's name",
581 "type": "boolean",
582 "description": "Extract the reviewer's name.",
583 "default": false
584 },
585 "scrapeReviewerId": {
586 "title": "Reviewer's ID",
587 "type": "boolean",
588 "description": "",
589 "default": true
590 },
591 "scrapeReviewerUrl": {
592 "title": "Reviewer URL",
593 "type": "boolean",
594 "description": "",
595 "default": true
596 },
597 "scrapeReviewId": {
598 "title": "Review ID",
599 "type": "boolean",
600 "description": "",
601 "default": true
602 },
603 "scrapeReviewUrl": {
604 "title": "Review URL",
605 "type": "boolean",
606 "description": "",
607 "default": true
608 },
609 "scrapeResponseFromOwnerText": {
610 "title": "Response from owner",
611 "type": "boolean",
612 "description": "",
613 "default": true
614 },
615 "state": {
616 "title": "State",
617 "type": "string",
618 "description": "The state of the area (e.g., <code>Arizona</code>)."
619 },
620 "county": {
621 "title": "US county",
622 "type": "string",
623 "description": "The US county of the area (e.g., <code>Colorado</code>)."
624 },
625 "postalCode": {
626 "title": "Postal code",
627 "type": "string",
628 "description": "The postal code of the area (e.g., <code>10001</code>)."
629 },
630 "zoom": {
631 "title": "Override zoom level",
632 "minimum": 1,
633 "maximum": 21,
634 "type": "integer",
635 "description": "This zoom is automatically set based on the chosen location, but you can override that. See <a href='https://apify.com/onidivo/google-maps-scraper#automatic-zooming' target='_blank' rel='noopener'>readme</a> for more info."
636 },
637 "customGeolocation": {
638 "title": "Custom search area (check description for more info)",
639 "type": "object",
640 "description": "A custom geo location polygon, see <a href='https://geojson.io' target='_blank' rel='noopener'>geojson.io</a> for more info."
641 }
642 }
643 },
644 "runsResponseSchema": {
645 "type": "object",
646 "properties": {
647 "data": {
648 "type": "object",
649 "properties": {
650 "id": {
651 "type": "string"
652 },
653 "actId": {
654 "type": "string"
655 },
656 "userId": {
657 "type": "string"
658 },
659 "startedAt": {
660 "type": "string",
661 "format": "date-time",
662 "example": "2025-01-08T00:00:00.000Z"
663 },
664 "finishedAt": {
665 "type": "string",
666 "format": "date-time",
667 "example": "2025-01-08T00:00:00.000Z"
668 },
669 "status": {
670 "type": "string",
671 "example": "READY"
672 },
673 "meta": {
674 "type": "object",
675 "properties": {
676 "origin": {
677 "type": "string",
678 "example": "API"
679 },
680 "userAgent": {
681 "type": "string"
682 }
683 }
684 },
685 "stats": {
686 "type": "object",
687 "properties": {
688 "inputBodyLen": {
689 "type": "integer",
690 "example": 2000
691 },
692 "rebootCount": {
693 "type": "integer",
694 "example": 0
695 },
696 "restartCount": {
697 "type": "integer",
698 "example": 0
699 },
700 "resurrectCount": {
701 "type": "integer",
702 "example": 0
703 },
704 "computeUnits": {
705 "type": "integer",
706 "example": 0
707 }
708 }
709 },
710 "options": {
711 "type": "object",
712 "properties": {
713 "build": {
714 "type": "string",
715 "example": "latest"
716 },
717 "timeoutSecs": {
718 "type": "integer",
719 "example": 300
720 },
721 "memoryMbytes": {
722 "type": "integer",
723 "example": 1024
724 },
725 "diskMbytes": {
726 "type": "integer",
727 "example": 2048
728 }
729 }
730 },
731 "buildId": {
732 "type": "string"
733 },
734 "defaultKeyValueStoreId": {
735 "type": "string"
736 },
737 "defaultDatasetId": {
738 "type": "string"
739 },
740 "defaultRequestQueueId": {
741 "type": "string"
742 },
743 "buildNumber": {
744 "type": "string",
745 "example": "1.0.0"
746 },
747 "containerUrl": {
748 "type": "string"
749 },
750 "usage": {
751 "type": "object",
752 "properties": {
753 "ACTOR_COMPUTE_UNITS": {
754 "type": "integer",
755 "example": 0
756 },
757 "DATASET_READS": {
758 "type": "integer",
759 "example": 0
760 },
761 "DATASET_WRITES": {
762 "type": "integer",
763 "example": 0
764 },
765 "KEY_VALUE_STORE_READS": {
766 "type": "integer",
767 "example": 0
768 },
769 "KEY_VALUE_STORE_WRITES": {
770 "type": "integer",
771 "example": 1
772 },
773 "KEY_VALUE_STORE_LISTS": {
774 "type": "integer",
775 "example": 0
776 },
777 "REQUEST_QUEUE_READS": {
778 "type": "integer",
779 "example": 0
780 },
781 "REQUEST_QUEUE_WRITES": {
782 "type": "integer",
783 "example": 0
784 },
785 "DATA_TRANSFER_INTERNAL_GBYTES": {
786 "type": "integer",
787 "example": 0
788 },
789 "DATA_TRANSFER_EXTERNAL_GBYTES": {
790 "type": "integer",
791 "example": 0
792 },
793 "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
794 "type": "integer",
795 "example": 0
796 },
797 "PROXY_SERPS": {
798 "type": "integer",
799 "example": 0
800 }
801 }
802 },
803 "usageTotalUsd": {
804 "type": "number",
805 "example": 0.00005
806 },
807 "usageUsd": {
808 "type": "object",
809 "properties": {
810 "ACTOR_COMPUTE_UNITS": {
811 "type": "integer",
812 "example": 0
813 },
814 "DATASET_READS": {
815 "type": "integer",
816 "example": 0
817 },
818 "DATASET_WRITES": {
819 "type": "integer",
820 "example": 0
821 },
822 "KEY_VALUE_STORE_READS": {
823 "type": "integer",
824 "example": 0
825 },
826 "KEY_VALUE_STORE_WRITES": {
827 "type": "number",
828 "example": 0.00005
829 },
830 "KEY_VALUE_STORE_LISTS": {
831 "type": "integer",
832 "example": 0
833 },
834 "REQUEST_QUEUE_READS": {
835 "type": "integer",
836 "example": 0
837 },
838 "REQUEST_QUEUE_WRITES": {
839 "type": "integer",
840 "example": 0
841 },
842 "DATA_TRANSFER_INTERNAL_GBYTES": {
843 "type": "integer",
844 "example": 0
845 },
846 "DATA_TRANSFER_EXTERNAL_GBYTES": {
847 "type": "integer",
848 "example": 0
849 },
850 "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
851 "type": "integer",
852 "example": 0
853 },
854 "PROXY_SERPS": {
855 "type": "integer",
856 "example": 0
857 }
858 }
859 }
860 }
861 }
862 }
863 }
864 }
865 }
866}Google Maps Scraper OpenAPI definition
OpenAPI is a standard for designing and describing RESTful APIs, allowing developers to define API structure, endpoints, and data formats in a machine-readable way. It simplifies API development, integration, and documentation.
OpenAPI is effective when used with AI agents and GPTs by standardizing how these systems interact with various APIs, for reliable integrations and efficient communication.
By defining machine-readable API specifications, OpenAPI allows AI models like GPTs to understand and use varied data sources, improving accuracy. This accelerates development, reduces errors, and provides context-aware responses, making OpenAPI a core component for AI applications.
You can download the OpenAPI definitions for Google Maps Scraper from the options below:
If you’d like to learn more about how OpenAPI powers GPTs, read our blog post.
You can also check out our other API clients:
