Google Maps Reviews Scraper
Try for free
Pay $0.50 for 1,000 reviews
Go to Store
Google Maps Reviews Scraper
compass/google-maps-reviews-scraper
Try for free
Pay $0.50 for 1,000 reviews
Extract all reviews of Google Maps places using place URLs. Get review text, published date, response from owner, review URL, and reviewer's details. Download scraped data, run the scraper via API, schedule and monitor runs or integrate with other tools.
You can access the Google Maps Reviews Scraper programmatically from your own applications by using the Apify API. You can 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": "jNt5iChTGcQEw3FOX"
6 },
7 "servers": [
8 {
9 "url": "https://api.apify.com/v2"
10 }
11 ],
12 "paths": {
13 "/acts/compass~google-maps-reviews-scraper/run-sync-get-dataset-items": {
14 "post": {
15 "operationId": "run-sync-get-dataset-items-compass-google-maps-reviews-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/compass~google-maps-reviews-scraper/runs": {
50 "post": {
51 "operationId": "runs-sync-compass-google-maps-reviews-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/compass~google-maps-reviews-scraper/run-sync": {
93 "post": {
94 "operationId": "run-sync-compass-google-maps-reviews-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 "properties": {
134 "startUrls": {
135 "title": "Start URLs",
136 "type": "array",
137 "description": "List of URLs to be crawled. They can be search URLs, place URLs or review detail URLs. Valid start URLs must contain one of the following subpaths: <code>/maps/search</code>, <code>/maps/place</code> or <code>/maps/reviews</code>.",
138 "items": {
139 "type": "object",
140 "required": [
141 "url"
142 ],
143 "properties": {
144 "url": {
145 "type": "string",
146 "title": "URL of a web page",
147 "format": "uri"
148 }
149 }
150 }
151 },
152 "placeIds": {
153 "title": "🗃 Place IDs",
154 "type": "array",
155 "description": "List of place IDs. You can add place IDs one by one or upload a list using the <strong>Bulk edit</strong> option.",
156 "items": {
157 "type": "string"
158 }
159 },
160 "maxReviews": {
161 "title": "Number of reviews",
162 "type": "integer",
163 "description": "Max number of reviews per place to scrape. If you fill in 0 or nothing, no reviews will be scraped. For all reviews, just put 99999.",
164 "default": 10000000
165 },
166 "reviewsSort": {
167 "title": "Sort reviews by",
168 "enum": [
169 "newest",
170 "mostRelevant",
171 "highestRanking",
172 "lowestRanking"
173 ],
174 "type": "string",
175 "description": "Define how reviews should be sorted.",
176 "default": "newest"
177 },
178 "reviewsStartDate": {
179 "title": "Only scrape reviews newer than [date]",
180 "type": "string",
181 "description": "Visual format only allows YYYY-MM-DD, e.g., <code>2022-02-20</code>. But if you switch to JSON, you can use date with time in ISO format (e.g. <code>2024-05-03T10:00:00</code>) or relative date with number and time unit (e.g. <code>8 days</code> or <code>3 months</code>)."
182 },
183 "language": {
184 "title": "Language",
185 "enum": [
186 "en",
187 "af",
188 "az",
189 "id",
190 "ms",
191 "bs",
192 "ca",
193 "cs",
194 "da",
195 "de",
196 "et",
197 "es",
198 "es-419",
199 "eu",
200 "fil",
201 "fr",
202 "gl",
203 "hr",
204 "zu",
205 "is",
206 "it",
207 "sw",
208 "lv",
209 "lt",
210 "hu",
211 "nl",
212 "no",
213 "uz",
214 "pl",
215 "pt-BR",
216 "pt-PT",
217 "ro",
218 "sq",
219 "sk",
220 "sl",
221 "fi",
222 "sv",
223 "vi",
224 "tr",
225 "el",
226 "bg",
227 "ky",
228 "kk",
229 "mk",
230 "mn",
231 "ru",
232 "sr",
233 "uk",
234 "ka",
235 "hy",
236 "iw",
237 "ur",
238 "ar",
239 "fa",
240 "am",
241 "ne",
242 "hi",
243 "mr",
244 "bn",
245 "pa",
246 "gu",
247 "ta",
248 "te",
249 "kn",
250 "ml",
251 "si",
252 "th",
253 "lo",
254 "my",
255 "km",
256 "ko",
257 "ja",
258 "zh-CN",
259 "zh-TW"
260 ],
261 "type": "string",
262 "description": "Results details will show in this language.",
263 "default": "en"
264 },
265 "reviewsOrigin": {
266 "title": "Reviews origin",
267 "enum": [
268 "all",
269 "google"
270 ],
271 "type": "string",
272 "description": "Select whether you want all reviews (from Google, Tripadvisor, etc.) or only reviews from Google",
273 "default": "all"
274 },
275 "personalData": {
276 "title": "Personal data",
277 "type": "boolean",
278 "description": "This settings allows you to obtain personal data about reviewer (his ID, name, URL and his photo URL) and about review (ID and URL). Personal data is protected by the GDPR in the European Union and by other regulations around the world. You should not scrape personal data unless you have a legitimate reason to do so. If you're unsure whether your reason is legitimate, consult your lawyers.",
279 "default": true
280 }
281 }
282 },
283 "runsResponseSchema": {
284 "type": "object",
285 "properties": {
286 "data": {
287 "type": "object",
288 "properties": {
289 "id": {
290 "type": "string"
291 },
292 "actId": {
293 "type": "string"
294 },
295 "userId": {
296 "type": "string"
297 },
298 "startedAt": {
299 "type": "string",
300 "format": "date-time",
301 "example": "2025-01-08T00:00:00.000Z"
302 },
303 "finishedAt": {
304 "type": "string",
305 "format": "date-time",
306 "example": "2025-01-08T00:00:00.000Z"
307 },
308 "status": {
309 "type": "string",
310 "example": "READY"
311 },
312 "meta": {
313 "type": "object",
314 "properties": {
315 "origin": {
316 "type": "string",
317 "example": "API"
318 },
319 "userAgent": {
320 "type": "string"
321 }
322 }
323 },
324 "stats": {
325 "type": "object",
326 "properties": {
327 "inputBodyLen": {
328 "type": "integer",
329 "example": 2000
330 },
331 "rebootCount": {
332 "type": "integer",
333 "example": 0
334 },
335 "restartCount": {
336 "type": "integer",
337 "example": 0
338 },
339 "resurrectCount": {
340 "type": "integer",
341 "example": 0
342 },
343 "computeUnits": {
344 "type": "integer",
345 "example": 0
346 }
347 }
348 },
349 "options": {
350 "type": "object",
351 "properties": {
352 "build": {
353 "type": "string",
354 "example": "latest"
355 },
356 "timeoutSecs": {
357 "type": "integer",
358 "example": 300
359 },
360 "memoryMbytes": {
361 "type": "integer",
362 "example": 1024
363 },
364 "diskMbytes": {
365 "type": "integer",
366 "example": 2048
367 }
368 }
369 },
370 "buildId": {
371 "type": "string"
372 },
373 "defaultKeyValueStoreId": {
374 "type": "string"
375 },
376 "defaultDatasetId": {
377 "type": "string"
378 },
379 "defaultRequestQueueId": {
380 "type": "string"
381 },
382 "buildNumber": {
383 "type": "string",
384 "example": "1.0.0"
385 },
386 "containerUrl": {
387 "type": "string"
388 },
389 "usage": {
390 "type": "object",
391 "properties": {
392 "ACTOR_COMPUTE_UNITS": {
393 "type": "integer",
394 "example": 0
395 },
396 "DATASET_READS": {
397 "type": "integer",
398 "example": 0
399 },
400 "DATASET_WRITES": {
401 "type": "integer",
402 "example": 0
403 },
404 "KEY_VALUE_STORE_READS": {
405 "type": "integer",
406 "example": 0
407 },
408 "KEY_VALUE_STORE_WRITES": {
409 "type": "integer",
410 "example": 1
411 },
412 "KEY_VALUE_STORE_LISTS": {
413 "type": "integer",
414 "example": 0
415 },
416 "REQUEST_QUEUE_READS": {
417 "type": "integer",
418 "example": 0
419 },
420 "REQUEST_QUEUE_WRITES": {
421 "type": "integer",
422 "example": 0
423 },
424 "DATA_TRANSFER_INTERNAL_GBYTES": {
425 "type": "integer",
426 "example": 0
427 },
428 "DATA_TRANSFER_EXTERNAL_GBYTES": {
429 "type": "integer",
430 "example": 0
431 },
432 "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
433 "type": "integer",
434 "example": 0
435 },
436 "PROXY_SERPS": {
437 "type": "integer",
438 "example": 0
439 }
440 }
441 },
442 "usageTotalUsd": {
443 "type": "number",
444 "example": 0.00005
445 },
446 "usageUsd": {
447 "type": "object",
448 "properties": {
449 "ACTOR_COMPUTE_UNITS": {
450 "type": "integer",
451 "example": 0
452 },
453 "DATASET_READS": {
454 "type": "integer",
455 "example": 0
456 },
457 "DATASET_WRITES": {
458 "type": "integer",
459 "example": 0
460 },
461 "KEY_VALUE_STORE_READS": {
462 "type": "integer",
463 "example": 0
464 },
465 "KEY_VALUE_STORE_WRITES": {
466 "type": "number",
467 "example": 0.00005
468 },
469 "KEY_VALUE_STORE_LISTS": {
470 "type": "integer",
471 "example": 0
472 },
473 "REQUEST_QUEUE_READS": {
474 "type": "integer",
475 "example": 0
476 },
477 "REQUEST_QUEUE_WRITES": {
478 "type": "integer",
479 "example": 0
480 },
481 "DATA_TRANSFER_INTERNAL_GBYTES": {
482 "type": "integer",
483 "example": 0
484 },
485 "DATA_TRANSFER_EXTERNAL_GBYTES": {
486 "type": "integer",
487 "example": 0
488 },
489 "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
490 "type": "integer",
491 "example": 0
492 },
493 "PROXY_SERPS": {
494 "type": "integer",
495 "example": 0
496 }
497 }
498 }
499 }
500 }
501 }
502 }
503 }
504 }
505}Google Maps Reviews 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 Reviews 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:
Developer
Compass Maintained by Apify
Actor Metrics
1.4k monthly users
-
180 bookmarks
98% runs succeeded
2.6 days response time
Created in Feb 2022
Modified a day ago
Categories
