Getting all reviews from the Official Google Maps API

The official Google places API limits the amount of the reviews you can fetch from it to 5 reviews only. Despite many developers asking for pagination and sorting parameters since 2015 the limitation still exists. Fortunately, there are some tools you can use from your code to get ratings & reviews in the right way.


The ultimate way of fetching reviews

With Outscraper's API, you can fetch any amount of reviews from any business. You can sort the reviews, and paginate over the pages. It's possible to ignore empty reviews by using the "ignoreEmpty" parameter and there are many advanced parameters like cutoff, cutoffRating, etc.

Reviews API examples

The basic example of fetching 20 reviews by the default sorting (most relevant reviews).

				
					# fetch 20 most relevant reviews
curl -X GET "https://api.app.outscraper.com/maps/reviews-v2?query=PLACE_ID&reviewsLimit=20&async=false" -H  "X-API-KEY: API_KEY"
				
			

The sort parameter might be one of the following: "most_relevant" (default), "newest", "highest_rating", and "lowest_rating".

				
					# fetch reviews with highest rating first
curl -X GET "https://api.app.outscraper.com/maps/reviews-v2?query=PLACE_ID&reviewsLimit=20&sort=highest_rating&async=false" -H  "X-API-KEY: API_KEY"

# fetch reviews with lowest rating first
curl -X GET "https://api.app.outscraper.com/maps/reviews-v2?query=PLACE_ID&reviewsLimit=20&sort=lowest_rating&async=false" -H  "X-API-KEY: API_KEY"

				
			

In addition to the reviewsLimit parameter you can specify cutoffRating. The parameter specifies the maximum for "lowest_rating" or the minimum for "highest_rating" rating for reviews.

				
					# fetch reviews with 5 and 4 stars ratings only
curl -X GET "https://api.app.outscraper.com/maps/reviews-v2?query=PLACE_ID&reviewsLimit=1000&sort=highest_rating&cutoffRating=4&async=false" -H  "X-API-KEY: API_KEY"


				
			

The cutoff parameter will help you to fetch only the newest reviews till the specific date in the past. Might be helpful when you have all the reviews in your database and want to fetch only the reviews that were added since your last update.

				
					# fetch reviews till the specific date (cutoff)
curl -X GET "https://api.app.outscraper.com/maps/reviews-v2?query=PLACE_ID&reviewsLimit=250&sort=newest&cutoff=1629269269&async=false" -H  "X-API-KEY: API_KEY"
				
			

There is build-in pagination that you can use to fetch many pages of reviews. Use the skip parameter to control where API begins returning results.

				
					# page 1, sorted by newest
curl -X GET "https://api.app.outscraper.com/maps/reviews-v2?query=PLACE_ID&reviewsLimit=20&sort=newest&async=false" -H  "X-API-KEY: API_KEY"

# page 2, sorted by newest
curl -X GET "https://api.app.outscraper.com/maps/reviews-v2?query=PLACE_ID&reviewsLimit=20&sort=newest&skip=20async=false" -H  "X-API-KEY: API_KEY"
				
			

Fetching many reviews in one request might take time. In order to prevent a timeout error from the webserver, it's recommended to use async requests. This way you will submit your requests to Outscraper and retrieve them later (usually within 1-3 minutes, depends on the amount of reviews) with the Request Results endpoint.

A good practice is to send async requests and starting checking the results at 15-sec intervals. Check out this Python implementation if necessary.

				
					# step 1: submit the task and get request id
curl -X GET "https://api.app.outscraper.com/maps/reviews-v2?query=PLACE_ID_1&reviewsLimit=2000&sort=newest&async=true" -H  "X-API-KEY: API_KEY"

# step 2: retrieve the task results later (usually within 1-3 minutes, depends on the amount of reviews)
curl -X GET "https://api.app.outscraper.com/requests/REQUEST_ID"
				
			

Google Reviews API pricing

The prices depend on the usage during the subscription period (30 days). There are different tiers starting from $0 per the first 500 reviews.

프리 티어
$0/검토
  • 선착순 1~500명
기동기
$0.002/검토
  • 다음 501에서 50,000까지
사업
$0.001/검토
  • 나머지를 위해

Bonus & helpful links

10% 꺼짐

지금 가입하고 프로모션 코드: SCRAPER2021을 사용하여 할인을 받으세요.
카테고리: API

0 Comments

답글 남기기

Avatar placeholder

이메일 주소는 공개되지 않습니다. 필수 항목은 *(으)로 표시합니다

ko_KR