Skip to content

Instantly share code, notes, and snippets.

View brainix's full-sized avatar
💻
Designed by Apple in California

Rajiv Bakulesh Shah brainix

💻
Designed by Apple in California
View GitHub Profile
@brainix
brainix / spool.tv-api.md
Last active August 29, 2015 14:11
The spool.tv Public REST API

Public REST API

Overview

spool.tv is a music video preview website. We aggregate a lot of data about songs, artists, and music genres. If you build anything with our API, we’d love to hear about it! Or if you need some help, please contact us: spool@74inc.com Happy hacking!

Paths

We identify songs, artists, and genres by paths. Paths are lowercased, hyphenated, unique identifiers that correspond to the names of songs, artists, and genres. If you’d like to query for a song, artist, or genre and you don’t know its path, your best bet is to use our search API endpoint. In the search result, you’ll find the song path as path, the artist path as artist_path, and the genre path as genre_path.

Metrics (popularity and freshness)

We score each music video preview according to how popular it is cumulatively (popularity), and how trending it is today (freshness). Lastly, we normalize these scores