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

# Realtor.com Reviews

> This endpoint fetches reviews and recommendations from Realtor.com for a given agent profile.



## OpenAPI

````yaml POST /realtor-com/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:
  /realtor-com/reviews:
    post:
      description: >-
        This endpoint fetches reviews and recommendations from Realtor.com for a
        given agent profile.
      requestBody:
        description: Realtor.com review scraping parameters
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/RealtorComReviewsRequest'
        required: true
      responses:
        '200':
          description: Reviews fetched successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RealtorComReviewsResponse'
              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:
    RealtorComReviewsRequest:
      type: object
      required:
        - query
      properties:
        query:
          type: string
          description: Provide proper agent profile url or agent_slug.
        reviews_to_fetch:
          type: number
          description: >-
            Number of reviews to fetch (default: all reviews, or within
            30-second timeout)
        pagination_token:
          type: string
          description: >-
            The next page index for fetching paginated reviews, from previous
            API response
        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'
    RealtorComReviewsResponse:
      type: object
      properties:
        all_reviews:
          type: array
          description: Array of fetched reviews
          items:
            type: object
            properties:
              author_details:
                type: object
                description: Details about the review author
                properties:
                  author_location:
                    type:
                      - string
                      - 'null'
                    description: Location of the review author
                  author_name:
                    type: string
                    description: Name of the review author
                  author_profile:
                    type: string
                    description: Profile type of the author (e.g., BUYER, SELLER)
              link:
                type:
                  - string
                  - 'null'
                description: Link to the review, if available
              query:
                type: string
                description: Original query URL
              rating_category:
                type: object
                description: Detailed rating categories
                properties:
                  market_expertise:
                    type: number
                    description: Rating for market expertise
                  negotiation_skills:
                    type: number
                    description: Rating for negotiation skills
                  professionalism_communication:
                    type: number
                    description: Rating for professionalism and communication
                  responsiveness:
                    type: number
                    description: Rating for responsiveness
              review_date:
                type: string
                description: Date when the review was posted
              review_id:
                type: string
                description: ID of the review
              review_rating:
                type: number
                description: Overall rating given in the review
              review_source:
                type: string
                description: Source of the review
              review_text:
                type: string
                description: Content of the review
              review_year:
                type: string
                description: Year of the transaction
              started_timestamp:
                type: string
                description: Timestamp when the review was started
              trixel_url:
                type:
                  - string
                  - 'null'
                description: URL to the trixel, if available
        all_recommendation:
          type: array
          description: Array of fetched recommendations
          items:
            type: object
            properties:
              author_details:
                type: object
                description: Details about the recommendation author
                properties:
                  author_address:
                    type:
                      - string
                      - 'null'
                    description: Address of the recommendation author
                  author_location:
                    type:
                      - string
                      - 'null'
                    description: Location of the recommendation author
                  author_name:
                    type: string
                    description: Name of the recommendation author
                  author_relation:
                    type: string
                    description: Relation of the author to the agent
              query:
                type: string
                description: Original query URL
              recommendation_date:
                type: string
                description: Date when the recommendation was posted
              recommendation_id:
                type: string
                description: ID of the recommendation
              recommendation_photo_url:
                type:
                  - string
                  - 'null'
                description: URL to the recommendation photo, if available
              recommendation_source:
                type: string
                description: Source of the recommendation
              recommendation_text:
                type: string
                description: Content of the recommendation
              recommendation_video_url:
                type:
                  - string
                  - 'null'
                description: URL to the recommendation video, if available
              recommendation_year:
                type: string
                description: Year of the recommendation
              started_timestamp:
                type: string
                description: Timestamp when the recommendation was started
        extra_information:
          type: object
          properties:
            extra_information:
              type: array
              description: Additional metadata about the product and launch
              items:
                type: object
            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

````