Spinitron Charts
Spinitron Charts take a survey of all spins logged on Spinitron by all our member stations that publish their spins on Spinitron. Every spin on every station for the chart period is counted and counts for the same (i.e. no weightings). Each chart entry comes with a link to a page listing each spin with a link to its appearance in the playlist. With that you can find the full context of the spin.
Reuse
Spinitron Charts are copyright material but we allow others to use them. In fact we positively encourage reuse and provide tools to make it easier. But there are some conditions and limitations explained below.
IMPORTANT NOTE: Spinitron Charts are NOT edited to be free from indecent language, safe for work, suitable for children, or indeed appropriate for any context you may have. You take full responsibility for such judgments. See the terms below.
Media
Besides statutory rights under fair use, reuse in online text media (web pages, emails, Facebook, blogs, Twitter and the like) is allowed (under the conditions given below) without any need to inform us. Reuse in other media such as print, radio, TV, audio podcast etc. requires gaining our prior permission.
Required information
Spinitron Charts presented in online text media must include the following:
- Attribution to Spinitron, for example, in the form of a byline or by using the title “Spinitron Charts”
- A link to Spinitron, e.g. http://spinitron.com or http://spinitron.com/charts
- Spin details links. Each item in a Spinitron chart comes with a link to a “Spins details” page listing all the spins the item got during the chart period. From that page the user can link through to the playlists the spins appear in. It’s vital that you retain these links somehow. They are crucial to the transparency of Spinitron Charts.
- A copyright notice. The origin of all Spinitron Charts is this web site, which always delivers charts with a copyright notice. Do not remove it.
Terms
Spinitron charts are provided by Spinitron “as is” and any express or implied warranties, including, but not limited to, the implied warranties of merchantability and fitness for a particular purpose are disclaimed. In no event shall Spinitron or its member stations, partners or associates be liable for any direct, indirect, incidental, special, exemplary, or consequential damages however caused and on any theory of liability, whether in contract, strict liability, or tort (including negligence or otherwise) arising in any way out of the use of chart's data, even if advised of the possibility of such damage.
Accessing charts
We provide the charts in several data formats and provide many options to let you customize them.
Base URLs
All formats are available at the following URL with optional get parameters added to the end:
| http://spinitron.com/charts/ | The latest chart |
| http://spinitron.com/charts/id e.g. http://spinitron.com/charts/23 | Where id is a chart ID, gets a previous chart with the given ID. These are permalinks, the given chart will always be available at that URL. |
| http://spinitron.com/charts/all | A listing of all available charts with a link and some statistics. |
| http://spinitron.com/charts/spins/id | Where id is a chart item ID, gets a page listing all the spins for n item in a chart. |
Chart IDs are found in the table in http://spinitron.com/charts/all. Chart item IDs are found in charts themselves.
Available formats
http://spinitron.com/charts/ and http://spinitron.com/charts/id are available in the following data formats by specifying a format param:
| HTML page | http://spinitron.com/charts/ |
| HTML table without page around it | http://spinitron.com/charts/?format=table |
| RSS1 | http://spinitron.com/charts/?format=rss1 |
| RSS2 | http://spinitron.com/charts/?format=rss2 |
| ATOM | http://spinitron.com/charts/?format=atom |
| JSON | http://spinitron.com/charts/?format=json |
| XML | http://spinitron.com/charts/?format=xml |
To use with a chart ID, add the ID before the query character:
http://spinitron.com/charts/23?format=json
Specifying data content
The content of a chart table can be specified for the HTML, JSON and XML formats (RSS and ATOM feeds cannot be controlled) with the fields param. The fields param is a comma-separated list of field names:
| id | Chart item ID. By default the chart ID column is hidden with style={display:none} |
| rank | Rank of the item in the chart. The most spin item has rank = 1. |
| spins | The number of spins the item received in the chart period. |
| artist | Name of the artist. |
| disk | Name of the disk (e.g. album title) |
| genre | Genre of music |
| art | Link to cover art |
The default if you omit a fields param is equivalent to specifying: fields=id,rank,artist,disk,genre,art
You can specify which of these fields is a link to the chart item’s spins details page with the spinlink param. It is also a comma-separated list of field names or you can set it to special value all.
Controlling HTML page content
If an HTML page format is used, you can omit the page banner and headings by setting titles=0. This also works on the http://spinitron.com/charts/spins/id pages.
On http://spinitron.com/charts/spins/id pages the summary table at the top and album are suppressed by summary=0.
The chart or spins table’s element is omitted with thead=0.
You may replace the default stylesheet with one of your own by specifying the css param. For example, if you had a stylesheet at http://yourdomain.com/style.css you could use: http://spinitron.com/charts/?css= http://yourdomain.com/style.css
You can add CSS style rules to the HTML page head element with the styles param, e.g. http://spinitron.com/charts/?styles=body{background:red}table{color:#bada55;font-size:10px}
You can specify the class name of various items on the page with the classes param. It is a comma-separated list of element-to-class mapping rules. For example: classes=th:head,td:cell
This says that every TH element will be <th class="head"> and every TD element will be <td class="cell">. Other elements available for mapping are TABLE, TR and A.
TH and TD elements may also be styled on a per column basis by adding a number to the rule. For example, classes=td3:foo means that every TD element in the third column will have class="foo".
Controlling appearance of HTML pages