# Google Places Reviews Plus (`canadesk/google-places-reviews-plus`)

No limits + Full details. Get all reviews for places such as monuments, restaurants or hotels from Google Maps! Also includes likes, images, replies and filters. It's (very) fast and costs little!

- **URL**: https://beta-securitybyobscurity.apify.com/canadesk/google-places-reviews-plus.md
- **Developed by:** [Canadesk Support](https://beta-securitybyobscurity.apify.com/canadesk) (community)
- **Categories:** SEO tools, Social media, Travel
- **Stats:** 6 total users, 1 monthly users, 100.0% runs succeeded, 3 bookmarks
- **User rating**: No ratings yet

## Pricing

$12.00/month + usage

To use this Actor, you pay a monthly rental fee to the developer. The rent is subtracted from your prepaid usage every month after the free trial period.
You also pay for the Apify platform usage, which gets cheaper the higher Apify subscription plan you have.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#rental-actors

# README

⭐ The actor works with all Places. This includes monuments, hotels, restaurants, etc.

## Input

- Places (array)

  List of places to fetch reviews for. The following types are accepted:

  - Search Terms: chateau de versailles france

  - Share link (⚡ Recommended!): https://maps.app.goo.gl/WQLepEgAgPCCtqot7

  - Full Place link: https://www.google.com/maps/place/Disneyland+Park/@33.8120962,-117.9215491,17z/data=!4m8!3m7!1s0x80dcd7d12b3b5e6b:0x2ef62f8418225cfa!8m2!3d33.8120918!4d-117.9189742!9m1!1b1!16zL20vMDJmenM

  When using search terms, make sure to be specific enough and include the country. Otherwise, you may get reviews for a different place.

- Data type (select)

  - Reviews: Returns reviews for the place.

  - Details: Returns details about the place, similar to the Information panel available on Google Maps.

- Search filter (string)

  Similar to the "Search reviews" option in the Reviews tab on Google Maps.

  Note that Google Maps does not support exact search.

- Language (string)

  Returns only reviews written in a specific language. Must be ISO 639-1, such as "en" or "es".

  Set to "all" to collect all languages. The filter is applied after collection!

- Date filter (array)

  The array must always have two entries, and at least one must not be empty.

  Examples:

  - Between two dates: \["2024-12-01", "2024-12-15"]

  - After a date: \["2024-12-01", ""]

  - Before a date: \["", "2024-12-15"]

  The filter is applied after collection!

- Sort By (select)

  Similar to the sorting in Google Maps.

  "Most Likes" is applied after collection!

- Reply filter (select)

  Returns All Reviews, Only reviews with replies or Only reviews without replies.

  The filter is applied after collection!

- Source filter (string)

  Returns only reviews from a specific source.

  For example, "trip" will match "Tripadvisor.com" and "Trip.com".

  The filter is applied after collection!

- Country (string)

  Must be ISO 3166, such as "us". This is only used to simulate geolocation (NOT a filter).

- User Latitude/Longitude (string)

  Optional. May help narrow down locations during search.

- Maximum (integer)

  Stops collection once this number is reached.

- Parallel runs (integer)

  Will run data collection in batches (parallism). Signficantly speeds up the process.

- Delay (integer)

  Waiting time between requests. The lower, the higher the chances to get blocked.

### Ouput

**Reviews** returns:

The field "location" is only populated when the Place is using search terms (id, name, address, coordinates).

```
{
	"url": "https://www.google.com/maps/place/Empire+State+Building/@40.7484405,-73.9882393,17z/data=!3m1!5s0x8b398fecd1aea119:0x76fa1e3ac5a94c70!4m8!3m7!1s0x89c259a9b3117469:0xd134e199a405a163!8m2!3d40.7484405!4d-73.9856644!9m1!1b1!16zL20vMDJuZF8?entry=ttu&g_ep=EgoyMDI0MTIxMC4wIKXMDSoASAFQAw%3D%3D",
	"location": null,
	"reviews": [
		{
			"id": "ChdDSUhNMG9nS0VJQ0FnSUNIeTRQVXlnRRAB",
			"publishedAt": "2024-09-08T23:05:34",
			"updatedAt": "2024-09-08T23:05:34",
			"rating": 4,
			"review": "My visit to the Empire State Building was an unforgettable experience. From the moment I entered the iconic building, I was struck by its grandeur and historical significance. The Art Deco architecture is stunning, and the lobby itself is a sight to behold.\nThe elevator ride to the observation deck was smooth and quick, and the staff were friendly and efficient. Once at the top, the views were absolutely breathtaking. Seeing New York City from such a height is truly awe-inspiring. The 360-degree panorama allows you to take in all the major landmarks, from Central Park to the Statue of Liberty.\nThe exhibits on the way up were informative and added to the overall experience, providing interesting insights into the building’s history and construction. The binoculars on the observation deck were a fun addition, allowing for an even closer look at the city’s details.\nIn summary, the Empire State Building is a must-visit attraction in New York City. The combination of its historical charm, architectural beauty, and stunning views makes it an experience not to be missed.",
			"language": "en",
			"likes": 4,
			"reply": "Wow, Sacha, what a great review! We are forever grateful! Thank you so much for choosing to spend some of your NYC time with us and thank you for sharing your amazing photos! \n\nWe would love to get some feedback from you on what we could improve upon to have earned that full 5-star rating from you versus the 4-star rating. If you are willing to share your feedback, please email us at \"roomtoimprove@esbonyc.com\" to let us know what you think could have been better in order to get that 5-star ranking. We eagerly await to hear from you. Much appreciated! ",
			"author": {
				"name": "Sacha",
				"avatar": "https://lh3.googleusercontent.com/a/ACg8ocKUMya57gW4Zx8X0fjx9LyKItsD9qdKhmKcDLVewizdEhysnw=s120-c-rp-mo-ba6-br100",
				"url": "https://www.google.com/maps/contrib/105739057713241335266?hl=en",
				"id": "105739057713241335266"
			},
			"images": [
				{
					"id": "AF1QipNzGVdB04NP5w0G1UNgqf14MMV7jjrtQXdvhzEk",
					"url": "https://lh5.googleusercontent.com/p/AF1QipNzGVdB04NP5w0G1UNgqf14MMV7jjrtQXdvhzEk=w150-h150-k-no-p",
					"size": {
						"width": 3024,
						"height": 4032
					},
					"location": "Empire State Building",
					"caption": null
				},
				...
			],
			"source": "Google",
			"url": "https://www.google.com/maps/reviews/..."
		},
        ...
    ],
    "count": 10
}
```

**Details** returns:

The field "categoryDetails" depends on the category. For example, restaurants have a menu link, hotels have checkin/checkout times, etc.

```
{
	"name": "Free Play Bar Arcade",
	"description": "Playful watering hole for the 21+ crowd offering free classic arcade games, beer on tap & pizza.",
	"link": "https://freeplaybar.com/",
	"category": "Video arcade",
	"categoryDetails": {
		"menu": "https://freeplaybar.com/menu",
		"reservation": "https://restaurent.com/venue/freeplay-providence/"
	},
	"location": {
		"address": "Free Play Bar Arcade, 182 Pine St, Providence, RI 02903",
		"localTimezone": "America/New_York",
		"telephone": "+14013164299"
	},
	"reviewsSummary": {
		"rating": 4.7,
		"count": 2021
	},
	"timetable": [
		{
			"day": "Saturday",
			"nextDate": "2024-12-14",
			"hours": "5 PM–2 AM"
		},
		...
	],
	"tags": [
		{
			"tag": "drinks",
			"count": 112
		},
		...
	],
	"images": [
		{
			"title": "All",
			"url": "https://lh5.googleusercontent.com/p/AF1QipOJIcFB7UBp4luzuGSUXlMh2MqVkUz31X93S7I5=w447-h298-k-no"
		},
		...
	],
	"about": [
		{
			"sectionName": "Accessibility",
			"items": [
				{
					"id": "/geo/type/establishment_poi/has_wheelchair_accessible_entrance",
					"name": "Wheelchair accessible entrance"
				},
				{
					"id": "/geo/type/establishment_poi/has_wheelchair_accessible_restroom",
					"name": "Wheelchair accessible restroom"
				}
			]
		},
		...
	]
}
```

### Support

Always use a strong proxy.

Open a new issue or contact support. Please share the Run URL and Input!

Cheers!

# Actor input Schema

## `urls` (type: `array`):

Can be a query or an exact URL. See Information tab.

## `category` (type: `string`):

Place details or Reviews.

## `keyword` (type: `string`):

Optional. The keyword to search for in the review content.

## `lang` (type: `string`):

Language (ISO 639-1) in which reviews should be written. Set to 'all' to include all languages.

## `sorting` (type: `string`):

Select how to sort results.

## `replies` (type: `string`):

Only includes reviews with a reply from the business.

## `source` (type: `string`):

Only includes reviews from the specified source. Leave empty for all.

## `daterange` (type: `array`):

See Information tab for the correct format to use.

## `country` (type: `string`):

Country (ISO 3166) to search from.

## `mylatitude` (type: `string`):

Optional. Can help refine the results.

## `mylongitude` (type: `string`):

Optional. Can help refine the results.

## `maximum` (type: `integer`):

No description

## `batch` (type: `integer`):

Number of URLs to process in parallel.

## `delay` (type: `integer`):

No description

## `proxy` (type: `object`):

Select proxies to be used by your crawler.

## Actor input object example

```json
{
  "urls": [
    "eiffel tower france",
    "https://maps.app.goo.gl/dssCoQXwEyRMKF5D9",
    "https://www.google.com/maps/place/Disneyland+Park/@33.8120962,-117.9215491,17z/data=!4m8!3m7!1s0x80dcd7d12b3b5e6b:0x2ef62f8418225cfa!8m2!3d33.8120918!4d-117.9189742!9m1!1b1!16zL20vMDJmenM?hl=en-GB&entry=ttu&g_ep=EgoyMDI0MTIwOS4wIKXMDSoASAFQAw%3D%3D",
    "https://www.google.com/maps/place/The+Beatrice/@41.8190167,-71.4102502,15.83z/data=!3m1!5s0x89e445169851b4bf:0xfe7a077c429aeb7c!4m9!3m8!1s0x89e445e36767878d:0x2359615e2c4bfb51!5m2!4m1!1i2!8m2!3d41.8247943!4d-71.4102758!16s%2Fg%2F11h6q7qbc3?entry=ttu&g_ep=EgoyMDI0MTIxMC4wIKXMDSoASAFQAw%3D%3D",
    "https://www.google.com/maps/place/Free+Play+Bar+Arcade/@41.8200372,-71.4126039,17.19z/data=!4m6!3m5!1s0x89e4456cee29fa73:0x805935ff8c3f27ec!8m2!3d41.8200612!4d-71.4120607!16s%2Fg%2F11d_yz7_b4?entry=ttu&g_ep=EgoyMDI0MTIxMC4wIKXMDSoASAFQAw%3D%3D",
    "https://www.google.com/maps/place/Gracie's/@41.8212956,-71.4202054,17z/data=!4m10!1m2!2m1!1sRestaurants!3m6!1s0x89e44512efe71ee9:0x2fc7231d6ad290c!8m2!3d41.822057!4d-71.4158905!15sCgtSZXN0YXVyYW50c1oNIgtyZXN0YXVyYW50c5IBFmZpbmVfZGluaW5nX3Jlc3RhdXJhbnTgAQA!16s%2Fg%2F1th5dl8g"
  ],
  "category": "reviews",
  "keyword": "",
  "lang": "all",
  "sorting": "2",
  "replies": "all",
  "source": "",
  "daterange": [],
  "country": "us",
  "mylatitude": "19.935915607405615",
  "mylongitude": "-155.17564762636795",
  "maximum": 20,
  "batch": 3,
  "delay": 3,
  "proxy": {
    "useApifyProxy": true
  }
}
```

# 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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "urls": [
        "eiffel tower france",
        "https://maps.app.goo.gl/dssCoQXwEyRMKF5D9",
        "https://www.google.com/maps/place/Disneyland+Park/@33.8120962,-117.9215491,17z/data=!4m8!3m7!1s0x80dcd7d12b3b5e6b:0x2ef62f8418225cfa!8m2!3d33.8120918!4d-117.9189742!9m1!1b1!16zL20vMDJmenM?hl=en-GB&entry=ttu&g_ep=EgoyMDI0MTIwOS4wIKXMDSoASAFQAw%3D%3D",
        "https://www.google.com/maps/place/The+Beatrice/@41.8190167,-71.4102502,15.83z/data=!3m1!5s0x89e445169851b4bf:0xfe7a077c429aeb7c!4m9!3m8!1s0x89e445e36767878d:0x2359615e2c4bfb51!5m2!4m1!1i2!8m2!3d41.8247943!4d-71.4102758!16s%2Fg%2F11h6q7qbc3?entry=ttu&g_ep=EgoyMDI0MTIxMC4wIKXMDSoASAFQAw%3D%3D",
        "https://www.google.com/maps/place/Free+Play+Bar+Arcade/@41.8200372,-71.4126039,17.19z/data=!4m6!3m5!1s0x89e4456cee29fa73:0x805935ff8c3f27ec!8m2!3d41.8200612!4d-71.4120607!16s%2Fg%2F11d_yz7_b4?entry=ttu&g_ep=EgoyMDI0MTIxMC4wIKXMDSoASAFQAw%3D%3D",
        "https://www.google.com/maps/place/Gracie's/@41.8212956,-71.4202054,17z/data=!4m10!1m2!2m1!1sRestaurants!3m6!1s0x89e44512efe71ee9:0x2fc7231d6ad290c!8m2!3d41.822057!4d-71.4158905!15sCgtSZXN0YXVyYW50c1oNIgtyZXN0YXVyYW50c5IBFmZpbmVfZGluaW5nX3Jlc3RhdXJhbnTgAQA!16s%2Fg%2F1th5dl8g"
    ],
    "keyword": "",
    "lang": "all",
    "source": "",
    "daterange": [],
    "country": "us",
    "mylatitude": "19.935915607405615",
    "mylongitude": "-155.17564762636795",
    "proxy": {
        "useApifyProxy": true
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("canadesk/google-places-reviews-plus").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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "urls": [
        "eiffel tower france",
        "https://maps.app.goo.gl/dssCoQXwEyRMKF5D9",
        "https://www.google.com/maps/place/Disneyland+Park/@33.8120962,-117.9215491,17z/data=!4m8!3m7!1s0x80dcd7d12b3b5e6b:0x2ef62f8418225cfa!8m2!3d33.8120918!4d-117.9189742!9m1!1b1!16zL20vMDJmenM?hl=en-GB&entry=ttu&g_ep=EgoyMDI0MTIwOS4wIKXMDSoASAFQAw%3D%3D",
        "https://www.google.com/maps/place/The+Beatrice/@41.8190167,-71.4102502,15.83z/data=!3m1!5s0x89e445169851b4bf:0xfe7a077c429aeb7c!4m9!3m8!1s0x89e445e36767878d:0x2359615e2c4bfb51!5m2!4m1!1i2!8m2!3d41.8247943!4d-71.4102758!16s%2Fg%2F11h6q7qbc3?entry=ttu&g_ep=EgoyMDI0MTIxMC4wIKXMDSoASAFQAw%3D%3D",
        "https://www.google.com/maps/place/Free+Play+Bar+Arcade/@41.8200372,-71.4126039,17.19z/data=!4m6!3m5!1s0x89e4456cee29fa73:0x805935ff8c3f27ec!8m2!3d41.8200612!4d-71.4120607!16s%2Fg%2F11d_yz7_b4?entry=ttu&g_ep=EgoyMDI0MTIxMC4wIKXMDSoASAFQAw%3D%3D",
        "https://www.google.com/maps/place/Gracie's/@41.8212956,-71.4202054,17z/data=!4m10!1m2!2m1!1sRestaurants!3m6!1s0x89e44512efe71ee9:0x2fc7231d6ad290c!8m2!3d41.822057!4d-71.4158905!15sCgtSZXN0YXVyYW50c1oNIgtyZXN0YXVyYW50c5IBFmZpbmVfZGluaW5nX3Jlc3RhdXJhbnTgAQA!16s%2Fg%2F1th5dl8g",
    ],
    "keyword": "",
    "lang": "all",
    "source": "",
    "daterange": [],
    "country": "us",
    "mylatitude": "19.935915607405615",
    "mylongitude": "-155.17564762636795",
    "proxy": { "useApifyProxy": True },
}

# Run the Actor and wait for it to finish
run = client.actor("canadesk/google-places-reviews-plus").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 '{
  "urls": [
    "eiffel tower france",
    "https://maps.app.goo.gl/dssCoQXwEyRMKF5D9",
    "https://www.google.com/maps/place/Disneyland+Park/@33.8120962,-117.9215491,17z/data=!4m8!3m7!1s0x80dcd7d12b3b5e6b:0x2ef62f8418225cfa!8m2!3d33.8120918!4d-117.9189742!9m1!1b1!16zL20vMDJmenM?hl=en-GB&entry=ttu&g_ep=EgoyMDI0MTIwOS4wIKXMDSoASAFQAw%3D%3D",
    "https://www.google.com/maps/place/The+Beatrice/@41.8190167,-71.4102502,15.83z/data=!3m1!5s0x89e445169851b4bf:0xfe7a077c429aeb7c!4m9!3m8!1s0x89e445e36767878d:0x2359615e2c4bfb51!5m2!4m1!1i2!8m2!3d41.8247943!4d-71.4102758!16s%2Fg%2F11h6q7qbc3?entry=ttu&g_ep=EgoyMDI0MTIxMC4wIKXMDSoASAFQAw%3D%3D",
    "https://www.google.com/maps/place/Free+Play+Bar+Arcade/@41.8200372,-71.4126039,17.19z/data=!4m6!3m5!1s0x89e4456cee29fa73:0x805935ff8c3f27ec!8m2!3d41.8200612!4d-71.4120607!16s%2Fg%2F11d_yz7_b4?entry=ttu&g_ep=EgoyMDI0MTIxMC4wIKXMDSoASAFQAw%3D%3D",
    "https://www.google.com/maps/place/Gracie'\''s/@41.8212956,-71.4202054,17z/data=!4m10!1m2!2m1!1sRestaurants!3m6!1s0x89e44512efe71ee9:0x2fc7231d6ad290c!8m2!3d41.822057!4d-71.4158905!15sCgtSZXN0YXVyYW50c1oNIgtyZXN0YXVyYW50c5IBFmZpbmVfZGluaW5nX3Jlc3RhdXJhbnTgAQA!16s%2Fg%2F1th5dl8g"
  ],
  "keyword": "",
  "lang": "all",
  "source": "",
  "daterange": [],
  "country": "us",
  "mylatitude": "19.935915607405615",
  "mylongitude": "-155.17564762636795",
  "proxy": {
    "useApifyProxy": true
  }
}' |
apify call canadesk/google-places-reviews-plus --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=canadesk/google-places-reviews-plus",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Google Places Reviews Plus",
        "description": "No limits + Full details. Get all reviews for places such as monuments, restaurants or hotels from Google Maps! Also includes likes, images, replies and filters. It's (very) fast and costs little!",
        "version": "2.1",
        "x-build-id": "kXP2Cee2Nu09Xdk04"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/canadesk~google-places-reviews-plus/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-canadesk-google-places-reviews-plus",
                "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/canadesk~google-places-reviews-plus/runs": {
            "post": {
                "operationId": "runs-sync-canadesk-google-places-reviews-plus",
                "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/canadesk~google-places-reviews-plus/run-sync": {
            "post": {
                "operationId": "run-sync-canadesk-google-places-reviews-plus",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        }
    },
    "components": {
        "schemas": {
            "inputSchema": {
                "type": "object",
                "required": [
                    "urls",
                    "lang"
                ],
                "properties": {
                    "urls": {
                        "title": "Places",
                        "type": "array",
                        "description": "Can be a query or an exact URL. See Information tab."
                    },
                    "category": {
                        "title": "Data type",
                        "enum": [
                            "reviews",
                            "preview"
                        ],
                        "type": "string",
                        "description": "Place details or Reviews.",
                        "default": "reviews"
                    },
                    "keyword": {
                        "title": "Search filter",
                        "type": "string",
                        "description": "Optional. The keyword to search for in the review content.",
                        "default": ""
                    },
                    "lang": {
                        "title": "Language",
                        "type": "string",
                        "description": "Language (ISO 639-1) in which reviews should be written. Set to 'all' to include all languages.",
                        "default": "all"
                    },
                    "sorting": {
                        "title": "Sort By",
                        "enum": [
                            "1",
                            "2",
                            "3",
                            "4",
                            "5"
                        ],
                        "type": "string",
                        "description": "Select how to sort results.",
                        "default": "2"
                    },
                    "replies": {
                        "title": "Reply filter",
                        "enum": [
                            "all",
                            "with",
                            "without"
                        ],
                        "type": "string",
                        "description": "Only includes reviews with a reply from the business.",
                        "default": "all"
                    },
                    "source": {
                        "title": "Source filter",
                        "type": "string",
                        "description": "Only includes reviews from the specified source. Leave empty for all.",
                        "default": ""
                    },
                    "daterange": {
                        "title": "Date filter",
                        "type": "array",
                        "description": "See Information tab for the correct format to use."
                    },
                    "country": {
                        "title": "User country",
                        "type": "string",
                        "description": "Country (ISO 3166) to search from.",
                        "default": "us"
                    },
                    "mylatitude": {
                        "title": "User latitude",
                        "type": "string",
                        "description": "Optional. Can help refine the results.",
                        "default": "19.935915607405615"
                    },
                    "mylongitude": {
                        "title": "User longitude",
                        "type": "string",
                        "description": "Optional. Can help refine the results.",
                        "default": "-155.17564762636795"
                    },
                    "maximum": {
                        "title": "Maximum results",
                        "minimum": 10,
                        "maximum": 9999,
                        "type": "integer",
                        "description": "",
                        "default": 20
                    },
                    "batch": {
                        "title": "Parallel runs",
                        "minimum": 1,
                        "maximum": 20,
                        "type": "integer",
                        "description": "Number of URLs to process in parallel.",
                        "default": 3
                    },
                    "delay": {
                        "title": "Requests delay",
                        "minimum": 2,
                        "maximum": 30,
                        "type": "integer",
                        "description": "",
                        "default": 3
                    },
                    "proxy": {
                        "title": "Proxy configuration",
                        "type": "object",
                        "description": "Select proxies to be used by your crawler."
                    }
                }
            },
            "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
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
