> ## Documentation Index
> Fetch the complete documentation index at: https://v3.captaindata.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Extract Google Maps Reviews

> Extracts reviews from Google Places URLs

This API action allows you to extract reviews from Google Places URLs, providing detailed insights into customer feedback for various locations. It is particularly useful for businesses looking to analyze customer sentiment or gather feedback from multiple locations efficiently.

<Steps>
  <Step title="Step 1">
    Go to <a href="https://maps.google.com/">Google Maps</a>.
  </Step>

  <Step title="Step 2">
    Search for the property you want to extract reviews for, such as "Captain
    Data".
  </Step>

  <Step title="Step 3">
    Click on <code>Share</code> and copy the link provided.
  </Step>
</Steps>

### Inputs

<ParamField path="google_maps_place_url" type="string" required={true} primary={true}>
  The Google Maps Place URL from which reviews will be extracted.
</ParamField>

### Parameters

<ParamField path="max_results" type="number" default={100} initialValue={100}>
  The maximum number of reviews to extract for each input. The value can range
  from 0 to 10,000.
</ParamField>

<ParamField path="number_days" type="string">
  The maximum number of days since the reviews were published.
</ParamField>

<ParamField path="excluded_publishers" type="string">
  List of publishers to ignore, separated by semicolons.
</ParamField>

<ParamField path="get_share_link" type="checkbox" default={true}>
  Additional action to get the sharing link of the reviews collected.
</ParamField>

<ParamField path="country" type="string" default="US">
  The country you wish to search from, with options including US, FR, DE, ES,
  UK, BE, BR, IN, TH, CA, AU, IT.
</ParamField>

<ParamField path="language" type="string" default="en">
  The language you wish to search in, with options including English, French,
  Italian, German, Spanish, and Portuguese.
</ParamField>

<ParamField path="max_date" type="string">
  Earliest date to extract reviews from, formatted as YYYY/MM/DD.
</ParamField>

### Output Fields

The API returns a comprehensive set of fields for each review extracted:

<ResponseField>
  <Expandable title="properties">
    <ResponseField name="answer" type="string">
      The response to the review, if any.
    </ResponseField>

    <ResponseField name="answer_date" type="string">
      The date the response was made.
    </ResponseField>

    <ResponseField name="author_img" type="string">
      URL of the author's profile image.
    </ResponseField>

    <ResponseField name="author_name" type="string">
      Name of the review author.
    </ResponseField>

    <ResponseField name="author_reviews_count" type="integer">
      Number of reviews the author has made.
    </ResponseField>

    <ResponseField name="city" type="string">
      City where the review was made.
    </ResponseField>

    <ResponseField name="content" type="string">
      Content of the review.
    </ResponseField>

    <ResponseField name="experience_date" type="string">
      Date of the experience reviewed.
    </ResponseField>

    <ResponseField name="google_maps_place_url" type="string">
      The Google Maps Place URL.
    </ResponseField>

    <ResponseField name="google_maps_review_id" type="string">
      Unique identifier for the review.
    </ResponseField>

    <ResponseField name="google_maps_review_url" type="string">
      URL of the review on Google Maps.
    </ResponseField>

    <ResponseField name="grade" type="integer">
      Rating given in the review.
    </ResponseField>

    <ResponseField name="place_name" type="string">
      Name of the place reviewed.
    </ResponseField>

    <ResponseField name="review_date" type="string">
      Date the review was posted.
    </ResponseField>

    <ResponseField name="review_language" type="string">
      Language of the review.
    </ResponseField>

    <ResponseField name="source" type="string">
      Source of the review data.
    </ResponseField>

    <ResponseField name="standard_answer_date" type="string">
      Standardized format of the answer date.
    </ResponseField>

    <ResponseField name="standard_review_date" type="string">
      Standardized format of the review date.
    </ResponseField>

    <ResponseField name="translated_answer" type="string">
      Translated response to the review, if applicable.
    </ResponseField>

    <ResponseField name="translated_content" type="string">
      Translated content of the review, if applicable.
    </ResponseField>
  </Expandable>
</ResponseField>

Below is the JSON schema for the output fields:

<Accordion title="Show JSON Output Schema">
  ```json
  {
      "answer": "string",
      "answer_date": "string",
      "author_img": "string",
      "author_name": "string",
      "author_reviews_count": "integer",
      "city": "string",
      "content": "string",
      "experience_date": "string",
      "google_maps_place_url": "string",
      "google_maps_review_id": "string",
      "google_maps_review_url": "string",
      "grade": "integer",
      "place_name": "string",
      "review_date": "string",
      "review_language": "string",
      "source": "string",
      "standard_answer_date": "string",
      "standard_review_date": "string",
      "translated_answer": "string",
      "translated_content": "string"
  }
  ```
</Accordion>