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

# Freelancer Reviews

> This endpoint is used to fetch reviews for a specific testimonial wall of love, identified by its query name.



## OpenAPI

````yaml POST /freelancer/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:
  /freelancer/reviews:
    post:
      description: >-
        This endpoint is used to fetch reviews for a specific testimonial wall
        of love, identified by its query name.
      requestBody:
        description: Freelancer review scraping parameters
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/FreelancerReviewsRequest'
        required: true
      responses:
        '200':
          description: Reviews fetched successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FreelancerReviewsResponse'
              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:
    FreelancerReviewsRequest:
      type: object
      required:
        - query
      properties:
        query:
          type: string
          description: Provide proper  Freelancer Review url or provide user_id
        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:
            - submit_date_desc
            - submit_date_asc
            - rating_desc
            - rating_asc
            - price_usd_desc
          default: submit_date_desc
        review_unique_id:
          type: string
          description: >-
            The hash ID of the last review up to which you want to fetch the
            reviews is used in automated fetching
        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'
    FreelancerReviewsResponse:
      type: object
      properties:
        all_reviews:
          type: array
          description: Array of fetched reviews
          items:
            type: object
            properties:
              author_id:
                type: integer
                description: ID of the review author
              bid_amount:
                type: number
                description: Bid amount for the project
              category_rating:
                type: object
                description: Detailed ratings by category
                properties:
                  communication:
                    type: number
                    description: Rating for communication (1-5)
                  expertise:
                    type: number
                    description: Rating for expertise (1-5)
                  hire_again:
                    type: number
                    description: Rating for likelihood to hire again (1-5)
                  professionalism:
                    type: number
                    description: Rating for professionalism (1-5)
                  quality:
                    type: number
                    description: Rating for quality (1-5)
              currency_code:
                type: string
                description: Currency code (e.g., USD)
              currency_country:
                type: string
                description: Country code for the currency
              currency_id:
                type: integer
                description: ID of the currency
              currency_name:
                type: string
                description: Full name of the currency
              currency_symbol:
                type: string
                description: Symbol of the currency
              featured:
                type: boolean
                description: Whether the review is featured
              paid_amount:
                type: number
                description: Amount paid for the project
              price_usd:
                type: number
                description: Price in USD
              project_id:
                type: integer
                description: ID of the project
              query:
                type: string
                description: Original query URL
              recipient_closed:
                type: boolean
                description: Whether the recipient account is closed
              recipient_suspended:
                type: boolean
                description: Whether the recipient account is suspended
              review_date:
                type: string
                description: Date when the review was posted
              review_id:
                type: integer
                description: ID of the review
              review_project_status:
                type: string
                description: Status of the project (e.g., 'complete')
              review_rating:
                type: number
                description: Overall rating given in the review (1-5)
              review_text:
                type: string
                description: Content of the review
              review_title:
                type: string
                description: Title of the review or project
              review_type:
                type: string
                description: Type of review (e.g., 'project')
              review_unique_id:
                type: string
                description: Unique identifier for the review
              review_url:
                type: string
                description: URL to the review
              role:
                type: string
                description: Role of the reviewer (e.g., 'freelancer')
              sealed:
                type: boolean
                description: Whether the review is sealed
              seo url:
                type: array
                description: SEO URL components
                items:
                  type: string
              status:
                type: string
                description: Status of the review
              user_id:
                type: integer
                description: ID of the user
              author_name:
                type: string
                description: Last name of the author
              author_country:
                type: string
                description: Country of the review author
              author_city:
                type: string
                description: City of the review author
              author_position:
                type: string
                description: Position of the review author
              author_company:
                type: string
                description: Company of the review author
              auhtor_profile_url:
                type: string
                description: URL of the author's profile page
              auhtor_profile_image_url:
                type: string
                description: URL of the author's profile image
        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

````