Google Reviews API
Overview
The Google Reviews API offers valuable business opportunities by allowing you to extract detailed information about customer reviews for businesses and places. By providing the Place ID or the review URL as input, you can access review content, ratings, and other essential details, enabling businesses to analyze customer feedback, improve services, and enhance their online reputation
Authentication
Visit our Authentication Docs on learning how to get started on integrating this API in your application.
Endpoint
GET https://get.scrapehero.com/api/google/reviews/?x-api-key=<YOUR_API_KEY>&place_id=ChIJ8xxuwGG2d0gR4zxqSSWXwrI&sort=most_relevant
Request Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| place_id | string | Yes | Google Place ID |
| sort | string | No | Sort reviews |
Alternatively, the API accepts the review URL as the input review URL or place id must be present
Response Format
The API returns data in JSON format. Here's an example of the response structure:
{
"query": {
"input": "ChIJ8xxuwGG2d0gR4zxqSSWXwrI",
"page": 1,
"sort": "most_relevant"
},
"data": {
"profile": {
"name": "Fujifilm UK",
"reviewCount": "46",
"aggregateRating": "4.7",
"address": "Fujifilm House, Whitbread Wy, Bedford, United Kingdom",
"place_id": "ChIJ8xxuwGG2d0gR4zxqSSWXwrI",
"businessUrl": "https://www.google.com/maps/place/?q=place_id:ChIJ8xxuwGG2d0gR4zxqSSWXwrI"
},
"reviews": [
{
"author": "Barry Toward",
"reviewUrl": "https://www.google.com/maps/contrib/108599254920102391736/reviews?hl=en-US&ved=1t:31293&ictx=111",
"reviewSource": "www.google.com",
"images": [
"https://lh5.googleusercontent.com/p/AF1QipOPvpmY8omHnwjb6fSFAwDU3wIGoEydggDgMbfo"
],
"reviewBody": "Great service from start to finish as others have stated. X-T30 serviced & 10-24 complete re-build when both severly damaged in a storm. X-T20 had a new sensor, motherboard & top plate replaced all within the fixed price. Nothing appears too much trouble & very helpful on the telephone",
"reviewTags": null,
"orginalText": null,
"reviewRating": "5.0",
"ratingMaxvalue": "5.0",
"dateCreated": "a month ago"
},
{
"author": "Noel Jenkins",
"reviewUrl": "https://www.google.com/maps/contrib/106493838482223011690/reviews?hl=en-US&ved=1t:31293&ictx=111",
"reviewSource": "www.google.com",
"images": null,
"reviewBody": "Exceptional service from Fujifilm who repaired and cleaned my much abused XT2 on the day they recieved it AND dispatched back the same day. A four day turnaround the week before Christmas and got back what looks like a new camera. Really happy with the service centre.",
"reviewTags": null,
"orginalText": null,
"reviewRating": "5.0",
"ratingMaxvalue": "5.0",
"dateCreated": "a year ago"
},
{
"author": "Martijn",
"reviewUrl": "https://www.google.com/maps/contrib/102848558691866305527/reviews?hl=en-US&ved=1t:31293&ictx=111",
"reviewSource": "www.google.com",
"images": null,
"reviewBody": "Hands down the best support experience I've ever received. Professional from start to finish, (from the initial response from a support ticket to sending a beautifully printed fuji return box for me, to the repair itself (on an out of warranty item suffering a well known issue) to using DPD to ship the products - I'm deeply impressed. Thank you Fujifilm!",
"reviewTags": null,
"orginalText": null,
"reviewRating": "5.0",
"ratingMaxvalue": "5.0",
"dateCreated": "a year ago"
},
{
"author": "Richard H",
"reviewUrl": "https://www.google.com/maps/contrib/113132196972362578536/reviews?hl=en-US&ved=1t:31293&ictx=111",
"reviewSource": "www.google.com",
"images": null,
"reviewBody": "Fuji received my camera on Monday and notified me as soon as they received it, notified me on Wednesday that it had been dispatched and I received it Thursday morning at 10.40. the repair they did made my camera look like new. That's what i call incredible service and customer care, well done Fuji and thank you.4 years on and a problem with a different camera, had a great conversation with Albert on Tues, return boxes and labels were delivered to me on Wed morning, back in the post to them same day, received an email and text at 9am Thurs saying received, email and text the same afternoon saying repair was being dispatched, email received this morning Fri saying 9-10 am, DPD arrived at 9.30am, what a service, absolutely brilliant Fuji. Basically 48 hrs, beats all the competition hands down.",
"reviewTags": null,
"orginalText": null,
"reviewRating": "5.0",
"ratingMaxvalue": "5.0",
"dateCreated": "a year ago"
},
{
"author": "George Cochrane",
"reviewUrl": "https://www.google.com/maps/contrib/109706946788852915899/reviews?hl=en-US&ved=1t:31293&ictx=111",
"reviewSource": "www.google.com",
"images": null,
"reviewBody": "Albert was fantastic in getting my X-T200 camera repaired very quickly and with wonderful results. It's great to be able to talk it through on the phone and understand the process before proceeding. UK Fuijfilm camera owners can sleep easy knowing there are support people like Albert around to help!",
"reviewTags": null,
"orginalText": null,
"reviewRating": "5.0",
"ratingMaxvalue": "5.0",
"dateCreated": "2 years ago"
},
{
"author": "Mohammed A Malik",
"reviewUrl": "https://www.google.com/maps/contrib/105476802730573773887/reviews?hl=en-US&ved=1t:31293&ictx=111",
"reviewSource": "www.google.com",
"images": null,
"reviewBody": "What a great bunch of guys. My 50-230mm lens had dropped and rear plate had snapped. I contacted Fujifilm service engineers and explained the situation. They sent me a pre paid box very well padded. I sent it in and lo and behold a week later I'm connecting my lens back on my camera and its wonderful again so thank you Fuji, you guys rock. P.s it didn't cost an arm and a leg either. I will definitely recommend.",
"reviewTags": null,
"orginalText": null,
"reviewRating": "5.0",
"ratingMaxvalue": "5.0",
"dateCreated": "2 years ago"
},
{
"author": "Alex Jones-Wolsey",
"reviewUrl": "https://www.google.com/maps/contrib/104747568201137601577/reviews?hl=en-US&ved=1t:31293&ictx=111",
"reviewSource": "www.google.com",
"images": null,
"reviewBody": "Great products backed by truly world class UK support & servicing. Recent camera repair was completed in astonishingly quick timeframe. Received notifications throughout the process and the camera was returned in pristine condition via 1hr slot courier only 1 week later! Wouldn’t hesitate to recommend Fujifilm products to either amateurs or professionals. Amazingly efficient service!",
"reviewTags": null,
"orginalText": null,
"reviewRating": "5.0",
"ratingMaxvalue": "5.0",
"dateCreated": "4 years ago"
},
{
"author": "S Matthews",
"reviewUrl": "https://www.google.com/maps/contrib/103699815613976616511/reviews?hl=en-US&ved=1t:31293&ictx=111",
"reviewSource": "www.google.com",
"images": null,
"reviewBody": "I am a camera lover with loads of Canon and Nikon kit, but my Fujifilm X-T1 is easily my favourite camera. Lightish, smallish and with pleasingly tactile high quality manual controls if manual control is what you prefer (I do!), and produces great photos.A few weeks ago I somehow clicked 'toy mode' and all the photos were heavily vignetted. I emailed Fujifilm some sample photos and they replied within a few hours, explaining how to get out of toy mode.So, a great camera with great back-up from Fujifilm UK.",
"reviewTags": null,
"orginalText": null,
"reviewRating": "5.0",
"ratingMaxvalue": "5.0",
"dateCreated": "4 years ago"
},
{
"author": "Cam Brown",
"reviewUrl": "https://www.google.com/maps/contrib/115030132135528652831/reviews?hl=en-US&ved=1t:31293&ictx=111",
"reviewSource": "www.google.com",
"images": [
"https://lh5.googleusercontent.com/p/AF1QipOYfSOYXbo4RTRxnDLZIbrU4fD4AzvwTJPkIHQv"
],
"reviewBody": "Had great help from Fuji when buying my new XT3 equipment from Wex. They honoured a deal that had ended that morning which they didn't have to. Great start to a new brand after using Nikon for 10 years. Big thumbs up!!",
"reviewTags": null,
"orginalText": null,
"reviewRating": "5.0",
"ratingMaxvalue": "5.0",
"dateCreated": "5 years ago"
},
{
"author": "Balbonicus G",
"reviewUrl": "https://www.google.com/maps/contrib/117386508952119552738/reviews?hl=en-US&ved=1t:31293&ictx=111",
"reviewSource": "www.google.com",
"images": null,
"reviewBody": "Great experience from the Fuji Service Centre. Sent my camera Friday. Arrived Monday due to the weekend and recieved camera the next day!! Service was swift and communication was clear and simple! Good job Fuji",
"reviewTags": null,
"orginalText": null,
"reviewRating": "5.0",
"ratingMaxvalue": "5.0",
"dateCreated": "5 years ago"
}
],
"next_page": "https://get.scrapehero.com/api/google/reviews/?place_id=ChIJ8xxuwGG2d0gR4zxqSSWXwrI&cursor=eyJuYW1lIjogIkZ1amlmaWxtIFVLIiwgInRvdGFsX3Jldmlld3MiOiAiNDYiLCAiYXZlcmFnZV9yYXRpbmciOiAiNC43IiwgImFkZHJlc3MiOiAiRnVqaWZpbG0gSG91c2UsIFdoaXRicmVhZCBXeSwgQmVkZm9yZCwgVW5pdGVkIEtpbmdkb20iLCAiaW5wdXQiOiAiQ2hJSjh4eHV3R0cyZDBnUjR6eHFTU1dYd3JJIiwgInBsYWNlX2lkIjogIkNoSUo4eHh1d0dHMmQwZ1I0enhxU1NXWHdySSIsICJ0b2tlbiI6ICJDQUVTWTBOQlJWRkRhSEJGVVRKd1JsTlZSbE5UV0VKRVdqSTVRbFZFWkdaVVJXaFFVa2MxWmxneE9XWlNWMmhFVmxWb1RWWlZiSEJpYldoelRsUm9RbFF6UVRGak1FWkNVVlZHUWxJeVpIVlBWRTVYV1RCT2RGcElSbTVQUkU0elYxVkdSRk5WUlE9PSIsICJwYWdlIjogMiwgInNvcnRfdmFsdWUiOiAicXVhbGl0eVNjb3JlIiwgImZlYXR1cmVfaWQiOiAiMHg0ODc3YjY2MWMwNmUxY2YzOjB4YjJjMjk3MjU0OTZhM2NlMyJ9"
}
}
Response Fields
| Field | Type | Description |
|---|---|---|
| name | string | name |
| reviewCount | string | review count |
| aggregateRating | string | avarage rating |
| address | string | address |
| place_id | string | google placeid |
| businessUrl | string | business url |
| reviews | list | list of reviews data |
| author | string | author |
| reviewUrl | string | review url |
| reviewSource | string | review source |
| images | list | list of image urls |
| reviewBody | string | review body text |
| reviewTags | string | review tags |
| orginalText | string | orginal text |
| reviewRating | string | review rating |
| ratingMaxvalue | string | rating maxvalue |
| dateCreated | string | date created |
Usage Example
Here's an example of how to use the API with Python:
- JavaScript
- Python
- Java
- Ruby
const http = require("https");
const options = {
"method": "GET",
"hostname": "get.scrapehero.com",
"port": null,
"path": "/api/google/reviews/?x-api-key=<YOUR_API_KEY>&place_id=ChIJ8xxuwGG2d0gR4zxqSSWXwrI&sort=most_relevant",
"headers": {}
};
const req = http.request(options, function (res) {
const chunks = [];
res.on("data", function (chunk) {
chunks.push(chunk);
});
res.on("end", function () {
const body = Buffer.concat(chunks);
console.log(body.toString());
});
});
req.end();
import http.client
conn = http.client.HTTPSConnection("get.scrapehero.com")
conn.request("GET", "/api/google/reviews/?x-api-key=<YOUR_API_KEY>&place_id=ChIJ8xxuwGG2d0gR4zxqSSWXwrI&sort=most_relevant")
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))
HttpResponse<String> response = Unirest.get("https://get.scrapehero.com/api/google/reviews/?x-api-key=<YOUR_API_KEY>&place_id=ChIJ8xxuwGG2d0gR4zxqSSWXwrI&sort=most_relevant")
.asString();
require 'uri'
require 'net/http'
require 'openssl'
url = URI("https://get.scrapehero.com/api/google/reviews/?x-api-key=<YOUR_API_KEY>&place_id=ChIJ8xxuwGG2d0gR4zxqSSWXwrI&sort=most_relevant")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
http.verify_mode = OpenSSL::SSL::VERIFY_NONE
request = Net::HTTP::Get.new(url)
response = http.request(request)
puts response.read_body
This API uses 10 data credit per API call. Learn more about data credits.
Rate Limits
Rate limits are based off the plan that you have subscribed to. To learn more about the plan specification vist our Plans page.
Response Codes
Check out the response codes here.
Best Practices
- Use appropriate error handling in your code.
- Implement exponential backoff for rate limiting.
- Cache results when possible to minimize API calls.
Support
If you encounter any issues or have questions, please contact our API support team at cloud-support@scrapehero.com or visit our API documentation at https://app.scrapehero.com/docs/api_intro.