|Search for tags|
|Other Useful Information|
If you are a programmer, and would like to develop an application for the iPhone, Android smartphone or any other platform, please visit our API page
Tag Teaching Guidelines
Updated Feb 2 2012 Darwin Scheel has compiled and made available his Barbershop Tag Teaching Guidelines for men and women
How to Multitrack
Anyone interested in creating their own multitrack recordings should check out the excellent guides we've collected on our Multitrack page.
Access all the tags on our site from the following smartphone (iPhone, etc) applications:
|With thanks to...|
Matt Henderson, for designing our site's logo free of charge
Dean Martin from singersdaily.com, for making the domain name available
An API (Application Programming Interface) has been developed for the BarbershopTags.com website, to allow programmers to develop applications for other platforms, such as the iPhone, Android smartphones, and the like.
Currently, there are two ways to interact with the API:
The API receives HTTP GET requests, queries our online database and returns the requested data in the format specified below
Specify on the HTTP GET line the details of the tag(s) you are interested in, and the system will return the tag details in XML format.
A typical browse request looks like this:
The PARAMETERS listed above are optional. If they are omitted, the API will return all tags in the system (well, the first 10, anyway).
The parameters that can be specified are as follows:
|q||Words to search for in the tags' title, alternative title, or arranger's name. Use %20 for spaces. If omitted, all tags are returned. Note: If you specify the "q" parameter, you should not specify the "id" parameter (see below). Searches are case-insensitive.
|n||The maximum number of tag results required. If omitted, the default of 10 is used. Not required when the "id" parameter is specified (see below).
|start||The index number of the first tag to return. If omitted, the default of 1 is used. Note that tags start at index 1, not index 0. Note that the "index" is NOT the same as the tag's id field. The index is simply the position of the tag in the list of tags that are returned.
|id||When a specific tag is required, it should be referenced by its "id" number. Note that if you specify the "id" parameter, you should not specify any of the following parameters: q, n, start, Parts, Learning, SheetMusic, Collection, MinRating, MinDownloaded or Sortby.
|Parts||Specify tags that are written for a specific number of voice parts. Not required with the "id" parameter.
|Learning||Specify whether you want tags with learning tracks or not. Not required with the "id" parameter.
e.g. Learning=Yes (tags with at least one learning track)
Learning=No (tags with no learning tracks at all)
|SheetMusic||Specify whether you want tags with sheet music or not. Not required with the "id" parameter.
e.g. SheetMusic=Yes or SheetMusic=No
|Collection||Only return tags that are part of a particular collection. Not required with the "id" parameter. At present, there are only two tag collections in the system:
Collection=classic (David Wright's "Classic Tags")
Collection=easytags (The "Easy Tags" collection)
|MinRating||Filter the tags returned so that the only tags returned are the ones that have their "Rating" field (see below) greater than or equal to the number you specify. This number can be an integer (e.g. MinRating=3) or a decimal number (e.g. MinRating=3.6). Not required with the "id" parameter.|
|MinDownloaded||Filter the tags returned so that the only tags returned are the ones that have their "Downloaded" field (see below) greater than or equal to the number you specify. This number must be an integer (e.g. MinDownloaded=300). Not required with the "id" parameter.|
|Minstamp||Filter the tags returned so that the only tags returned are ones that have their "stamp" field later than or equal to the value you specify. This value can be either a date or a date/time. Use the following formats: either YYYY-MM-DD or YYYY-MM-DD HH:MM:SS where a %20 must be used for the space between the day and the hour. e.g. Minstamp=2011-06-28 or Minstamp=2011-06-28%2018:04:30|
|Sortby||How to order the tags that are returned. Not required with the "id" parameter. The options are:
Sortby=Title (the default) - sort alphabetically by the tag's title
Sortby=Posted - sort by the date the tag was posted to the site (newest first)
Sortby=stamp - sort by the date the tag was last updated (newest first)
Sortby=Rating - sort by the tags' 5-star rating (highest first)
Sortby=Downloaded - sort by the tags' "downloaded" count (most downloaded first)
Sortby=Classic - sort by the tag's "Classic Tags" number (the order in which the tags appear in David Wright's "Classic Tags" booklet). Should only be used with the Collection=classic parameter.
|fldlist||A list of the fields that you want returned in the XML, comma-separated (no spaces). If you omit this parameter, then all fields are returned. e.g. fldlist=id,Title,Parts,videos. The full list of available fields is given below.|
|client||The name of the application or website accessing this data (optional). e.g. client=MyTagsApp|
Note that all parameters are case-sensitive (except for the search query term used with the "q" parameter)
For example, consider the following query:
This means: Search all tags...
Or, to find the first 20 tags from the "Classic Tags" booklet, use the following:
And then to find the next 20...
The query results will look something like this:
<?xml version="1.0" ?>
<tags available="125" count="10" stamp="2011-06-28 18:04:30">
<Recording>stereo - one part on one side, the other three parts on the other side</Recording>
<Posted>Sat, 13 Dec 2008</Posted>
<videos available="1" count="1">
<SungBy>Ronnie Spann (aka BBSTENOR419)</SungBy>
<Posted>Mon, 30 Mar 2009</Posted>
There will be one XML block labelled "tags". It will have three attributes:
Inside that "tags" block, there will be m XML blocks, each labelled "tag". Each represents all the details from one tag in the database. Each has a single attribute: index=i, representing the position of this tag in the total search results.
Each "tag" block will have the following fields:
|id||The tag's internal database ID|
|Title||The tag's primary title|
|AltTitle||The tag's alternative title|
|Version||The tag's version (e.g. "Realtime version")|
|WritKey||The key the tag was written in|
|Parts||The number of voice parts the tag was written for|
|Type||Either "Barbershop", "Sweet Adelines", "SATB", "Other male", "Other female" or "Other mixed"|
|Recording||The method by which the learning tracks (if any) were recorded|
|TeachVid||The YouTube video ID of the learning video - http://www.youtube.com/watch?v=[video ID here]|
|Notes||Any notes or comments made by the person who uploaded the tag|
|Arranger||The name of the tag's arranger|
|ArrWebsite||The arranger's website|
|Arranged||The year the tag was arranged|
|SungBy||The artist that made the tag famous|
|SungWebsite||The website of the artist that made the tag famous|
|SungYear||The year the tag was made famous|
|Quartet||The quartet or person that sung the learning tracks|
|QWebsite||The website of the quartet or person that sung the learning tracks|
|Teacher||The quartet or person that sung the learning video|
|TWebsite||The website of the quartet or person that sung the learning video|
|Provider||The person that provided the tag or learning tracks|
|ProvWebsite||The website of the person that provided the tag or learning tracks|
|Posted||The date the tag was added to the BarbershopTags.com website|
|Classic||If the tag is part of David Wright's "Classic Tags" booklet, this is the tag number within that booklet|
|Rating||The average of all the tag's 5-star ratings, as a decimal number (e.g. 3.451104)|
|RatingCount||The number of people that have rated the tag|
|Downloaded||The number of times the tag has been downloaded|
|stamp||The date and time the tag was last updated, in the format YYYY-MM-DD HH:MM:SS. Note that when a tag's rating or download count changes, this updates the tag's stamp value. Note also that when a video is added to the list of videos available for a tag, the tag's stamp does not change.|
|SheetMusic||URL of the tag's sheet music|
|Notation||URL of the tag's music notation file|
|AllParts||URL of the tag's "All parts" recording (usually MP3)|
|URLs of each of the tag's learning tracks
Note that the type/extension of the file is returned as a "type" attribute
e.g. <Bass type="mp3">....</Bass>
|videos||Set of XML blocks, each representing one tag video, arranged in descending order of the date the video was added to BarbershopTags.com. Each sub-block is called <video>. The <videos> block will be present whether there are <video> sub-blocks or not. There will always be two attributes to the videos field: "available" and "count". Each will contain an identical number - the number of videos available for this tag. There is no way to control how many videos are returned for each tag - you always get all of them. The only thing you can do is specify a fldlist parameter that doesn't include the "videos" field, and then the entire videos XML block will be omitted.
The fields contained in each video block are:
Specify on the HTTP GET line the tag that you would like to rate, and its rating, and the system will return either an error message or "ok".
A rating request looks like this:
http://www.barbershoptags.com/api.php?action=rate&id=[tag ID]&rating=[Your rating]
Each rating request must contain exactly three parameters:
|action||Must always be set to rate
|id||The tag ID of the tag you wish to rate.
|rating||The rating you wish to give the tag. Must be an integer between 1 and 5 (inclusive). 0 is not a valid rating, nor is 3.5.
If all parameters validate correctly, the system will output the word ok onto the page - nothing more.
Otherwise a descriptive error message will be output (e.g. Tag 123456 does not exist).
A working example would look like this:
We would love to hear from you....
If any of the above applies to you, please contact us!