{
  "name": "kapiko Music Intelligence Data",
  "description": "Machine-readable index of all available data files and API endpoints on kapiko.ai",
  "version": "1.0.0",
  "available_genres": [
    "acoustic",
    "afrobeat",
    "alt-rock",
    "alternative",
    "ambient",
    "anime",
    "black-metal",
    "bluegrass",
    "blues",
    "brazil",
    "breakbeat",
    "british",
    "cantopop",
    "chicago-house",
    "children",
    "chill",
    "classical",
    "club",
    "comedy",
    "country",
    "dance",
    "dancehall",
    "death-metal",
    "deep-house",
    "detroit-techno",
    "disco",
    "disney",
    "drum-and-bass",
    "dub",
    "dubstep",
    "edm",
    "electro",
    "electronic",
    "emo",
    "focus",
    "folk",
    "forro",
    "french",
    "funk",
    "garage",
    "german",
    "gospel",
    "goth",
    "grindcore",
    "groove",
    "grunge",
    "guitar",
    "happy",
    "hard-rock",
    "hardcore",
    "hardstyle",
    "heavy-metal",
    "hip-hop",
    "honky-tonk",
    "house",
    "idm",
    "indian",
    "indie",
    "indie-pop",
    "industrial",
    "iranian",
    "j-dance",
    "j-idol",
    "j-pop",
    "j-rock",
    "jazz",
    "jazz-piano",
    "k-pop",
    "kids",
    "latin",
    "latino",
    "lofi-hip-hop",
    "malay",
    "mandopop",
    "metal",
    "metalcore",
    "minimal-techno",
    "mpb",
    "neo-classical",
    "new-age",
    "opera",
    "pagode",
    "party",
    "piano",
    "pop",
    "pop-film",
    "power-pop",
    "progressive-house",
    "psych-rock",
    "punk",
    "punk-rock",
    "r-n-b",
    "reggae",
    "reggaeton",
    "rock",
    "rock-n-roll",
    "rockabilly",
    "romance",
    "sad",
    "salsa",
    "samba",
    "sertanejo",
    "show-tunes",
    "singer-songwriter",
    "ska",
    "sleep",
    "songwriter",
    "soul",
    "spanish",
    "study",
    "swedish",
    "synth-pop",
    "tango",
    "techno",
    "trance",
    "trip-hop",
    "turkish",
    "world-music"
  ],
  "data_files": {
    "genres/{genre}/analysis.json": {
      "description": "Spotify audio feature analysis for the genre \u2014 BPM, key, mode, energy, valence, acousticness, instrumentalness, danceability, loudness, speechiness, duration, top artists, and raw track values",
      "available_genres": [
        "acoustic",
        "afrobeat",
        "alt-rock",
        "alternative",
        "ambient",
        "anime",
        "black-metal",
        "bluegrass",
        "blues",
        "brazil",
        "breakbeat",
        "british",
        "cantopop",
        "chicago-house",
        "children",
        "chill",
        "classical",
        "club",
        "comedy",
        "country",
        "dance",
        "dancehall",
        "death-metal",
        "deep-house",
        "detroit-techno",
        "disco",
        "disney",
        "drum-and-bass",
        "dub",
        "dubstep",
        "edm",
        "electro",
        "electronic",
        "emo",
        "focus",
        "folk",
        "forro",
        "french",
        "funk",
        "garage",
        "german",
        "gospel",
        "goth",
        "grindcore",
        "groove",
        "grunge",
        "guitar",
        "happy",
        "hard-rock",
        "hardcore",
        "hardstyle",
        "heavy-metal",
        "hip-hop",
        "honky-tonk",
        "house",
        "idm",
        "indian",
        "indie",
        "indie-pop",
        "industrial",
        "iranian",
        "j-dance",
        "j-idol",
        "j-pop",
        "j-rock",
        "jazz",
        "jazz-piano",
        "k-pop",
        "kids",
        "latin",
        "latino",
        "lofi-hip-hop",
        "malay",
        "mandopop",
        "metal",
        "metalcore",
        "minimal-techno",
        "mpb",
        "neo-classical",
        "new-age",
        "opera",
        "pagode",
        "party",
        "piano",
        "pop",
        "pop-film",
        "power-pop",
        "progressive-house",
        "psych-rock",
        "punk",
        "punk-rock",
        "r-n-b",
        "reggae",
        "reggaeton",
        "rock",
        "rock-n-roll",
        "rockabilly",
        "romance",
        "sad",
        "salsa",
        "samba",
        "sertanejo",
        "show-tunes",
        "singer-songwriter",
        "ska",
        "sleep",
        "songwriter",
        "soul",
        "spanish",
        "study",
        "swedish",
        "synth-pop",
        "tango",
        "techno",
        "trance",
        "trip-hop",
        "turkish",
        "world-music"
      ],
      "example": "https://kapiko.ai/genres/ambient/analysis.json",
      "format": "application/json"
    },
    "data/ambient-gemini-aggregate.json": {
      "description": "AI-analyzed aggregate data for ambient genre \u2014 instruments, mood, texture, atmosphere, dynamics, vocal presence, stereo width, harmonic complexity, rhythm presence, genre tags, sound design elements, similar artists",
      "format": "application/json"
    },
    "data/ambient-songs-index.json": {
      "description": "Track index for ambient genre with mood and key info per track",
      "format": "application/json"
    },
    "data/ambient-top100.json": {
      "description": "Top 100 ambient tracks with full Spotify audio features",
      "format": "application/json"
    }
  },
  "api": {
    "base_url": "https://kapiko.ai/api/v1",
    "docs": "https://kapiko.ai/api/",
    "openapi": "https://kapiko.ai/openapi.json",
    "llms_txt": "https://kapiko.ai/llms.txt",
    "auth": "none \u2014 open access beta",
    "endpoints": {
      "GET /stats": "Platform statistics \u2014 genre count, track count, last updated",
      "GET /genres": "List all genres with summary stats",
      "GET /genres/:genre": "Full audio feature analysis for a genre",
      "GET /genres/:genre/tracks": "Track list for a genre with audio features",
      "GET /tracks": "Browse all indexed tracks (paginated)",
      "GET /tracks/:id": "Single track with audio features and Gemini AI analysis",
      "GET /compare": "Compare audio features across multiple genres"
    }
  }
}