IVA API    
 

Music Available APIs

Listed below are all the various ways you can interact with our API:

All Music Videos
Description: Generates a list of all available music videos ordered by date added to SingingFool.com
URL: http://www.singingfool.com/api/newmusic.aspx
Parameters:

    1. Page (int) - Sets the page number in the results set
    2. PageSize (int) - Sets the number of results per page, limit 100
    3. DeveloperId = DeveloperId supplied to you when you sign up, this is required for all access

    View Flash Customization Parameters

Example:
http://www.singingfool.com/api/newmusic.aspx?page=2&pagesize=10&DeveloperId={Your DeveloperId}


All Unsigned Videos
Description: New unsigned music videos
URL: http://www.singingfool.com/api/newunsignedmusic.aspx
Parameters:

    1. Page (int) - Sets the page number in the results set
    2. PageSize (int) - Sets the number of results per page, limit 100
    3. DeveloperId = DeveloperId supplied to you when you sign up, this is required for all access

    View Flash Customization Parameters

Example:
http://www.singingfool.com/api/newunsignedmusic.aspx?page=2&pagesize=10&DeveloperId={Your DeveloperId}


SingingFool.com Charts
Description: Generates a list of SingingFool selected charts
URL: http://www.singingfool.com/api/musiccharts.aspx
Parameters:

    1. Genre (int) - Sets the chart
         8997 - Country
         8998 - R&B
         8999 - Hip Hop
         9021 - Rock
         9022 - Pop
    2. Page - Which page out of [PageSize] you would like to load
    3. PageSize - Size of [Page] that should be returned when querying the API
    4. Randomize (boolean) - Allows you to randomize the results returned
    5. DeveloperId = DeveloperId supplied to you when you sign up, this is required for all access

    View Flash Customization Parameters

Example:
http://www.singingfool.com/api/musiccharts.aspx?Genre=9022&DeveloperId={Your DeveloperId}&Randomize=true


SingingFool.com Search
Description: Allows you to query the best music video collection on the web
URL: http://www.singingfool.com/api/musicsearch.aspx
Parameters:

    1. SearchTerm (string) - Value you are searching for, required
    2. SearchFor (int) = DeveloperId supplied to you when you sign up, this is required for all access
         0 - Title Search
         1 - PublishedID (Search using our unique identifier)
         2 - ArtistID (Returns all videos for a particular artist by ID)
         3 - LabelID (Returns all videos for a particular Label by ID)
         4 - Artist Name (Returns all videos with matching search term)
         5 - Label (Returns all videos with matching label search term)
         6 - Album (Returns all videos with matching album search term)
         7 - Created Since (Returns all videos created since search term. Search term must be valid date format)
    3. Page - Which page out of [PageSize] you would like to load
    4. PageSize - Size of [Page] that should be returned when querying the API
    5. DeveloperId = DeveloperId supplied to you when you sign up, this is required for all access

    View Flash Customization Parameters

Example:
http://www.singingfool.com/api/musicsearch.aspx?searchfor=0&searchterm={title}&DeveloperId={Your DeveloperId}


Media RSS

You also have the option of retrieving data using the Media RSS format.

What is Media RSS? Media RSS is an extension of RSS developed to handle multiple media formats (video, audio, etc.) and also is capable of providing more metadata with the media beyond regular RSS. It is very widely supported by all major feed aggregators.

You can access our Media RSS feed for Music using this URL:

http://www.singingfool.com/api/MusicMediaRss.aspx?id=GenreID where GenreID can be:

    0 = Country
    1 = Rap/Hip Hop
    2 = R&B/Funk
    3 = Kids/Holiday/Comedy
    4 = Rock
    5 = Pop
    6 = Latin
    7 = Classical
    8 = Hard Rock
    9 = Alternative
    10 = Dance/Electronica
    11 = Jazz/Blues/Reggae
    12 = Mixed Bag
    13 = Reggae
    14 = Gospel/Christian

    View Flash Customization Parameters


For more information as to what the resulting XML file contains, as well as how to customize our flash player, please see our API Quick Reference page.

Copyright © 2008 Internet Video Archive LLC