Google Maps Reviews API

Overview

This API endpoint allows you to retrieve reviews from Google Maps. Here are some important things to know:

  • 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.

Endpoint

GET https://wextractor.com/api/v1/reviews/google

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 Request

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

Example Response


{
  "place_details": {
    "address": "48 Pirrama Rd, Pyrmont NSW 2009, Australia",
    "name": "Google en Sydney"
  },
  "totals": {
    "review_count": 931,
    "average_rating": "4.1"
  },
  "reviews": [
    {
      "url": "https://www.google.com/maps/reviews/data=!4m5!14m4!1m3!1m2!1s107407043277427660968!2s0x0:0x8eaddfcd1b32ca52?hl=en-AR",
      "reviewer": "Sandeep Kumar",
      "reviewer_avatar": "https://lh3.googleusercontent.com/a/AATXAJyT5T4tb35KOrXhZ7YrihVU9DzpeawhQZN6PMN0=s120-c-c0x00000000-cc-rp-mo-br100",
      "reviewer_id": "107407043277427660968",
      "reviewer_url": "https://www.google.com/maps/contrib/107407043277427660968",
      "datetime": "2021-07-03T11:32:00Z",
      "rating": "1",
      "text": "Very poor service",
      "language": "en",
      "id": "10281119596374313554-1625301150.432",
      "likes": 0
    },
    {
      "url": "https://www.google.com/maps/reviews/data=!4m5!14m4!1m3!1m2!1s101800777196227152928!2s0x0:0x8eaddfcd1b32ca52?hl=en-AR",
      "reviewer": "Terry McCormick",
      "reviewer_avatar": "https://lh3.googleusercontent.com/a/AATXAJwbeBPwWFnLnCAI3wSvT91r_BBxmYmdUeGVOMTK=s120-c-c0x00000000-cc-rp-mo-br100",
      "reviewer_id": "101800777196227152928",
      "reviewer_url": "https://www.google.com/maps/contrib/101800777196227152928",
      "datetime": "2021-06-24T00:08:00Z",
      "rating": "1",
      "text": "the customer support is very poor, they don't respond appropriately",
      "language": "en",
      "id": "10281119596374313554-1624482539.952",
      "likes": 0
    },
    {
      "url": "https://www.google.com/maps/reviews/data=!4m5!14m4!1m3!1m2!1s115242088921235833352!2s0x0:0x8eaddfcd1b32ca52?hl=en-AR",
      "reviewer": "Ashley Parmenter",
      "reviewer_avatar": "https://lh3.googleusercontent.com/a/AATXAJytK532Zs1pPvOA6n4-paJ4WQ-6TbNXvABKhS_A=s120-c-c0x00000000-cc-rp-mo-br100",
      "reviewer_id": "115242088921235833352",
      "reviewer_url": "https://www.google.com/maps/contrib/115242088921235833352",
      "datetime": "2021-06-01T07:25:00Z",
      "rating": "1",
      "text": "",
      "language": "",
      "id": "10281119596374313554-1622521503.498",
      "likes": 0
    },
    {
      "url": "https://www.google.com/maps/reviews/data=!4m5!14m4!1m3!1m2!1s109715086680233936716!2s0x0:0x8eaddfcd1b32ca52?hl=en-AR",
      "reviewer": "Tim Hosking",
      "reviewer_avatar": "https://lh3.googleusercontent.com/a-/AOh14GjbBkM0Yd1E04USqcL4AH6MFvX3Htf9RvHgrjSAWA=s120-c-c0x00000000-cc-rp-mo-ba2-br100",
      "reviewer_id": "109715086680233936716",
      "reviewer_url": "https://www.google.com/maps/contrib/109715086680233936716",
      "datetime": "2021-05-31T10:49:00Z",
      "rating": "5",
      "text": "",
      "language": "",
      "id": "10281119596374313554-1622447384.545",
      "likes": 0
    },
    {
      "url": "https://www.google.com/maps/reviews/data=!4m5!14m4!1m3!1m2!1s105492875203020355828!2s0x0:0x8eaddfcd1b32ca52?hl=en-AR",
      "reviewer": "Measure Me L-if-E",
      "reviewer_avatar": "https://lh3.googleusercontent.com/a-/AOh14Gj6wPbE0gRhIVHDLB7zpGsxJC7rNLOSjIEfPCZ34w=s120-c-c0x00000000-cc-rp-mo-br100",
      "reviewer_id": "105492875203020355828",
      "reviewer_url": "https://www.google.com/maps/contrib/105492875203020355828",
      "datetime": "2021-05-25T16:08:00Z",
      "rating": "5",
      "text": "",
      "language": "",
      "id": "10281119596374313554-1621948084.853",
      "likes": 0
    },
    {
      "url": "https://www.google.com/maps/reviews/data=!4m5!14m4!1m3!1m2!1s100115398990005037658!2s0x0:0x8eaddfcd1b32ca52?hl=en-AR",
      "reviewer": "Madhav Prasanna",
      "reviewer_avatar": "https://lh3.googleusercontent.com/a-/AOh14Gjk56PnToxvpfS2smqmy0h7VYskoNe1DffybottIOQ=s120-c-c0x00000000-cc-rp-mo-br100",
      "reviewer_id": "100115398990005037658",
      "reviewer_url": "https://www.google.com/maps/contrib/100115398990005037658",
      "datetime": "2021-05-19T11:17:00Z",
      "rating": "5",
      "text": "",
      "language": "",
      "id": "10281119596374313554-1621412259.144",
      "likes": 0
    },
    {
      "url": "https://www.google.com/maps/reviews/data=!4m5!14m4!1m3!1m2!1s101119358587263189425!2s0x0:0x8eaddfcd1b32ca52?hl=en-AR",
      "reviewer": "Pandya Vivek",
      "reviewer_avatar": "https://lh3.googleusercontent.com/a/AATXAJxW0KVclOGwWA-zIKGCpMTXsGfRTeou4tIIGzD0=s120-c-c0x00000000-cc-rp-mo-ba3-br100",
      "reviewer_id": "101119358587263189425",
      "reviewer_url": "https://www.google.com/maps/contrib/101119358587263189425",
      "datetime": "2021-05-14T06:58:00Z",
      "rating": "5",
      "text": "",
      "language": "",
      "id": "10281119596374313554-1620964709.105",
      "likes": 0
    },
    {
      "url": "https://www.google.com/maps/reviews/data=!4m5!14m4!1m3!1m2!1s116666564799967580279!2s0x0:0x8eaddfcd1b32ca52?hl=en-AR",
      "reviewer": "Stephen Claxton",
      "reviewer_avatar": "https://lh3.googleusercontent.com/a/AATXAJzkBrkzRNaPulwpC1rEyIB1anyryKpMTDH-guU7=s120-c-c0x00000000-cc-rp-mo-br100",
      "reviewer_id": "116666564799967580279",
      "reviewer_url": "https://www.google.com/maps/contrib/116666564799967580279",
      "datetime": "2021-04-27T13:31:00Z",
      "rating": "5",
      "text": "",
      "language": "",
      "id": "10281119596374313554-1619519510.5",
      "likes": 0
    },
    {
      "url": "https://www.google.com/maps/reviews/data=!4m5!14m4!1m3!1m2!1s104602961630797902494!2s0x0:0x8eaddfcd1b32ca52?hl=en-AR",
      "reviewer": "Xavier Le Baron",
      "reviewer_avatar": "https://lh3.googleusercontent.com/a-/AOh14GhbuCpv4_XNH8EWPZoGFwgWjiCQvCcVYiwJNxnMIPs=s120-c-c0x00000000-cc-rp-mo-ba4-br100",
      "reviewer_id": "104602961630797902494",
      "reviewer_url": "https://www.google.com/maps/contrib/104602961630797902494",
      "datetime": "2021-04-14T11:14:00Z",
      "rating": "5",
      "text": "Possibly the best office in Sydney? :)\nWhat an amazing place to work at!",
      "language": "en",
      "id": "10281119596374313554-1618388082.953",
      "likes": 2
    },
    {
      "url": "https://www.google.com/maps/reviews/data=!4m5!14m4!1m3!1m2!1s110213462243737996659!2s0x0:0x8eaddfcd1b32ca52?hl=en-AR",
      "reviewer": "namfon wongseeda",
      "reviewer_avatar": "https://lh3.googleusercontent.com/a-/AOh14Gjja0lbhJwULmnjyNzFW06MD2vb55gLuhowylHTe0E=s120-c-c0x00000000-cc-rp-mo-br100",
      "reviewer_id": "110213462243737996659",
      "reviewer_url": "https://www.google.com/maps/contrib/110213462243737996659",
      "datetime": "2021-04-08T09:25:00Z",
      "rating": "3",
      "text": "",
      "language": "",
      "id": "10281119596374313554-1617863129.762",
      "likes": 0
    }
  ]
}

Error Codes

Status Code Error Type Description
400 InvalidRequest The request parameters are invalid or missing
401 Unauthorized Invalid or missing API key
403 Forbidden Your account is out of credits
429 RateLimitExceeded You've exceeded the API rate limit(10 requests per second)
500 ServerError An unexpected error occurred on our servers. In these cases we recommend to retry the request for a couple of times. If the error subsists you can reach us to open a ticket.