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

# Appsumo questions Reviews

> This endpoint is used to fetch reviews from appsumo-question for a specified business.



## OpenAPI

````yaml POST /appsumo-questions/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:
  /appsumo-questions/reviews:
    post:
      description: >-
        This endpoint is used to fetch reviews from appsumo-question for a
        specified business.
      requestBody:
        description: appsumo-question review scraping parameters
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AppsumoQuestionsReviewsRequest'
        required: true
      responses:
        '200':
          description: Reviews fetched successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AppsumoQuestionsReviewsResponse'
              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:
    AppsumoQuestionsReviewsRequest:
      type: object
      required:
        - query
      properties:
        query:
          type: string
          description: Provide proper Appsumo question url or give a product slug
        reviews_to_fetch:
          type: number
          description: >-
            Number of reviews to fetch (default: all reviews, or within
            30-second timeout)
        sort_type:
          type: string
          description: Order in which reviews should be sorted
          enum:
            - newest
            - oldest
            - latest_reply
            - helpful
          default: latest_reply
        pagination_token:
          type: string
          description: >-
            The next_page received with the past request, which is required for
            the pagination
        is_text_formatted:
          type: boolean
          description: 'returns the review text with visual formatting preserved '
        sync_date:
          type: string
          description: 'Fetches reviews posted on a specific date using format: YYYY-MM-DD'
    AppsumoQuestionsReviewsResponse:
      type: object
      properties:
        all_reviews:
          type: array
          description: Array of fetched questions/reviews
          items:
            type: object
            properties:
              author_id:
                type: integer
                description: Unique identifier for the author
              author_name:
                type: string
                description: Username/display name of the author
              author_profile_image_url:
                type: string
                description: URL to the author's profile image
              author_profile_image_url_org:
                type: string
                description: URL to the author's HD profile image
              comment_blacklist:
                type: boolean
                description: Whether the author is blacklisted from commenting
              comment_whitelist:
                type: boolean
                description: Whether the author is whitelisted for commenting
              date_joined:
                type: string
                description: Date when the author joined the platform
              deals_purchased:
                type: integer
                description: Number of deals purchased by the author
              has_briefcase:
                type:
                  - boolean
                  - 'null'
                description: Whether the author has briefcase status
              has_plus:
                type:
                  - boolean
                  - 'null'
                description: Whether the author has AppSumo Plus membership
              helpful_vote_counts:
                type: integer
                description: Number of helpful votes received by the author
              query:
                type: string
                description: Original query URL
              review_date:
                type: string
                description: Date when the question/review was posted
              review_id:
                type: integer
                description: Unique identifier for the question/review
              review_rating:
                type:
                  - integer
                  - 'null'
                description: Rating given (if applicable)
              review_reply_data:
                type: array
                description: Array of replies to the question/review
                items:
                  type: object
                  properties:
                    answer_type:
                      type:
                        - string
                        - 'null'
                      description: Type of answer if applicable
                    approved:
                      type: boolean
                      description: Whether the reply is approved
                    children:
                      type: array
                      description: Array of child replies
                      items:
                        type: object
                    comment:
                      type: string
                      description: Content of the reply
                    created:
                      type: string
                      description: Date and time when the reply was created
                    deal_id:
                      type: integer
                      description: ID of the associated deal
                    display_path:
                      type: string
                      description: URL path for displaying the reply
                    down_votes:
                      type: integer
                      description: Number of down votes received
                    edited:
                      type: boolean
                      description: Whether the reply has been edited
                    followup:
                      type: boolean
                      description: Whether this is a followup reply
                    id:
                      type: integer
                      description: Unique identifier for the reply
                    level:
                      type: integer
                      description: Nesting level of the reply
                    modified:
                      type: string
                      description: Date and time when the reply was last modified
                    parent_id:
                      type: integer
                      description: ID of the parent question/review
                    pinned:
                      type:
                        - boolean
                        - 'null'
                      description: Whether the reply is pinned
                    purchased:
                      type: boolean
                      description: Whether the reply author has purchased the deal
                    resolved:
                      type: boolean
                      description: Whether the reply marks the question as resolved
                    search_after:
                      type:
                        - string
                        - 'null'
                      description: Search pagination parameter
                    status:
                      type: string
                      description: Status of the reply (Approved, Pending, etc.)
                    title:
                      type:
                        - string
                        - 'null'
                      description: Title of the reply if applicable
                    up_votes:
                      type: integer
                      description: Number of up votes received
                    user:
                      type: object
                      description: User information for the reply author
                      properties:
                        avatar:
                          type: string
                          description: URL to the user's avatar
                        comment_blacklist:
                          type: boolean
                          description: Whether the user is blacklisted from commenting
                        comment_whitelist:
                          type: boolean
                          description: Whether the user is whitelisted for commenting
                        date_joined:
                          type: string
                          description: Date when the user joined
                        deals_purchased:
                          type: integer
                          description: Number of deals purchased by the user
                        has_briefcase:
                          type:
                            - boolean
                            - 'null'
                          description: Whether the user has briefcase status
                        has_plus:
                          type:
                            - boolean
                            - 'null'
                          description: Whether the user has AppSumo Plus membership
                        id:
                          type: integer
                          description: Unique identifier for the user
                        username:
                          type: string
                          description: Username of the user
                    user_id:
                      type: integer
                      description: ID of the reply author
                    user_vote:
                      type:
                        - string
                        - 'null'
                      description: Current user's vote on this reply
              review_text:
                type: string
                description: Full text content of the question/review
              review_timestamp:
                type: string
                description: ISO timestamp of when the question/review was posted
              review_title:
                type: string
                description: Title of the question/review
              review_url:
                type: string
                description: URL to the question/review page
              unhelpful_vote_counts:
                type: integer
                description: Number of unhelpful votes received
        extra_information:
          type: object
          properties:
            extra_information:
              type: object
              description: Additional metadata about the reviews
            total_review_count:
              type: integer
              description: Total number of reviews fetched
            total_review_count_list:
              type: array
              items:
                type: integer
              description: List of review counts
        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

````