{"note":"OpenAPI conversion -- returning structured metadata","name":"setlist-fm","description":"setlist.fm API","version":"1.0","base_url":"","endpoints":15,"raw":"@lap v0.3\n# Machine-readable API spec. Each @endpoint block is one API call.\n@api setlist.fm API\n@version 1.0\n@auth ApiKey (inferred from docs)\n@endpoints 15\n@toc 1.0(15)\n\n@endpoint GET /1.0/artist/{mbid}\n@desc .\n@required {mbid: any # a Musicbrainz MBID, e.g. 0bfba3d3-6a04-4779-bb0a-df07df5b0558}\n@returns(200) Success\n\n@endpoint GET /1.0/artist/{mbid}/setlists\n@desc .\n@required {mbid: any # the Musicbrainz MBID of the artist}\n@optional {p: any # the number of the result page}\n@returns(200) Success\n\n@endpoint GET /1.0/city/{geoId}\n@desc Get a city by its unique geoId.\n@required {geoId: any # the city's geoId}\n@returns(200) Success\n\n@endpoint GET /1.0/search/artists\n@desc Search for artists.\n@optional {artistMbid: any # the artist's Musicbrainz Identifier (mbid), artistName: any # the artist's name, artistTmid: any # the artist's Ticketmaster Identifier (tmid) (deprecated), p: any # the number of the result page you'd like to have, sort: any # the sort of the result, either sortName (default) or relevance}\n@returns(200) Success\n\n@endpoint GET /1.0/search/cities\n@desc Search for a city.\n@optional {country: any # the city's country, name: any # name of the city, p: any # the number of the result page you'd like to have, state: any # state the city lies in, stateCode: any # state code the city lies in}\n@returns(200) Success\n\n@endpoint GET /1.0/search/countries\n@desc Get a complete list of all supported countries.\n@returns(200) Success\n\n@endpoint GET /1.0/search/setlists\n@desc Search for setlists.\n@optional {artistMbid: any # the artist's Musicbrainz Identifier (mbid), artistName: any # the artist's name, artistTmid: any # the artist's Ticketmaster Identifier (tmid) (deprecated), cityId: any # the city's geoId, cityName: any # the name of the city, countryCode: any # the country code, date: any # the date of the event (format dd-MM-yyyy), lastFm: any # the event's Last.fm Event ID (deprecated), lastUpdated: any # the date and time (UTC) when this setlist was last updated (format yyyyMMddHHmmss) - either edited or reverted. search will return setlists that were updated on or after this date, p: any # the number of the result page, state: any # the state, stateCode: any # the state code, tourName: any, venueId: any # the venue id, venueName: any # the name of the venue, year: any # the year of the event}\n@returns(200) Success\n\n@endpoint GET /1.0/search/venues\n@desc Search for venues.\n@optional {cityId: any # the city's geoId, cityName: any # name of the city where the venue is located, country: any # the city's country, name: any # name of the venue, p: any # the number of the result page you'd like to have, state: any # the city's state, stateCode: any # the city's state code}\n@returns(200) Success\n\n@endpoint GET /1.0/setlist/version/{versionId}\n@desc .\n@required {versionId: any # the version id}\n@returns(200) Success\n\n@endpoint GET /1.0/setlist/{setlistId}\n@desc .\n@required {setlistId: any # the setlist id}\n@returns(200) Success\n\n@endpoint GET /1.0/user/{userId}\n@desc Get a user by userId.\n@required {userId: any # the user's userId}\n@returns(200) Success\n\n@endpoint GET /1.0/user/{userId}/attended\n@desc .\n@required {userId: any # the user's userId}\n@optional {p: any # the number of the result page}\n@returns(200) Success\n\n@endpoint GET /1.0/user/{userId}/edited\n@desc .\n@required {userId: any # the user's userId}\n@optional {p: any # the number of the result page}\n@returns(200) Success\n\n@endpoint GET /1.0/venue/{venueId}\n@desc Get a venue by its unique id.\n@required {venueId: any # the venue's id}\n@returns(200) Success\n\n@endpoint GET /1.0/venue/{venueId}/setlists\n@desc .\n@required {venueId: any # the id of the venue}\n@optional {p: any # the number of the result page}\n@returns(200) Success\n\n@end\n"}