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

# SoundCloud Audio

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



## OpenAPI

````yaml POST /soundcloud/audio
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:
  /soundcloud/audio:
    post:
      description: >-
        This endpoint is used to fetch reviews from soundcloud for a specified
        business.
      requestBody:
        description: soundcloud review scraping parameters
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SoundCloudAudioRequest'
        required: true
      responses:
        '200':
          description: Post fetched successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SoundCloudAudioResponse'
              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:
    SoundCloudAudioRequest:
      type: object
      required:
        - query
      properties:
        query:
          type: string
          description: Provide a proper soundcloud audio URL.
        is_text_formatted:
          type: boolean
          description: 'returns the review text with visual formatting preserved '
    SoundCloudAudioResponse:
      type: object
      properties:
        all_reviews:
          type: array
          description: Array of fetched audio tracks from SoundCloud
          items:
            type: object
            properties:
              audio_caption:
                type:
                  - string
                  - 'null'
                description: Caption or subtitle for the audio track
              audio_date:
                type: string
                description: Date when the audio was uploaded
                format: date-time
              audio_description:
                type: string
                description: HTML description of the audio track
              audio_duration:
                type: integer
                description: Duration of the audio in milliseconds
              audio_genre:
                type: string
                description: Genre of the audio track
              audio_id:
                type: integer
                description: Unique identifier for the audio track
              audio_label:
                type: string
                description: Record label of the audio track
              audio_link:
                type: string
                format: uri
                description: Direct URL to the SoundCloud track
              audio_tag_list:
                type: string
                description: String of tags associated with the audio
              audio_tags:
                type: object
                description: Object containing tags and their metadata
              audio_thumbnail_url:
                type: string
                format: uri
                description: URL of the audio track's Updated thumbnail image
              audio_thumbnail_url_org:
                type: string
                format: uri
                description: URL of the audio track's thumbnail image
              audio_title:
                type: string
                description: Title of the audio track
              audio_type:
                type: string
                description: Type of audio content (e.g., 'track', 'playlist')
              audio_writer_composer:
                type: string
                description: Writer and composer credits for the track
              author_city:
                type: string
                description: City where the author is located
              author_country_code:
                type:
                  - string
                  - 'null'
                description: Country code of the author's location
              author_creator_subscriptions:
                type: array
                description: Array of creator subscription products
                items:
                  type: object
                  properties:
                    product:
                      type: object
                      properties:
                        id:
                          type: string
                          description: Subscription product ID
              author_date_of_birth:
                type: object
                description: Author's date of birth
                properties:
                  day:
                    type: integer
                  month:
                    type: integer
                  year:
                    type: integer
              author_first_name:
                type: string
                description: First name of the author
              author_full_name:
                type: string
                description: Full name of the author
              author_id:
                type: integer
                description: Unique identifier for the author
              author_last_name:
                type: string
                description: Last name of the author
              author_name:
                type: string
                description: Display name of the author
              author_profile_background_image_url:
                type: string
                description: URL of the author's profile background image
              author_profile_badges:
                type: object
                description: Profile badges and verification status
                properties:
                  creator_mid_tier:
                    type: boolean
                    description: Whether author has creator mid-tier badge
                  pro:
                    type: boolean
                    description: Whether author has pro badge
                  pro_unlimited:
                    type: boolean
                    description: Whether author has pro unlimited badge
                  verified:
                    type: boolean
                    description: Whether author is verified
              author_profile_created_date:
                type: string
                description: Date when the author's profile was created
              author_profile_description:
                type: string
                description: Description from the author's profile
              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_stats:
                type: object
                description: Statistics for the author's profile
                properties:
                  comments_count:
                    type: integer
                    description: Number of comments on author's profile
                  followers_count:
                    type: integer
                    description: Number of followers
                  followings_count:
                    type: integer
                    description: Number of accounts the author follows
                  groups_count:
                    type: integer
                    description: Number of groups the author belongs to
                  likes_count:
                    type: integer
                    description: Number of likes on author's content
                  playlist_likes_count:
                    type: integer
                    description: Number of playlist likes
                  reposts_count:
                    type:
                      - integer
                      - 'null'
                    description: Number of reposts
                  tracks_count:
                    type: integer
                    description: Number of tracks uploaded by author
              author_profile_url:
                type: string
                format: uri
                description: URL of the author's SoundCloud profile
              author_verified:
                type: boolean
                description: Whether the author account is verified
              embed:
                type: object
                description: Embed information for the track
                properties:
                  src:
                    type: string
                    format: uri
                    description: Embed player source URL
              publisher_metadata:
                type: object
                description: Publisher and metadata information
                properties:
                  artist:
                    type: string
                    description: Artist name
                  contains_music:
                    type: boolean
                    description: Whether the track contains music
                  explicit:
                    type: boolean
                    description: Whether the track contains explicit content
                  id:
                    type: integer
                    description: Publisher metadata ID
                  isrc:
                    type: string
                    description: International Standard Recording Code
                  urn:
                    type: string
                    description: Uniform Resource Name for the track
                  writer_composer:
                    type: string
                    description: Writer and composer information
              query:
                type: string
                description: Original query URL used to fetch the track
              stats:
                type: object
                description: Engagement statistics for the track
                properties:
                  comments_count:
                    type: integer
                    description: Number of comments on the track
                  downloads_count:
                    type: integer
                    description: Number of downloads
                  likes_count:
                    type: integer
                    description: Number of likes
                  reposts_count:
                    type: integer
                    description: Number of reposts
                  views_count:
                    type: integer
                    description: Number of views/plays
    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

````