{"files":{"SKILL.md":"---\nname: setlistfm-api\ndescription: \"setlist.fm API skill. Use when working with setlist.fm for 1.0. Covers 15 endpoints.\"\nversion: 1.0.0\ngenerator: lapsh\n---\n\n# setlist.fm API\nAPI version: 1.0\n\n## Auth\nApiKey (inferred from docs)\n\n## Base URL\nNot specified.\n\n## Setup\n1. Set your API key in the appropriate header\n2. GET /1.0/search/artists -- search for artists.\n3. Explore available endpoints below\n\n## Endpoints\n15 endpoints across 1 group. See references/api-spec.lap for full details.\n\n### 1.0\n| Method | Path | Description |\n|--------|------|-------------|\n| GET | /1.0/artist/{mbid} | . |\n| GET | /1.0/artist/{mbid}/setlists | . |\n| GET | /1.0/city/{geoId} | Get a city by its unique geoId. |\n| GET | /1.0/search/artists | Search for artists. |\n| GET | /1.0/search/cities | Search for a city. |\n| GET | /1.0/search/countries | Get a complete list of all supported countries. |\n| GET | /1.0/search/setlists | Search for setlists. |\n| GET | /1.0/search/venues | Search for venues. |\n| GET | /1.0/setlist/version/{versionId} | . |\n| GET | /1.0/setlist/{setlistId} | . |\n| GET | /1.0/user/{userId} | Get a user by userId. |\n| GET | /1.0/user/{userId}/attended | . |\n| GET | /1.0/user/{userId}/edited | . |\n| GET | /1.0/venue/{venueId} | Get a venue by its unique id. |\n| GET | /1.0/venue/{venueId}/setlists | . |\n\n## Common Questions\nMatch user requests to endpoints in references/api-spec.lap. Key patterns:\n- \"Get artist details?\" -> GET /1.0/artist/{mbid}\n- \"List all setlists?\" -> GET /1.0/artist/{mbid}/setlists\n- \"Get city details?\" -> GET /1.0/city/{geoId}\n- \"List all artists?\" -> GET /1.0/search/artists\n- \"List all cities?\" -> GET /1.0/search/cities\n- \"List all countries?\" -> GET /1.0/search/countries\n- \"List all venues?\" -> GET /1.0/search/venues\n- \"Get version details?\" -> GET /1.0/setlist/version/{versionId}\n- \"Get setlist details?\" -> GET /1.0/setlist/{setlistId}\n- \"Get user details?\" -> GET /1.0/user/{userId}\n- \"List all attended?\" -> GET /1.0/user/{userId}/attended\n- \"List all edited?\" -> GET /1.0/user/{userId}/edited\n- \"Get venue details?\" -> GET /1.0/venue/{venueId}\n- \"How to authenticate?\" -> See Auth section above\n\n## Response Tips\n- Check response schemas in references/api-spec.lap for field details\n\n## References\n- Full spec: See references/api-spec.lap for complete endpoint details, parameter tables, and response schemas\n\n> Generated from the official API spec by [LAP](https://lap.sh)\n","references/api-spec.lap":"@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"}}