Mock sample for your project: setlist.fm API
Integrate with "setlist.fm API" from setlist.fm in no time with Mockoon's ready to use mock sample
setlist.fm API
setlist.fm
Version: 1.0
Integrate third-party APIs faster by using "setlist.fm API" ready-to-use mock sample. Mocking this API will allow you to start working in no time. No more accounts to create, API keys to provision, accesses to configure, unplanned downtime, just work.
Improve your integration tests by mocking third-party APIs and cover more edge cases: slow response time, random failures, etc.
Description
The setlist.fm API has been designed to give you easy access to setlist data in order to build fancy websites and
other applications. Before starting to use the API, be sure to ...
... understand how setlist.fm works (the FAQ and the
Guidelines are a good starting point), ... read this documentation carefully and ... apply for an API key (link for logged in users only) - if
you're no registered user yet, then register first (it's free).
If this documentation isn't enough or if you've got other things you'd like to tell us about the API, visit the
API Forum.
Note that the setlist.fm API is, according to the API terms of
service, only free for non-commercial projects. If you're interested in using the API for commercial purposes,
contact us.
About this Service
This service provides methods to get both setlists and components of setlists such as artists, cities, countries or
venues.
Supported Content Types
The REST service currently supports XML (default) and JSON content.
To receive a JSON response, set the Accept
header to application/json.
Internationalization
(Please note that this is an experimental feature and does not work for all cities!)
Most of the featured methods honor the Accept-Language
header. This header is used for
localizing cities and countries. The default language is English (en), but you can provide any of the languages
Spanish (es), French (fr), German (de), Portuguese (pt), Turkish (tr), Italian (it) or Polish (pl).
E.g. if you search a setlist for a concert that took place in Vienna and you pass "de" as header, you'll
get"Wien, Österreich" instead of"Vienna, Austria".
This also works if you use a different language than the country's native language.
E.g. for a concert in New York, you'll get"Nueva York, Estados Unidos" instead of"New
York, United States" if you pass "es" as language.
API Keys
API keys ( application form) must be included in the request with
the x-api-key header.
Version History
Version
Docs
End of Service
1.0
Docs
0.1
December 31, 2017
Other APIs in the same category
Flat API
The Flat API allows you to easily extend the abilities of the Flat Platform, with a wide range of use cases including the following:
Creating and importing new music scores using MusicXML, MIDI, Guitar Pro (GP3, GP4, GP5, GPX, GP), PowerTab, TuxGuitar and MuseScore files
Browsing, updating, copying, exporting the user's scores (for example in MP3, WAV or MIDI)
Managing educational resources with Flat for Education: creating & updating the organization accounts, the classes, rosters and assignments.
The Flat API is built on HTTP. Our API is RESTful It has predictable resource URLs. It returns HTTP response codes to indicate errors. It also accepts and returns JSON in the HTTP body.
The schema of this API follows the OpenAPI Initiative (OAI) specification, you can use and work with compatible Swagger tools.
This API features Cross-Origin Resource Sharing (CORS) implemented in compliance with W3C spec.
You can use your favorite HTTP/REST library for your programming language to use Flat's API. This specification and reference is available on Github.
Getting Started and learn more:
API Overview and introduction
Authentication (Personal Access Tokens or OAuth2)
SDKs
Rate Limits
Changelog
Creating and importing new music scores using MusicXML, MIDI, Guitar Pro (GP3, GP4, GP5, GPX, GP), PowerTab, TuxGuitar and MuseScore files
Browsing, updating, copying, exporting the user's scores (for example in MP3, WAV or MIDI)
Managing educational resources with Flat for Education: creating & updating the organization accounts, the classes, rosters and assignments.
The Flat API is built on HTTP. Our API is RESTful It has predictable resource URLs. It returns HTTP response codes to indicate errors. It also accepts and returns JSON in the HTTP body.
The schema of this API follows the OpenAPI Initiative (OAI) specification, you can use and work with compatible Swagger tools.
This API features Cross-Origin Resource Sharing (CORS) implemented in compliance with W3C spec.
You can use your favorite HTTP/REST library for your programming language to use Flat's API. This specification and reference is available on Github.
Getting Started and learn more:
API Overview and introduction
Authentication (Personal Access Tokens or OAuth2)
SDKs
Rate Limits
Changelog
Google OAuth2 API
Obtains end-user authorization grants for use with other Google APIs.
Musixmatch API
Musixmatch lyrics API is a robust service that permits you to search and retrieve lyrics in the simplest possible way. It just works.
Include millions of licensed lyrics on your website or in your application legally.
The fastest, most powerful and legal way to display lyrics on your website or in your application.
Read musixmatch API Terms & Conditions and the Privacy Policy:
Before getting started, you must take a look at the API Terms & Conditions and the Privacy Policy. We’ve worked hard to make this service completely legal so that we are all protected from any foreseeable liability. Take the time to read this stuff.
Register for an API key:
All you need to do is register in order to get your API key, a mandatory parameter for most of our API calls. It’s your personal identifier and should be kept secret:
Integrate the musixmatch service with your web site or application
In the most common scenario you only need to implement two API calls:
The first call is to match your catalog to ours using the track.search function and the second is to get the lyrics using the track.lyrics.get api. That’s it!
API Methods
What does the musiXmatch API do?
The musiXmatch API allows you to read objects from our huge 100% licensed lyrics database.
To make your life easier we are providing you with one or more examples to show you how it could work in the wild. You’ll find both the API request and API response in all the available output formats for each API call. Follow the links below for the details.
The current API version is 1.1, the root URL is located at https://api.musixmatch.com/ws/1.1/
Supported input parameters can be found on the page Input Parameters. Use UTF-8 to encode arguments when calling API methods.
Every response includes a status_code. A list of all status codes can be consulted at Status Codes.
Music meta data
The musiXmatch api is built around lyrics, but there are many other data we provide through the api that can be used to improve every existent music service.
Track
Inside the track object you can get the following extra information:
TRACK RATING
The track rating is a score 0-100 identifying how popular is a song in musixmatch.
You can use this information to sort search results, like the most popular songs of an artist, of a music genre, of a lyrics language.
INSTRUMENTAL AND EXPLICIT FLAGS
The instrumental flag identifies songs with music only, no lyrics.
The explicit flag identifies songs with explicit lyrics or explicit title. We're able to identify explicit words and set the flag for the most common languages.
FAVOURITES
How many users have this song in their list of favourites.
Can be used to sort tracks by num favourite to identify more popular tracks within a set.
MUSIC GENRE
The music genere of the song.
Can be used to group songs by genre, as input for similarity alghorithms, artist genre identification, navigate songs by genere, etc.
SONG TITLES TRANSLATIONS
The track title, as translated in different lanauages, can be used to display the right writing for a given user, example:
LIES (Bigbang) becomes 在光化門 in chinese
HALLELUJAH (Bigbang) becomes ハレルヤ in japanese
Artist
Inside the artist object you can get the following nice extra information:
COMMENTS AND COUNTRY
An artist comment is a short snippet of text which can be mainly used for disambiguation.
The artist country is the born country of the artist/group
There are two perfect search result if you search by artist with the keyword "U2". Indeed there are two distinct music groups with this same name, one is the most known irish group of Bono Vox, the other is a less popular (world wide speaking) group from Japan.
Here's how you can made use of the artist comment in your search result page:
U2 (Irish rock band)
U2 (あきやまうに)
You can also show the artist country for even better disambiguation:
U2 (Irish rock band) from Ireland
U2 (あきやまうに) from Japan
ARTIST TRANSLATIONS
When you create a world wide music related service you have to take into consideration to display the artist name in the user's local language. These translation are also used as aliases to improve the search results.
Let's use PSY for this example.
Western people know him as PSY but korean want to see the original name 싸이.
Using the name translations provided by our api you can show to every user the writing they expect to see.
Furthermore, when you search for "psy gangnam style" or "싸이 gangnam style" with our search/match api you will still be able to find the song.
ARTIST RATING
The artist rating is a score 0-100 identifying how popular is an artist in musixmatch.
You can use this information to build charts, for suggestions, to sort search results. In the example above about U2, we use the artist rating to show the irish band before the japanese one in our serp.
ARTIST MUSIC GENRE
We provide one or more main artist genre, this information can be used to calculate similar artist, suggestions, or the filter a search by artist genre.
Album
Inside the album object you can get the following nice extra information:
ALBUM RATING
The album rating is a score 0-100 identifying how popular is an album in musixmatch.
You can use this information to sort search results, like the most popular albums of an artist.
ALBUM RATING
The album rating is a score 0-100 identifying how popular is an album in musixmatch.
You can use this information to sort search results, like the most popular albums of an artist.
ALBUM COPYRIGHT AND LABEL
For most of our albums we can provide extra information like for example:
Label: Universal-Island Records Ltd.
Copyright: (P) 2013 Rubyworks, under license to Columbia Records, a Division of Sony Music Entertainment.
ALBUM TYPE AND RELEASE DATE
The album official release date can be used to sort an artist's albums view starting by the most recent one.
Album can also be filtered or grouped by type: Single, Album, Compilation, Remix, Live. This can help to build an artist page with a more organized structure.
ALBUM MUSIC GENRE
For most of the albums we provide two groups of music genres. Primary and secondary. This information can be used to help user navigate albums by genre.
An example could be:
Primary genere: POP
Secondary genre: K-POP or Mandopop
Include millions of licensed lyrics on your website or in your application legally.
The fastest, most powerful and legal way to display lyrics on your website or in your application.
Read musixmatch API Terms & Conditions and the Privacy Policy:
Before getting started, you must take a look at the API Terms & Conditions and the Privacy Policy. We’ve worked hard to make this service completely legal so that we are all protected from any foreseeable liability. Take the time to read this stuff.
Register for an API key:
All you need to do is register in order to get your API key, a mandatory parameter for most of our API calls. It’s your personal identifier and should be kept secret:
Integrate the musixmatch service with your web site or application
In the most common scenario you only need to implement two API calls:
The first call is to match your catalog to ours using the track.search function and the second is to get the lyrics using the track.lyrics.get api. That’s it!
API Methods
What does the musiXmatch API do?
The musiXmatch API allows you to read objects from our huge 100% licensed lyrics database.
To make your life easier we are providing you with one or more examples to show you how it could work in the wild. You’ll find both the API request and API response in all the available output formats for each API call. Follow the links below for the details.
The current API version is 1.1, the root URL is located at https://api.musixmatch.com/ws/1.1/
Supported input parameters can be found on the page Input Parameters. Use UTF-8 to encode arguments when calling API methods.
Every response includes a status_code. A list of all status codes can be consulted at Status Codes.
Music meta data
The musiXmatch api is built around lyrics, but there are many other data we provide through the api that can be used to improve every existent music service.
Track
Inside the track object you can get the following extra information:
TRACK RATING
The track rating is a score 0-100 identifying how popular is a song in musixmatch.
You can use this information to sort search results, like the most popular songs of an artist, of a music genre, of a lyrics language.
INSTRUMENTAL AND EXPLICIT FLAGS
The instrumental flag identifies songs with music only, no lyrics.
The explicit flag identifies songs with explicit lyrics or explicit title. We're able to identify explicit words and set the flag for the most common languages.
FAVOURITES
How many users have this song in their list of favourites.
Can be used to sort tracks by num favourite to identify more popular tracks within a set.
MUSIC GENRE
The music genere of the song.
Can be used to group songs by genre, as input for similarity alghorithms, artist genre identification, navigate songs by genere, etc.
SONG TITLES TRANSLATIONS
The track title, as translated in different lanauages, can be used to display the right writing for a given user, example:
LIES (Bigbang) becomes 在光化門 in chinese
HALLELUJAH (Bigbang) becomes ハレルヤ in japanese
Artist
Inside the artist object you can get the following nice extra information:
COMMENTS AND COUNTRY
An artist comment is a short snippet of text which can be mainly used for disambiguation.
The artist country is the born country of the artist/group
There are two perfect search result if you search by artist with the keyword "U2". Indeed there are two distinct music groups with this same name, one is the most known irish group of Bono Vox, the other is a less popular (world wide speaking) group from Japan.
Here's how you can made use of the artist comment in your search result page:
U2 (Irish rock band)
U2 (あきやまうに)
You can also show the artist country for even better disambiguation:
U2 (Irish rock band) from Ireland
U2 (あきやまうに) from Japan
ARTIST TRANSLATIONS
When you create a world wide music related service you have to take into consideration to display the artist name in the user's local language. These translation are also used as aliases to improve the search results.
Let's use PSY for this example.
Western people know him as PSY but korean want to see the original name 싸이.
Using the name translations provided by our api you can show to every user the writing they expect to see.
Furthermore, when you search for "psy gangnam style" or "싸이 gangnam style" with our search/match api you will still be able to find the song.
ARTIST RATING
The artist rating is a score 0-100 identifying how popular is an artist in musixmatch.
You can use this information to build charts, for suggestions, to sort search results. In the example above about U2, we use the artist rating to show the irish band before the japanese one in our serp.
ARTIST MUSIC GENRE
We provide one or more main artist genre, this information can be used to calculate similar artist, suggestions, or the filter a search by artist genre.
Album
Inside the album object you can get the following nice extra information:
ALBUM RATING
The album rating is a score 0-100 identifying how popular is an album in musixmatch.
You can use this information to sort search results, like the most popular albums of an artist.
ALBUM RATING
The album rating is a score 0-100 identifying how popular is an album in musixmatch.
You can use this information to sort search results, like the most popular albums of an artist.
ALBUM COPYRIGHT AND LABEL
For most of our albums we can provide extra information like for example:
Label: Universal-Island Records Ltd.
Copyright: (P) 2013 Rubyworks, under license to Columbia Records, a Division of Sony Music Entertainment.
ALBUM TYPE AND RELEASE DATE
The album official release date can be used to sort an artist's albums view starting by the most recent one.
Album can also be filtered or grouped by type: Single, Album, Compilation, Remix, Live. This can help to build an artist page with a more organized structure.
ALBUM MUSIC GENRE
For most of the albums we provide two groups of music genres. Primary and secondary. This information can be used to help user navigate albums by genre.
An example could be:
Primary genere: POP
Secondary genre: K-POP or Mandopop
Google Site Verification API
Verifies ownership of websites or domains with Google.
Cloud OS Login API
You can use OS Login to manage access to your VM instances using IAM roles.
Certificate Authority API
The Certificate Authority Service API is a highly-available, scalable service that enables you to simplify and automate the management of private certificate authorities (CAs) while staying in control of your private keys.
My Business Lodging API
The My Business Lodging API enables managing lodging business information on Google.
Safe Browsing API
Enables client applications to check web resources (most commonly URLs) against Google-generated lists of unsafe web resources. The Safe Browsing APIs are for non-commercial use only. If you need to use APIs to detect malicious URLs for commercial purposes – meaning “for sale or revenue-generating purposes” – please refer to the Web Risk API.
Image Moderation
Our FREE API blocks images with nudity. Build from the ground up, accurate models, best in class support, great price.
Wikimedia
This API provides cacheable and straightforward access to Wikimedia content and data, in machine-readable formats.
Global Rules
Limit your clients to no more than 200 requests/s to this API.
Each API endpoint's documentation may detail more specific usage limits.
Set a unique User-Agent or Api-User-Agent header that
allows us to contact you quickly. Email addresses or URLs
of contact pages work well.
By using this API, you agree to Wikimedia's Terms of Use and Privacy Policy. Unless otherwise specified in the endpoint documentation below, content accessed via this API is licensed under the CC-BY-SA 3.0 and GFDL licenses, and you irrevocably agree to release modifications or additions made through this API under these licenses. See https://www.mediawiki.org/wiki/REST_API for background and details.
Endpoint documentation
Please consult each endpoint's documentation for details on:
Licensing information for the specific type of content
and data served via the endpoint.
Stability markers to inform you about development status and
change policy, according to
our API version policy.
Endpoint specific usage limits.
Global Rules
Limit your clients to no more than 200 requests/s to this API.
Each API endpoint's documentation may detail more specific usage limits.
Set a unique User-Agent or Api-User-Agent header that
allows us to contact you quickly. Email addresses or URLs
of contact pages work well.
By using this API, you agree to Wikimedia's Terms of Use and Privacy Policy. Unless otherwise specified in the endpoint documentation below, content accessed via this API is licensed under the CC-BY-SA 3.0 and GFDL licenses, and you irrevocably agree to release modifications or additions made through this API under these licenses. See https://www.mediawiki.org/wiki/REST_API for background and details.
Endpoint documentation
Please consult each endpoint's documentation for details on:
Licensing information for the specific type of content
and data served via the endpoint.
Stability markers to inform you about development status and
change policy, according to
our API version policy.
Endpoint specific usage limits.
Retail API
Cloud Retail service enables customers to build end-to-end personalized recommendation systems without requiring a high level of expertise in machine learning, recommendation system, or Google Cloud.