> ## 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 TripAdvisor Reviews

> Collect customer reviews from companies listed on TripAdvisor.

The "Extract TripAdvisor Reviews" action allows you to gather customer feedback from various businesses listed on TripAdvisor, including restaurants, attractions, and hotels. This can be particularly useful for businesses looking to analyze customer sentiment or for researchers studying consumer behavior.

### Inputs

<ParamField path="tripadvisor_reviews_url" type="string" required={true} primary={true}>
  Input only compatible with URLs of types Restaurant, Attraction, and Hotel.
</ParamField>

### Parameters

<ParamField path="end_date" type="string" default="">
  If you want to collect no reviews older than the given date per property.
</ParamField>

<ParamField path="max_number_items" type="string" default="">
  Maximum number of items collected per property.
</ParamField>

<ParamField path="number_days" type="string" default="">
  Collect the reviews of the past x days.
</ParamField>

<ParamField path="language" type="string" default="all" required={true}>
  The language in which you want to extract reviews. Options include French, English, Italian, Russian, German, and All.
</ParamField>

### Output Fields

The output of this action includes a comprehensive set of fields that provide detailed information about each review.

<ResponseField>
  <Expandable title="properties">
    <ResponseField name="experience_date" type="string">The date of the experience reviewed.</ResponseField>
    <ResponseField name="property" type="string">The name of the property reviewed.</ResponseField>
    <ResponseField name="review_comment" type="string">The comment left by the reviewer.</ResponseField>
    <ResponseField name="review_date" type="string">The date the review was posted.</ResponseField>
    <ResponseField name="review_images" type="array">Images associated with the review.</ResponseField>
    <ResponseField name="review_rating" type="integer">The rating given by the reviewer.</ResponseField>
    <ResponseField name="review_response" type="string">The response from the property to the review.</ResponseField>
    <ResponseField name="review_title" type="string">The title of the review.</ResponseField>
    <ResponseField name="reviewer_name" type="string">The name of the reviewer.</ResponseField>
    <ResponseField name="reviewer_picture" type="string">The picture of the reviewer.</ResponseField>
    <ResponseField name="tripadvisor_review_id" type="string">The unique ID of the review on TripAdvisor.</ResponseField>
    <ResponseField name="tripadvisor_review_url" type="string">The URL of the review on TripAdvisor.</ResponseField>
    <ResponseField name="tripadvisor_reviewer_url" type="string">The URL of the reviewer's profile on TripAdvisor.</ResponseField>
    <ResponseField name="tripadvisor_reviews_id" type="string">The unique ID of the reviews collection.</ResponseField>
    <ResponseField name="tripadvisor_reviews_url" type="string">The URL of the reviews collection on TripAdvisor.</ResponseField>
  </Expandable>
</ResponseField>

Below is the JSON schema for the output fields:

<Accordion title="Show JSON Output Schema">
  ```json
  {
      "experience_date": "string",
      "property": "string",
      "review_comment": "string",
      "review_date": "string",
      "review_images": "array",
      "review_rating": "integer",
      "review_response": "string",
      "review_title": "string",
      "reviewer_name": "string",
      "reviewer_picture": "string",
      "tripadvisor_review_id": "string",
      "tripadvisor_review_url": "string",
      "tripadvisor_reviewer_url": "string",
      "tripadvisor_reviews_id": "string",
      "tripadvisor_reviews_url": "string"
  }
  ```
</Accordion>

This action provides a structured way to extract and analyze customer reviews, offering valuable insights into customer experiences and satisfaction.