# Get Results

Retrieve scraped data from Google Maps Reviews Scraper

Retrieve scraped data from your **Google Maps Reviews Scraper** runs.

## Headers
<ParamField header="Authorization" type="string" required>
  Your API authentication token. Value: `Token YOUR_API_KEY`
</ParamField>

## Query Parameters
<ParamField query="squid" type="string" required>
  Hash of the squid to get results from
</ParamField>

<ParamField query="run" type="string">
  Hash of a specific run (optional)
</ParamField>

<ParamField query="page" type="integer">
  Page number (default: 1). Example: `1`
</ParamField>

## Result Fields
Each result object contains the following fields:

<ResponseField name="cid" type="string">
  Google Maps unique numeric business identifier (CID). Example: `6617096495883696522`
</ResponseField>

<ResponseField name="zero_x" type="string">
  Internal Google Maps hex identifier for the reviewed business. Example: `0x0:0x5bd4a63441a1398a`
</ResponseField>

<ResponseField name="place_id" type="string">
  Google Places API unique identifier for the reviewed business. Example: `ChIJg4octORx5kcRijmhQTSm1Fs`
</ResponseField>

<ResponseField name="place_name" type="string">
  Name of the business or place being reviewed. Example: `La Rôtisserie d'Argent`
</ResponseField>

<ResponseField name="place_address" type="string">
  Full formatted address of the reviewed business. Example: `19 Quai de la Tournelle, 75005 Paris, France`
</ResponseField>

<ResponseField name="internal_review_id" type="string">
  Unique internal identifier for the Google Maps review. Example: `Ci9DQUlRQUNvZENodHljRjlvT2pnNVJFRnVlR0pFY2s5dFREUjBTa2hrT1hJeGRrRRAB`
</ResponseField>

<ResponseField name="user_name" type="string">
  Display name of the reviewer on Google Maps. Example: `za_zsc`
</ResponseField>

<ResponseField name="user_link" type="string">
  URL to the reviewer's Google Maps profile page. Example: `https://www.google.com/maps/contrib/103634612974133475591?hl=en`
</ResponseField>

<ResponseField name="user_internal_id" type="int">
  Internal Google identifier for the reviewer. Example: `103634612974133475591`
</ResponseField>

<ResponseField name="user_reviews_count" type="int">
  Total number of reviews the reviewer has posted on Google Maps. Example: `657`
</ResponseField>

<ResponseField name="user_image_url" type="string">
  URL of the reviewer's Google Maps profile picture. Example: `https://lh3.googleusercontent.com/a-/ALV-UjVQx5jp1mzVPivrjtNQVobRCTB5v_tmqt0NMCVRZfksPaFeaLf6`
</ResponseField>

<ResponseField name="is_user_local_guide" type="boolean">
  Whether the reviewer is a Google Maps Local Guide. Example: `true`
</ResponseField>

<ResponseField name="review_metadata" type="json">
  Additional metadata associated with the Google Maps review. Example: `{'Food': 5, 'Service': 5, 'Meal type': 'Dinner', 'Atmosphere': 5, 'Noise level': 'Quiet, easy to talk', 'Price per person': '€70–80'}`
</ResponseField>

<ResponseField name="score" type="int">
  Star rating given by the reviewer (1 to 5). Example: `5`
</ResponseField>

<ResponseField name="is_modified" type="boolean">
  Whether the review text has been edited after initial publication. Example: `false`
</ResponseField>

<ResponseField name="modified_at" type="string">
  Date the review was last modified. Example: `4 months ago`
</ResponseField>

<ResponseField name="modified_at_datetime" type="datetime">
  Date and time when the review was last modified in ISO 8601 format. Example: `2025-11-02T06:06:55+00:00`
</ResponseField>

<ResponseField name="published_at_datetime" type="datetime">
  Date and time when the review was first published in ISO 8601 format. Example: `2025-11-02T06:06:55+00:00`
</ResponseField>

<ResponseField name="review_link" type="string">
  Direct URL to the review on Google Maps. Example: `https://www.google.com/maps/reviews/data=!4m8!14m7!1m6!2m5!1sCi9DQUlRQUNvZENodHljRjlvT2pnNVJFRnVlR0pFY2s5dFREUjBTa2hrT1hJeGRrRRAB!2m1!1s0x0:0x5bd4a63441a1398a!3m1!1s2@1:CAIQACodChtycF9oOjg5REFueGJEck9tTDR0SkhkOXIxdkE%7C%7C?hl=en`
</ResponseField>

<ResponseField name="short_review_link" type="string">
  Shortened URL link to the review. Example: `https://maps.app.goo.gl/3e7En48M3z1wDMQW8`
</ResponseField>

<ResponseField name="text" type="text">
  Full text content of the review. Example: `Its recommended to book in advance to come in this restaurant. The food was unbelievably good! The chicken was amazing. Next time will look to order the duck`
</ResponseField>

<ResponseField name="original_text" type="text">
  Original review text before Google auto-translation. Example: `Its recommended to book in advance to come in this restaurant. The food was unbelievably good! The chicken was amazing. Next time will look to order the duck`
</ResponseField>

<ResponseField name="response_from_owner" type="text">
  Response from the business owner to the review. Example: `Dear Mrs, Dear Sir, We are delighted to hear that you enjoyed your meal with us, especially the chicken, it is always a crowd-pleaser. The duck is another fantastic choice, and we are sure you will love it just as much. Looking forward to welcoming you back soon! Kindest regards, The Tour d'Argent team.`
</ResponseField>

<ResponseField name="pictures" type="text">
  List of photo URLs attached to the review. Example: `https://lh3.googleusercontent.com/geougc-cs/ABOP9puZE5nDT2asJMyqaTPxHdssu43zbZ_VNmkxTL1JA0qycTf-ZTS2EFa3t8xzKr-XwOlVJYky3G5Rk7O-j1ggE8j12fGKCpNwBLnkknKKSh5KukPNCoepFdfhyYy3SaZlVS9dH75rUlGAt5NE, https://lh3.googleusercontent.com/geougc-cs/ABOP9ptbnmUW8D04kRcRbbvHKx0xxb0Dq8sXRWP-9BpVWTIALfm7Zc3I8HPpYwx_wOGzHfEo91USZgMW1mAjfY1lnPMPlVhaNHj75dgVovt_6P1HeUSM6V_D4EjF_LjUMosTQhknmRSJqnzgD4Cc`
</ResponseField>

<ResponseField name="visited_in" type="string">
  Time period the reviewer visited the place (e.g. month and year). Example: `2025-11-24T23:00:00+00:00`
</ResponseField>

<ResponseField name="total_likes" type="int">
  Number of users who found the review helpful (thumbs up). Example: `0`
</ResponseField>

<ResponseField name="lang" type="string">
  ISO language code of the review. Example: `en`
</ResponseField>

<ResponseField name="place_average_score" type="float">
  Average star rating for the reviewed business on Google Maps. Example: `4.5`
</ResponseField>

<ResponseField name="total_reviews" type="integer">
  Total number of reviews for the reviewed business on Google Maps. Example: `0`
</ResponseField>

<ResponseField name="origin" type="string">
  Country from which the review was posted. Example: `Google`
</ResponseField>

## Response

```json 200
{
  "total_results": 1,
  "limit": 50,
  "page": 1,
  "total_pages": 1,
  "result_from": 1,
  "result_to": 1,
  "data": [
    {
      "id": 55637,
      "object": "result",
      "squid": "07ef2fa1fd109d60c540e374b1de8605",
      "run": "434139cc133dd78f0e51862230b220ce",
      "cid": "6617096495883696522",
      "zero_x": "0x0:0x5bd4a63441a1398a",
      "place_id": "ChIJg4octORx5kcRijmhQTSm1Fs",
      "place_name": "La Rôtisserie d'Argent",
      "place_address": "19 Quai de la Tournelle, 75005 Paris, France",
      "internal_review_id": "Ci9DQUlRQUNvZENodHljRjlvT2pnNVJFRnVlR0pFY2s5dFREUjBTa2hrT1hJeGRrRRAB",
      "user_name": "za_zsc",
      "user_link": "https://www.google.com/maps/contrib/103634612974133475591?hl=en",
      "user_internal_id": 103634612974133475591,
      "user_reviews_count": 657,
      "user_image_url": "https://lh3.googleusercontent.com/a-/ALV-UjVQx5jp1mzVPivrjtNQVobRCTB5v_tmqt0NMCVRZfksPaFeaLf6",
      "is_user_local_guide": true,
      "review_metadata": {
        "Food": 5,
        "Service": 5,
        "Meal type": "Dinner",
        "Atmosphere": 5,
        "Noise level": "Quiet, easy to talk",
        "Price per person": "€70–80"
      },
      "score": 5,
      "is_modified": false,
      "modified_at": "4 months ago",
      "modified_at_datetime": "2025-11-02T06:06:55+00:00",
      "published_at_datetime": "2025-11-02T06:06:55+00:00",
      "review_link": "https://www.google.com/maps/reviews/data=!4m8!14m7!1m6!2m5!1sCi9DQUlRQUNvZENodHljRjlvT2pnNVJFRnVlR0pFY2s5dFREUjBTa2hrT1hJeGRrRRAB!2m1!1s0x0:0x5bd4a63441a1398a!3m1!1s2@1:CAIQACodChtycF9oOjg5REFueGJEck9tTDR0SkhkOXIxdkE%7C%7C?hl=en",
      "short_review_link": "https://maps.app.goo.gl/3e7En48M3z1wDMQW8",
      "text": "Its recommended to book in advance to come in this restaurant. The food was unbelievably good! The chicken was amazing. Next time will look to order the duck",
      "original_text": "Its recommended to book in advance to come in this restaurant. The food was unbelievably good! The chicken was amazing. Next time will look to order the duck",
      "response_from_owner": "Dear Mrs, Dear Sir, We are delighted to hear that you enjoyed your meal with us, especially the chicken, it is always a crowd-pleaser. The duck is another fantastic choice, and we are sure you will love it just as much. Looking forward to welcoming you back soon! Kindest regards, The Tour d'Argent team.",
      "pictures": "https://lh3.googleusercontent.com/geougc-cs/ABOP9puZE5nDT2asJMyqaTPxHdssu43zbZ_VNmkxTL1JA0qycTf-ZTS2EFa3t8xzKr-XwOlVJYky3G5Rk7O-j1ggE8j12fGKCpNwBLnkknKKSh5KukPNCoepFdfhyYy3SaZlVS9dH75rUlGAt5NE, https://lh3.googleusercontent.com/geougc-cs/ABOP9ptbnmUW8D04kRcRbbvHKx0xxb0Dq8sXRWP-9BpVWTIALfm7Zc3I8HPpYwx_wOGzHfEo91USZgMW1mAjfY1lnPMPlVhaNHj75dgVovt_6P1HeUSM6V_D4EjF_LjUMosTQhknmRSJqnzgD4Cc",
      "visited_in": "2025-11-24T23:00:00+00:00",
      "total_likes": 0,
      "lang": "en",
      "place_average_score": 4.5,
      "total_reviews": 0,
      "origin": "Google",
      "functions": null,
      "native_id": 55637
    }
  ],
  "next": null,
  "previous": null
}
```
