Google Maps reviews API documentation

We provide a simple to setup REST API that returns reviews in JSON format. Before integrating the API you should be aware of the following:

  • The API returns 10 reviews per request.
  • The default order in which reviews are returned is by descending date(from newest to oldest).
  • You can get all reviews from a single place by using the offset parameter.

To get reviews from Wextractor you will need to perform GET requests against the https://wextractor.com/api/v1/reviews endpoint.

Reviews endpoint parameters:

Parameter Required Description Example
auth_token Required Your API token for authentication. Once you register to Wextractor you can extract this key from your account's setting page. -
id Required A textual identifier that uniquely identifies a place in Google Maps. For more information on place ids you can refer to this doc. ChIJN1t_tDeuEmsRUsoyG83frY4
offset Optional This parameter defines the result offset. It skips the given number of reviews. It's used for pagination. (e.g., 0 (default) is the first page of results, 10 is the 2nd page of results, 20 is the 3rd page of results, etc.). 10
sort Optional This parameter defines in which order the results will be returned. If no value is passed, the results will be ordered by descending date. The possible values for this setting are:
  • recency (default): return newest reviews first.
  • relevancy: return the most relevant reviews first, this is the default order Google Maps uses when displaying reviews. They are usually higher quality reviews.
  • highest_rating: return the reviews with higher ratings first.
  • lowest_rating: return the reviews with lower ratings first.
recency
hl Optional This is the "host language" parameter that Google uses accross its products. It's used to determine the preferred language for the results. This is mostly important when sorting by relevancy, as results in the preferred language will be returned first. This setting defaults to en (English). The setting expects a two letter language code as defined in ISO 639-1. en
keywords Optional Optional parameter to return the keywords mentioned counts that Google Maps displays in its interface. If you want to include the list of mentioned keyword stats in the response pass this parameter as 1. Note that keywords are only included when retrieving the first page of results(offset 0). 1

Example usage:

https://wextractor.com/api/v1/reviews?id=ChIJN1t_tDeuEmsRUsoyG83frY4&auth_token=XXXXX&offset=0

Example response:

        {
    "reviews": [
        {
            "reviewer": "Tony Knight",
            "reviewer_avatar": "https://lh6.googleusercontent.com/-SMBSK9GwCTk/AAAAAAAAAAI/AAAAAAAAAAA/s5_YAby9ch0/c-rp-mo-br100/photo.jpg",
            "datetime": "2020-03-16T09:31:00Z",
            "rating": "5",
            "text": "",
            "language": "",
            "url": "https://www.google.com/maps/reviews/data=!4m5!14m4!1m3!1m2!1s100880773679684115250!2s0x0:0x8eaddfcd1b32ca52?hl=en-AR",
            "id": "10281119596374313554-1584340284.138"
        },
        {
            "reviewer": "Craig Sheppard",
            "reviewer_avatar": "https://lh3.googleusercontent.com/-qTzk1fmSWTc/AAAAAAAAAAI/AAAAAAAAAAA/h32TILCpf48/c-rp-mo-br100/photo.jpg",
            "datetime": "2020-03-16T03:00:00Z",
            "rating": "1",
            "text": "Charged me a product IV never heard of",
            "language": "en",
            "url": "https://www.google.com/maps/reviews/data=!4m5!14m4!1m3!1m2!1s102919687467559315236!2s0x0:0x8eaddfcd1b32ca52?hl=en-AR",
            "id": "10281119596374313554-1584316851.186"
        },
        {
            "reviewer": "Sabina Hrustanovic",
            "reviewer_avatar": "https://lh6.googleusercontent.com/-UyGkTl2rltQ/AAAAAAAAAAI/AAAAAAAAAAA/JBULt2aEn2A/c-rp-mo-br100/photo.jpg",
            "datetime": "2020-03-13T10:18:00Z",
            "rating": "5",
            "text": "Love google bought a new phone with the apps best thing ever",
            "language": "en",
            "url": "https://www.google.com/maps/reviews/data=!4m5!14m4!1m3!1m2!1s109592477876375771268!2s0x0:0x8eaddfcd1b32ca52?hl=en-AR",
            "id": "10281119596374313554-1584083886.173"
        },
        {
            "reviewer": "Hitesh Pathak",
            "reviewer_avatar": "https://lh5.googleusercontent.com/-a2F1Y_tHTu8/AAAAAAAAAAI/AAAAAAAAAAA/MCpTOhOK9Rk/c-rp-mo-br100/photo.jpg",
            "datetime": "2020-03-12T01:36:00Z",
            "rating": "1",
            "text": "Worst Search Engine... Worst than any other country. Seems like it doesnt understand what we are searching and just providing the random results based on Keywords. No adequate or relevant hits.",
            "language": "en",
            "url": "https://www.google.com/maps/reviews/data=!4m5!14m4!1m3!1m2!1s103404063004816104244!2s0x0:0x8eaddfcd1b32ca52?hl=en-AR",
            "id": "10281119596374313554-1583966216.119"
        },
        {
            "reviewer": "Sunny Virk",
            "reviewer_avatar": "https://lh5.googleusercontent.com/-yRcZyT77FCI/AAAAAAAAAAI/AAAAAAAAAAA/xLmTNhWOsi4/c-rp-mo-br100/photo.jpg",
            "datetime": "2020-03-09T02:07:00Z",
            "rating": "1",
            "text": "Bought a phone from Optus a year ago and was supposed to receive Google home hub in a month after that. It's been a year. Escalated the issue 4 times already last year. No progress. Pretty much like a scam. Trying to delay it longer and longer so I give up and forget about it. Not fair",
            "language": "en",
            "url": "https://www.google.com/maps/reviews/data=!4m5!14m4!1m3!1m2!1s115890488786066530401!2s0x0:0x8eaddfcd1b32ca52?hl=en-AR",
            "id": "10281119596374313554-1583708826.081"
        },
        {
            "reviewer": "Leonardo Ervilha",
            "reviewer_avatar": "https://lh5.googleusercontent.com/-Isr2CSVkmR0/AAAAAAAAAAI/AAAAAAAAAAA/G8rSeSHqb9o/c-rp-mo-br100/photo.jpg",
            "datetime": "2020-03-08T06:29:00Z",
            "rating": "5",
            "text": "Lugar lindo, pessoas cordialíssimas , inteligentes,  hoje eu orarei por todas as pessoas que trabalham neste lugar, que o Senhor Jesus as abençoe em tudo que fizerem e prosperem , que jamais se esqueçam das pessoas mais pobres. Obrigado.",
            "language": "pt",
            "url": "https://www.google.com/maps/reviews/data=!4m5!14m4!1m3!1m2!1s108149176090771611588!2s0x0:0x8eaddfcd1b32ca52?hl=en-AR",
            "id": "10281119596374313554-1583638153.665"
        },
        {
            "reviewer": "Michael Hanline",
            "reviewer_avatar": "https://lh6.googleusercontent.com/-u079RC8gujo/AAAAAAAAAAI/AAAAAAAAAAA/FwLOXoVQVDs/c-rp-mo-br100/photo.jpg",
            "datetime": "2020-03-08T04:12:00Z",
            "rating": "5",
            "text": "",
            "language": "",
            "url": "https://www.google.com/maps/reviews/data=!4m5!14m4!1m3!1m2!1s103616296654858112057!2s0x0:0x8eaddfcd1b32ca52?hl=en-AR",
            "id": "10281119596374313554-1583629943.714"
        },
        {
            "reviewer": "Dragan Zakic",
            "reviewer_avatar": "https://lh4.googleusercontent.com/-szV-4cc9IPc/AAAAAAAAAAI/AAAAAAAAAAA/0A80xI4ws2s/c-rp-mo-br100/photo.jpg",
            "datetime": "2020-03-05T23:12:00Z",
            "rating": "5",
            "text": "",
            "language": "",
            "url": "https://www.google.com/maps/reviews/data=!4m5!14m4!1m3!1m2!1s107280017656852167437!2s0x0:0x8eaddfcd1b32ca52?hl=en-AR",
            "id": "10281119596374313554-1583439174.713"
        },
        {
            "reviewer": "Lyle Burns",
            "reviewer_avatar": "https://lh4.googleusercontent.com/-tunMFCX_iV0/AAAAAAAAAAI/AAAAAAAAAAA/Dj7GaRUU4hY/c-rp-mo-br100/photo.jpg",
            "datetime": "2020-03-05T00:45:00Z",
            "rating": "1",
            "text": "As a business i wouldn't advertise with google again as Google allows fake and misleading reviews, without proof of purchase, wont remove fake reviews from business without having to take court action. I will never ever be paying any money to google for advertising again!!",
            "language": "en",
            "url": "https://www.google.com/maps/reviews/data=!4m5!14m4!1m3!1m2!1s103147639028349324375!2s0x0:0x8eaddfcd1b32ca52?hl=en-AR",
            "id": "10281119596374313554-1583358301.295"
        },
        {
            "reviewer": "Alan Dang",
            "reviewer_avatar": "https://lh6.googleusercontent.com/-Ghyf3H3EV2Y/AAAAAAAAAAI/AAAAAAAAAAA/0Sgib_cwp4c/c-rp-mo-br100/photo.jpg",
            "datetime": "2020-03-04T12:51:00Z",
            "rating": "5",
            "text": "Amazing atmosphere - surrounded by interlectual poeple",
            "language": "en",
            "url": "https://www.google.com/maps/reviews/data=!4m5!14m4!1m3!1m2!1s107431757257274822169!2s0x0:0x8eaddfcd1b32ca52?hl=en-AR",
            "id": "10281119596374313554-1583315514.033"
        }
    ]
  }
    

Frequently asked questions:

  • How do I get all the reviews for a single place?
  • You need to perform multiple requests incrementing the offset until you get a response without any reviews in it.

  • Does the API have rate limits?
  • Yes, since Google is pretty strict at blocking requests you will be rate limited if you perform more than one request per second.