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

# Trip Reviews

> This endpoint fetches reviews from Trip attractions, things-to-do, or cruises pages.



## OpenAPI

````yaml POST /trip/reviews
openapi: 3.1.0
info:
  title: OpenAPI Plant Store
  description: >-
    A sample API that uses a plant store as an example to demonstrate features
    in the OpenAPI specification
  license:
    name: MIT
  version: 1.0.0
servers:
  - url: https://api.hobbo.ai
    description: Main API server
  - url: https://py-api.hobbo.ai
    description: Python API server for scraper endpoints
security:
  - ApiKeyAuth: []
paths:
  /trip/reviews:
    post:
      description: >-
        This endpoint fetches reviews from Trip attractions, things-to-do, or
        cruises pages.
      requestBody:
        description: Trip review scraping parameters
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/TripReviewsRequest'
        required: true
      responses:
        '200':
          description: Reviews fetched successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TripReviewsResponse'
              examples:
                validationError:
                  value:
                    all_reviews: []
                    extra_information: {}
                    message: <string>
        '400':
          description: Validation error or unexpected error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                validationError:
                  value:
                    error: <string>
      servers:
        - url: https://py-api.hobbo.ai
components:
  schemas:
    TripReviewsRequest:
      type: object
      required:
        - query
      properties:
        query:
          type: string
          description: Provide the Trip attractions, things-to-do, or cruises page URL.
        reviews_to_fetch:
          type:
            - number
            - 'null'
          description: >-
            Number of reviews to fetch (default: all reviews, or within
            30-second timeout).
        sort_type:
          type:
            - string
            - 'null'
          enum:
            - recommended
            - latest
          default: recommended
          description: Order in which reviews should be sorted.
        is_text_formatted:
          type: boolean
          description: Returns the review text with visual formatting preserved.
          default: true
        sync_date:
          type:
            - string
            - 'null'
          description: 'Fetches reviews posted on a specific date using format: YYYY-MM-DD.'
        pagination_data:
          type:
            - object
            - 'null'
          description: Pagination metadata returned by previous Trip responses.
    TripReviewsResponse:
      type: object
      properties:
        all_reviews:
          type: array
          description: Array of fetched reviews
          items:
            type: object
            properties:
              query:
                type:
                  - string
                  - 'null'
                description: Original query URL
              review_text:
                type:
                  - string
                  - 'null'
                description: Content of the review
              author_name:
                type:
                  - string
                  - 'null'
                description: Name of the review author
              author_profile_url:
                type:
                  - string
                  - 'null'
                description: URL to the author's Trip profile
              author_profile_image_url:
                type:
                  - string
                  - 'null'
                description: Profile image URL of the author
              author_profile_image_url_org:
                type:
                  - string
                  - 'null'
                description: Original/high-resolution profile image URL
              author_has_voted:
                type:
                  - boolean
                  - 'null'
                description: Whether the author has voted on the review
              review_id:
                type:
                  - string
                  - 'null'
                description: Identifier of the review
              review_date:
                type:
                  - string
                  - 'null'
                description: Date when the review was posted
              review_rating:
                type:
                  - number
                  - 'null'
                description: Rating given in the review
              rating_text:
                type:
                  - string
                  - 'null'
                description: Rating label shown on Trip
              review_link:
                type:
                  - string
                  - 'null'
                description: Direct link to the review
              travel_type:
                type:
                  - string
                  - 'null'
                description: Travel type associated with the review
              review_language:
                type:
                  - string
                  - 'null'
                description: Original language of the review
              review_translate_language:
                type:
                  - string
                  - 'null'
                description: Language into which the review was translated
              original_review_text:
                type:
                  - string
                  - 'null'
                description: Original review text with formatting
              review_media:
                type:
                  - array
                  - 'null'
                description: Media items attached to the review
                items:
                  type: object
                  properties:
                    media_type:
                      type:
                        - string
                        - 'null'
                      description: Type of media (image/video)
                    media_url:
                      type:
                        - string
                        - 'null'
                      description: Display URL for the media
                    media_url_org:
                      type:
                        - string
                        - 'null'
                      description: Original media URL if available
              review_state:
                type:
                  - string
                  - 'null'
                description: State or status of the review
              departed_date:
                type:
                  - string
                  - 'null'
                description: Departure date mentioned in the review
              is_owner:
                type:
                  - boolean
                  - 'null'
                description: Whether the reviewer is the owner
              helpful_vote_count:
                type:
                  - number
                  - 'null'
                description: Helpful vote count
              review_source:
                type:
                  - string
                  - 'null'
                description: Source label for the review
              is_verified:
                type:
                  - string
                  - 'null'
                description: Verification badge/tag
        extra_information:
          type: object
          properties:
            extra_information:
              type: object
              description: Additional metadata about the Trip profile
            total_review_count:
              type:
                - integer
                - 'null'
              description: Total number of reviews fetched
            total_review_count_list:
              type:
                - array
                - 'null'
              items:
                type: integer
              description: List of review counts per page
        message:
          type: string
          description: Status message about the review extraction
    Error:
      type: object
      properties:
        status:
          type: integer
          description: HTTP status code
        data:
          type: object
          description: Empty object or additional error data
        success:
          type: boolean
          description: Indicates operation failed
          example: false
        message:
          type: string
          description: Error message describing what went wrong

````