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

# Twitter Post

> This endpoint is used to fetch reviews from twitter for a specified business.



## OpenAPI

````yaml POST /twitter/post
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:
  /twitter/post:
    post:
      description: >-
        This endpoint is used to fetch reviews from twitter for a specified
        business.
      requestBody:
        description: twitter review scraping parameters
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/TwitterPostRequest'
        required: true
      responses:
        '200':
          description: Post fetched successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TwitterPostResponse'
              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:
    TwitterPostRequest:
      type: object
      required:
        - query
      properties:
        query:
          type: string
          description: Please Provide proper Twitter page URL
        is_text_formatted:
          type: boolean
          description: 'returns the review text with visual formatting preserved '
    TwitterPostResponse:
      type: object
      properties:
        all_reviews:
          type: array
          description: Array of fetched posts from Twitter
          items:
            type: object
            properties:
              author_name:
                type: string
                description: Display name of the post author
              author_profile_image_url:
                type: string
                description: URL of the author's HD profile image
              author_profile_image_url_org:
                type: string
                description: URL of the author's profile image
              author_profile_url:
                type: string
                description: URL of the author's Twitter profile
              author_user_id:
                type: string
                description: Twitter username/handle of the author
              is_verified_account:
                type: boolean
                description: Whether the account is verified
              links_in_tweet:
                type: object
                description: >-
                  Object containing links mentioned in the tweet with their
                  display text as keys and actual URLs as values
              query:
                type: string
                description: Original query URL used to fetch the post
              review_date:
                type: string
                description: Date when the post was published
                format: date-time
              review_image_urls:
                type: array
                description: Array of image URLs from the post
                items:
                  type: string
              review_statistics:
                type: object
                description: Engagement statistics for the post
                properties:
                  bookmarks:
                    type: integer
                    description: Number of bookmarks
                  comments:
                    type: integer
                    description: Number of comments
                  likes:
                    type: integer
                    description: Number of likes
                  reposts:
                    type: integer
                    description: Number of reposts/retweets
                  views:
                    type: integer
                    description: Number of views
              review_text:
                type: string
                description: HTML content of the tweet
              review_time_stamp:
                type: string
                description: ISO timestamp of when the post was published
              review_url:
                type: string
                description: Direct URL to the tweet
              review_video_urls:
                type: array
                description: Array of video URLs from the post
                items:
                  type: string
    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

````