API key. Read keys (rw_live_...) access GET endpoints. Admin keys (rw_admin_...) access all endpoints.
Query Parameters
date
string
Single day (YYYY-MM-DD). Overrides from/to.
Pattern: ^\d{4}-\d{2}-\d{2}$
Example:
"2025-02-17"
from
string
Range start, inclusive (ISO 8601)
Example:
"2025-02-01T00:00:00Z"
to
string
Range end, inclusive (ISO 8601)
Example:
"2025-02-28T23:59:59Z"
group_by
enum<string>
default:month
Available options:
week,
month,
year
Example:
"month"
limit
integer
default:10
Max genres to return (rest grouped as "Other")
Required range: 1 <= x <= 50
Example:
10
compare_to
enum<string>
When set to previous_year, returns a compare array with the same shape as data but for the window shifted back one year. Requires from + to or date to be set; ignored otherwise.
{"docsConfig":{"theme":"almond","$schema":"https://mintlify.com/schema.json","name":"Rewind","description":"Personal data aggregation API. Syncs and serves data from the services that track your life.","colors":{"primary":"#6874e8","light":"#8b94f0","dark":"#6874e8"},"logo":{"light":"https://mintcdn.com/rewindrest/Tls5eCxt2of69vdc/logo/light.svg?fit=max\u0026auto=format\u0026n=Tls5eCxt2of69vdc\u0026q=85\u0026s=4daa7e64596acddb1e9ff3083705811c","dark":"https://mintcdn.com/rewindrest/Tls5eCxt2of69vdc/logo/dark.svg?fit=max\u0026auto=format\u0026n=Tls5eCxt2of69vdc\u0026q=85\u0026s=056d6954501a5d93a26a5972cb33c6dd"},"favicon":"https://mintcdn.com/rewindrest/ImB3CC59ZACJpC4S/favicon.svg?fit=max\u0026auto=format\u0026n=ImB3CC59ZACJpC4S\u0026q=85\u0026s=8bbccad2db169fe7ff12cf1b8a8bb89c","api":{"playground":{"display":"interactive"},"examples":{"languages":["bash","javascript","python"],"prefill":true}},"appearance":{"default":"system","strict":false},"background":{"color":{"light":"#ffffff","dark":"#0a0a0a"}},"navbar":{"primary":{"type":"button","label":"Get Started","href":"/quickstart"}},"footer":{"socials":{"github":"https://github.com/pdugan20/rewind"}},"search":{"prompt":"Search docs..."},"contextual":{"options":["copy","view","chatgpt","claude"],"display":"header"},"thumbnails":{"appearance":"light"},"interaction":{"drilldown":true},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"rewindrest","hasAudioNarration":false,"actualSubdomain":"rewindrest","customDomains":["docs.rewind.rest"],"gitSource":{"type":"github","owner":"pdugan20","repo":"rewind","deployBranch":"main","contentDirectory":"docs-mintlify","isPrivate":true,"mountPath":"","label":""},"entitlements":{},"buildId":"6aecfdfb461215ef1a348c49","clientVersion":"0.0.4143","searchFilterCounts":[{"language":"default","tag":"API Reference","count":102},{"language":"default","tag":"Listening","count":19},{"language":"default","tag":"Running","count":19},{"language":"default","tag":"Collecting","count":16},{"language":"default","tag":"Reading","count":15},{"language":"default","tag":"Watching","count":15},{"language":"default","tag":"Guides","count":13},{"language":"default","tag":"MCP","count":12},{"language":"default","tag":"Attending","count":9},{"language":"default","tag":"Domains","count":7}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":true},"customCss":[{"filePath":"styles.css","content":"img[src*=\"/images/\"]{border-radius:1rem}"}],"page":{"pagePath":"api-reference/listening/genre-breakdown","slug":"/api-reference/listening/genre-breakdown","pageMetadata":{"openapi":"get /v1/listening/genres","title":"Genre breakdown","description":"Returns a genre breakdown over time, grouped by period and designed for stacked bar charts.","href":"/api-reference/listening/genre-breakdown"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Returns a genre breakdown over time, grouped by period and designed for stacked bar charts.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"openapi":"get /v1/listening/genres","title":"Genre breakdown","description":"Returns a genre breakdown over time, grouped by period and designed for stacked bar charts.","href":"/api-reference/listening/genre-breakdown"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"operationId":"getListeningGenres","tags":["Listening"],"summary":"Genre breakdown","description":"Returns a genre breakdown over time, grouped by period and designed for stacked bar charts.","parameters":["e42a3f14-e09a-4592-b66b-75947177765d","d7988bc7-d890-4edd-bc44-b8ac1d2370ca","b268f791-5adf-4de2-a59e-558a94499ce8","d4980a9b-6891-4664-8680-317274829a25","5dd932a2-df6d-4e9f-9db3-2b17d966d5f4","05184f74-7f44-4c83-a195-ebd801f477f2"],"responses":{"200":"4698e146-9b4b-4e39-9a3f-70664d61a699","401":"b11b5b26-8faf-43c8-9170-b3f555be66b9"},"method":"get","type":"path","servers":["45009c50-e669-49cb-9a80-287b9444af22"],"security":["adb99977-a306-4162-a8b3-f70958b0a0ef"],"path":"/v1/listening/genres","baseUrlOptions":["https://api.rewind.rest"],"title":"Genre breakdown","codeSamples":[],"requestExampleLanguages":["bash","javascript","python"],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated","prefillPlaygroundWithExample":true,"prefillPlaygroundExamples":[]},"dependencies":{"parameters":{"e42a3f14-e09a-4592-b66b-75947177765d":{"schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"Single day (YYYY-MM-DD). Overrides from/to.","example":"2025-02-17","isRequired":false,"uniqueKey":"","typeLabel":"string"},"required":false,"description":"Single day (YYYY-MM-DD). Overrides from/to.","name":"date","in":"query"},"d7988bc7-d890-4edd-bc44-b8ac1d2370ca":{"schema":{"type":"string","description":"Range start, inclusive (ISO 8601)","example":"2025-02-01T00:00:00Z","isRequired":false,"uniqueKey":"","typeLabel":"string"},"required":false,"description":"Range start, inclusive (ISO 8601)","name":"from","in":"query"},"b268f791-5adf-4de2-a59e-558a94499ce8":{"schema":{"type":"string","description":"Range end, inclusive (ISO 8601)","example":"2025-02-28T23:59:59Z","isRequired":false,"uniqueKey":"","typeLabel":"string"},"required":false,"description":"Range end, inclusive (ISO 8601)","name":"to","in":"query"},"d4980a9b-6891-4664-8680-317274829a25":{"schema":{"type":"string","enum":["week","month","year"],"default":"month","example":"month","isRequired":false,"uniqueKey":"","typeLabel":"enum\u003cstring>"},"required":false,"name":"group_by","in":"query"},"5dd932a2-df6d-4e9f-9db3-2b17d966d5f4":{"schema":{"type":"integer","minimum":1,"maximum":50,"default":10,"example":10,"description":"Max genres to return (rest grouped as \"Other\")","isRequired":false,"uniqueKey":"","typeLabel":"integer"},"required":false,"description":"Max genres to return (rest grouped as \"Other\")","name":"limit","in":"query"},"05184f74-7f44-4c83-a195-ebd801f477f2":{"schema":{"type":"string","enum":["previous_year"],"example":"previous_year","description":"When set to `previous_year`, returns a `compare` array with the same shape as `data` but for the window shifted back one year. Requires `from` + `to` or `date` to be set; ignored otherwise.","isRequired":false,"uniqueKey":"","typeLabel":"enum\u003cstring>"},"required":false,"description":"When set to `previous_year`, returns a `compare` array with the same shape as `data` but for the window shifted back one year. Requires `from` + `to` or `date` to be set; ignored otherwise.","name":"compare_to","in":"query"}},"responses":{"4698e146-9b4b-4e39-9a3f-70664d61a699":{"description":"Genre breakdown by period","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"period":{"type":"string","example":"2025-01","isRequired":true,"uniqueKey":"data.items.[INDEX].period","typeLabel":"string"},"genres":{"type":"object","additionalProperties":{"type":"number","uniqueKey":"data.items.[INDEX].genres.additionalProperties","typeLabel":"number"},"example":{"Rock":245,"Hip-Hop":112,"Electronic":87,"Other":89},"isRequired":true,"uniqueKey":"data.items.[INDEX].genres","typeLabel":"object"},"total":{"type":"number","example":637,"isRequired":true,"uniqueKey":"data.items.[INDEX].total","typeLabel":"number"}},"required":["period","genres","total"],"uniqueKey":"data.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data","typeLabel":"object[]"},"compare":{"type":"array","items":{"type":"object","properties":{"period":{"type":"string","example":"2025-01","isRequired":true,"uniqueKey":"compare.items.[INDEX].period","typeLabel":"string"},"genres":{"type":"object","additionalProperties":{"type":"number","uniqueKey":"compare.items.[INDEX].genres.additionalProperties","typeLabel":"number"},"example":{"Rock":245,"Hip-Hop":112,"Electronic":87,"Other":89},"isRequired":true,"uniqueKey":"compare.items.[INDEX].genres","typeLabel":"object"},"total":{"type":"number","example":637,"isRequired":true,"uniqueKey":"compare.items.[INDEX].total","typeLabel":"number"}},"required":["period","genres","total"],"uniqueKey":"compare.items.[INDEX]","typeLabel":"object"},"uniqueKey":"compare","typeLabel":"object[]"}},"required":["data"],"uniqueKey":"","typeLabel":"object"},"example":{"data":[{"period":"2026-01","genres":{"Rock":245,"Hip-Hop":112,"Electronic":87,"Other":89},"total":533},{"period":"2026-02","genres":{"Pop":180,"Rock":150,"Hip-Hop":95,"Other":76},"total":501},{"period":"2026-03","genres":{"Grunge":120,"Rock":110,"Pop":90,"Other":67},"total":387}]},"examples":{"Example":{"title":"Example","value":{"data":[{"period":"2026-01","genres":{"Rock":245,"Hip-Hop":112,"Electronic":87,"Other":89},"total":533},{"period":"2026-02","genres":{"Pop":180,"Rock":150,"Hip-Hop":95,"Other":76},"total":501},{"period":"2026-03","genres":{"Grunge":120,"Rock":110,"Pop":90,"Other":67},"total":387}]}}},"exampleType":"examples"}},"exampleType":"examples"},"b11b5b26-8faf-43c8-9170-b3f555be66b9":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","example":"Not found","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"status":{"type":"integer","example":404,"isRequired":true,"uniqueKey":"status","typeLabel":"integer"}},"required":["error","status"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"Not found","status":404}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"adb99977-a306-4162-a8b3-f70958b0a0ef":{"bearerAuth":{"type":"http","scheme":"bearer","description":"API key. Read keys (rw_live_...) access GET endpoints. Admin keys (rw_admin_...) access all endpoints.","scopes":[],"schemeName":"bearerAuth"}}},"servers":{"45009c50-e669-49cb-9a80-287b9444af22":{"url":"https://api.rewind.rest","description":"Production"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","description":"API key. Read keys (rw_live_...) access GET endpoints. Admin keys (rw_admin_...) access all endpoints.","scopes":[],"schemeName":"bearerAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"API key. Read keys (rw_live_...) access GET endpoints. Admin keys (rw_admin_...) access all endpoints.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearerAuth","name":"Authorization"}],"title":"bearerAuth"}]},"originalFileLocation":"openapi.json"},"subdomain":"rewindrest","siteName":"Rewind","title":"Genre breakdown - Rewind","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-06-02T15:08:11.916Z","originalFileLocation":"api-reference/listening/genre-breakdown.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Returns a genre breakdown over time, grouped by period and designed for stacked bar charts.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Rewind\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/rewindrest/ie9Lpl7vs6gqb_Oo/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/rewindrest/ie9Lpl7vs6gqb_Oo/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/rewindrest/ie9Lpl7vs6gqb_Oo/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/rewindrest/ie9Lpl7vs6gqb_Oo/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/rewindrest/ie9Lpl7vs6gqb_Oo/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/rewindrest/ie9Lpl7vs6gqb_Oo/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/rewindrest/ie9Lpl7vs6gqb_Oo/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/rewindrest/ie9Lpl7vs6gqb_Oo/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/rewindrest/ie9Lpl7vs6gqb_Oo/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Genre breakdown - Rewind\">\u003cmeta data-mint-head property=\"og:description\" content=\"Returns a genre breakdown over time, grouped by period and designed for stacked bar charts.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Rewind\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.rewind.rest/api-reference/listening/genre-breakdown\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://rewindrest.mintlify.site/_mintlify/api/og/v2?division=Listening\u0026amp;title=Genre+breakdown\u0026amp;description=Returns+a+genre+breakdown+over+time%2C+grouped+by+period+and+designed+for+stacked+bar+charts.\u0026amp;theme=01e5d1de83ebe65424248069\u0026amp;signature=db9759fd43a6e66fcc898c69ff2bbb31fcbc57fe2b9a968662012f9a4a634788\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Genre breakdown - Rewind\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Returns a genre breakdown over time, grouped by period and designed for stacked bar charts.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://rewindrest.mintlify.site/_mintlify/api/og/v2?division=Listening\u0026amp;title=Genre+breakdown\u0026amp;description=Returns+a+genre+breakdown+over+time%2C+grouped+by+period+and+designed+for+stacked+bar+charts.\u0026amp;theme=01e5d1de83ebe65424248069\u0026amp;signature=db9759fd43a6e66fcc898c69ff2bbb31fcbc57fe2b9a968662012f9a4a634788\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/rewindrest/ie9Lpl7vs6gqb_Oo/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Rewind\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#6874e8\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.rewind.rest/api-reference/listening/genre-breakdown\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/listening/genre-breakdown.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.rewind.rest/#organization\",\"name\":\"Rewind\",\"url\":\"https://docs.rewind.rest\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/rewindrest/Tls5eCxt2of69vdc/logo/light.svg?fit=max\u0026auto=format\u0026n=Tls5eCxt2of69vdc\u0026q=85\u0026s=4daa7e64596acddb1e9ff3083705811c\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.rewind.rest#website\",\"name\":\"Rewind\",\"url\":\"https://docs.rewind.rest\",\"publisher\":{\"@id\":\"https://docs.rewind.rest/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.rewind.rest/api-reference/listening/genre-breakdown#webpage\",\"url\":\"https://docs.rewind.rest/api-reference/listening/genre-breakdown\",\"name\":\"Genre breakdown\",\"description\":\"Returns a genre breakdown over time, grouped by period and designed for stacked bar charts.\",\"dateModified\":\"2026-06-02T15:08:11.916Z\",\"isPartOf\":{\"@id\":\"https://docs.rewind.rest#website\"},\"breadcrumb\":{\"@id\":\"https://docs.rewind.rest/api-reference/listening/genre-breakdown#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.rewind.rest/api-reference/listening/genre-breakdown#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Listening\",\"item\":\"https://docs.rewind.rest/api-reference/listening/now-playing\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Genre breakdown\",\"item\":\"https://docs.rewind.rest/api-reference/listening/genre-breakdown\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.rewind.rest/api-reference/listening/genre-breakdown#apireference\",\"headline\":\"Genre breakdown\",\"name\":\"Genre breakdown\",\"description\":\"Returns a genre breakdown over time, grouped by period and designed for stacked bar charts.\",\"url\":\"https://docs.rewind.rest/api-reference/listening/genre-breakdown\",\"mainEntityOfPage\":{\"@id\":\"https://docs.rewind.rest/api-reference/listening/genre-breakdown#webpage\"},\"dateModified\":\"2026-06-02T15:08:11.916Z\",\"publisher\":{\"@id\":\"https://docs.rewind.rest/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.rewind.rest#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Rewind\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Rewind\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/listening/genre-breakdown.md","siteName":"Rewind","nav":{"global":null,"tabs":[{"tab":"Guides","pages":[{"title":"Guides","href":"/introduction"}]},{"tab":"API Reference","groups":[{"group":"Listening","pages":[{"openapi":"get /v1/listening/now-playing","title":"Now playing","href":"/api-reference/listening/now-playing"},{"openapi":"get /v1/listening/recent","title":"Recent scrobbles","href":"/api-reference/listening/recent-scrobbles"},{"openapi":"get /v1/listening/top/artists","title":"Top artists","href":"/api-reference/listening/top-artists"},{"openapi":"get /v1/listening/top/albums","title":"Top albums","href":"/api-reference/listening/top-albums"},{"openapi":"get /v1/listening/top/tracks","title":"Top tracks","href":"/api-reference/listening/top-tracks"},{"openapi":"get /v1/listening/stats","title":"Listening stats","href":"/api-reference/listening/listening-stats"},{"openapi":"get /v1/listening/history","title":"Listening history","href":"/api-reference/listening/scrobble-history"},{"openapi":"get /v1/listening/artists","title":"Browse artists","href":"/api-reference/listening/browse-artists"},{"openapi":"get /v1/listening/albums","title":"Browse albums","href":"/api-reference/listening/browse-albums"},{"openapi":"get /v1/listening/artists/{id}","title":"Artist detail","href":"/api-reference/listening/artist-detail"},{"openapi":"get /v1/listening/albums/{id}","title":"Album detail","href":"/api-reference/listening/album-detail"},{"openapi":"get /v1/listening/calendar","title":"Listening calendar","href":"/api-reference/listening/scrobble-calendar"},{"openapi":"get /v1/listening/trends","title":"Listening trends","href":"/api-reference/listening/listening-trends"},{"openapi":"get /v1/listening/streaks","title":"Listening streaks","href":"/api-reference/listening/listening-streaks"},{"openapi":"get /v1/listening/year/{year}","title":"Year in review","description":"Returns year-in-review listening data. Optionally pass ?month=N to scope to a single month.","href":"/api-reference/listening/year-in-review"},{"openapi":"get /v1/listening/genres","title":"Genre breakdown","href":"/api-reference/listening/genre-breakdown"},{"openapi":"get /v1/listening/recent/albums","title":"Recently played albums","description":"Returns unique recently played albums ordered by their newest scrobble. Artist spelling aliases share one entry when album names match and their MusicBrainz and catalog identities do not conflict. Distinct release qualifiers remain separate. Reads at most 200 recent scrobbles.","href":"/api-reference/listening/recently-played-albums"},{"openapi":"get /v1/listening/discman","title":"Prepared recent albums with tracklists","href":"/api-reference/listening/recent-albums-shelf"},{"openapi":"get /v1/listening/years","title":"All year summaries","href":"/api-reference/listening/all-year-summaries"}]},{"group":"Running","pages":[{"openapi":"get /v1/running/stats","title":"Running stats","href":"/api-reference/running/lifetime-running-statistics"},{"openapi":"get /v1/running/stats/years","title":"All year summaries","href":"/api-reference/running/all-year-summaries"},{"openapi":"get /v1/running/stats/years/{year}","title":"Single year summary","href":"/api-reference/running/single-year-summary"},{"openapi":"get /v1/running/prs","title":"Personal records","href":"/api-reference/running/personal-records"},{"openapi":"get /v1/running/recent","title":"Latest runs","href":"/api-reference/running/recent-activities"},{"openapi":"get /v1/running/activities","title":"List activities","href":"/api-reference/running/list-activities"},{"openapi":"get /v1/running/activities/{id}","title":"Activity detail","href":"/api-reference/running/activity-detail"},{"openapi":"get /v1/running/activities/{id}/splits","title":"Activity splits","href":"/api-reference/running/activity-splits"},{"openapi":"get /v1/running/gear","title":"Gear list","href":"/api-reference/running/gear-list"},{"openapi":"get /v1/running/calendar","title":"Activity calendar","href":"/api-reference/running/activity-calendar"},{"openapi":"get /v1/running/charts/cumulative","title":"Cumulative distance chart","href":"/api-reference/running/cumulative-distance-chart"},{"openapi":"get /v1/running/charts/pace-trend","title":"Pace trend chart","href":"/api-reference/running/pace-trend-chart"},{"openapi":"get /v1/running/charts/time-of-day","title":"Time of day chart","href":"/api-reference/running/time-of-day-chart"},{"openapi":"get /v1/running/charts/elevation","title":"Elevation chart","href":"/api-reference/running/elevation-chart"},{"openapi":"get /v1/running/cities","title":"Cities","href":"/api-reference/running/cities"},{"openapi":"get /v1/running/streaks","title":"Running streaks","href":"/api-reference/running/running-streaks"},{"openapi":"get /v1/running/races","title":"Race activities","href":"/api-reference/running/race-activities"},{"openapi":"get /v1/running/eddington","title":"Eddington number","href":"/api-reference/running/eddington-number"},{"openapi":"get /v1/running/year/{year}","title":"Year in review","href":"/api-reference/running/year-in-review"}]},{"group":"Watching","pages":[{"openapi":"get /v1/watching/recent","title":"Recent watches","href":"/api-reference/watching/recent-watches"},{"openapi":"get /v1/watching/movies","title":"List movies","href":"/api-reference/watching/list-movies"},{"openapi":"get /v1/watching/movies/{id}","title":"Movie detail","href":"/api-reference/watching/movie-detail"},{"openapi":"get /v1/watching/stats","title":"Watch stats","href":"/api-reference/watching/watch-stats"},{"openapi":"get /v1/watching/stats/genres","title":"Genre stats","href":"/api-reference/watching/genre-stats"},{"openapi":"get /v1/watching/stats/decades","title":"Decade stats","href":"/api-reference/watching/decade-stats"},{"openapi":"get /v1/watching/stats/directors","title":"Director stats","href":"/api-reference/watching/director-stats"},{"openapi":"get /v1/watching/calendar","title":"Watch calendar","href":"/api-reference/watching/watch-calendar"},{"openapi":"get /v1/watching/trends","title":"Watch trends","href":"/api-reference/watching/watch-trends"},{"openapi":"get /v1/watching/shows","title":"List TV shows","href":"/api-reference/watching/list-tv-shows"},{"openapi":"get /v1/watching/shows/{id}","title":"Show detail","href":"/api-reference/watching/show-detail"},{"openapi":"get /v1/watching/shows/{id}/seasons/{season}","title":"Season detail","href":"/api-reference/watching/season-detail"},{"openapi":"get /v1/watching/ratings","title":"Rated movies","href":"/api-reference/watching/rated-movies"},{"openapi":"get /v1/watching/reviews","title":"Movie reviews","href":"/api-reference/watching/movie-reviews"},{"openapi":"get /v1/watching/year/{year}","title":"Year in review","href":"/api-reference/watching/year-in-review"}]},{"group":"Reading","pages":[{"openapi":"get /v1/reading/recent","title":"Recent articles","href":"/api-reference/reading/recent-articles"},{"openapi":"get /v1/reading/currently-reading","title":"Currently reading","href":"/api-reference/reading/currently-reading"},{"openapi":"get /v1/reading/articles","title":"List articles","href":"/api-reference/reading/list-articles"},{"openapi":"get /v1/reading/articles/{id}","title":"Article detail","href":"/api-reference/reading/article-detail"},{"openapi":"get /v1/reading/archive","title":"Archived articles","href":"/api-reference/reading/archived-articles"},{"openapi":"get /v1/reading/highlights","title":"List highlights","href":"/api-reference/reading/list-highlights"},{"openapi":"get /v1/reading/highlights/random","title":"Random highlight","href":"/api-reference/reading/random-highlight"},{"openapi":"get /v1/reading/stats","title":"Reading stats","href":"/api-reference/reading/reading-stats"},{"openapi":"get /v1/reading/calendar","title":"Reading calendar","href":"/api-reference/reading/reading-calendar"},{"openapi":"get /v1/reading/streaks","title":"Reading streaks","href":"/api-reference/reading/reading-streaks"},{"openapi":"get /v1/reading/tags","title":"Tag breakdown","href":"/api-reference/reading/tag-breakdown"},{"openapi":"get /v1/reading/domains","title":"Top domains","href":"/api-reference/reading/top-domains"},{"openapi":"get /v1/reading/year/{year}","title":"Year in review","href":"/api-reference/reading/year-in-review"},{"openapi":"get /v1/reading/articles/{id}/related","title":"Related articles (semantic similarity)","href":"/api-reference/reading/related-articles"},{"openapi":"get /v1/reading/highlights/{id}","title":"Highlight detail","href":"/api-reference/reading/highlight-detail"}]},{"group":"Collecting","pages":[{"openapi":"get /v1/collecting/vinyl","title":"List vinyl collection","href":"/api-reference/collecting/list-vinyl-collection"},{"openapi":"get /v1/collecting/stats","title":"Collection stats","href":"/api-reference/collecting/collection-statistics"},{"openapi":"get /v1/collecting/recent","title":"Recent vinyl additions","href":"/api-reference/collecting/recent-additions"},{"openapi":"get /v1/collecting/vinyl/{id}","title":"Vinyl record detail","href":"/api-reference/collecting/collection-item-detail"},{"openapi":"get /v1/collecting/wantlist","title":"Wantlist","href":"/api-reference/collecting/wantlist"},{"openapi":"get /v1/collecting/formats","title":"Format breakdown","href":"/api-reference/collecting/format-breakdown"},{"openapi":"get /v1/collecting/genres","title":"Genre breakdown","href":"/api-reference/collecting/genre-breakdown"},{"openapi":"get /v1/collecting/artists","title":"Top collected artists","href":"/api-reference/collecting/top-artists"},{"openapi":"get /v1/collecting/cross-reference","title":"Collection-listening cross-reference","href":"/api-reference/collecting/collection-listening-cross-reference"},{"openapi":"get /v1/collecting/calendar","title":"Collection calendar","href":"/api-reference/collecting/collection-calendar"},{"openapi":"get /v1/collecting/media","title":"List physical media collection","href":"/api-reference/collecting/list-physical-media-collection"},{"openapi":"get /v1/collecting/media/stats","title":"Physical media stats","href":"/api-reference/collecting/physical-media-statistics"},{"openapi":"get /v1/collecting/media/recent","title":"Recently added physical media","href":"/api-reference/collecting/recently-added-physical-media"},{"openapi":"get /v1/collecting/media/formats","title":"Media format breakdown","href":"/api-reference/collecting/media-format-breakdown"},{"openapi":"get /v1/collecting/media/cross-reference","title":"Owned vs watched cross-reference","href":"/api-reference/collecting/owned-vs-watched-cross-reference"},{"openapi":"get /v1/collecting/media/{id}","title":"Physical media item detail","href":"/api-reference/collecting/physical-media-item-detail"}]},{"group":"Attending","pages":[{"openapi":"get /v1/attending/events","title":"List attended events","href":"/api-reference/attending/list-attended-events"},{"openapi":"get /v1/attending/events/{id}","title":"Get an attended event","href":"/api-reference/attending/get-attended-event"},{"openapi":"get /v1/attending/seasons/{league}/{season}","title":"Attended games in a sports season","href":"/api-reference/attending/get-attended-season"},{"openapi":"get /v1/attending/venues","title":"List venues","href":"/api-reference/attending/list-venues"},{"openapi":"get /v1/attending/stats","title":"Aggregate attending stats","href":"/api-reference/attending/get-attending-stats"},{"openapi":"get /v1/attending/players","title":"List players you have watched play","href":"/api-reference/attending/list-attended-players"},{"openapi":"get /v1/attending/players/{id}","title":"Get a player you have watched play","href":"/api-reference/attending/get-attended-player"},{"openapi":"get /v1/attending/year/{year}","title":"Year in review","href":"/api-reference/attending/year-in-review"},{"openapi":"get /v1/attending/players/{id}/stats","title":"Per-player aggregate stats across attended games","href":"/api-reference/attending/attended-player-stats"}]},{"group":"Feed","pages":[{"openapi":"get /v1/feed","title":"Cross-domain activity feed","href":"/api-reference/feed/cross-domain-activity-feed"},{"openapi":"get /v1/feed/domain/{domain}","title":"Single-domain activity feed","href":"/api-reference/feed/single-domain-activity-feed"},{"openapi":"get /v1/feed/on-this-day","title":"On this day","href":"/api-reference/feed/on-this-day"},{"openapi":"get /v1/lately","title":"Prepared latest music and movie","href":"/api-reference/feed/lately"}]},{"group":"Search","pages":[{"openapi":"get /v1/search","title":"Cross-domain search","href":"/api-reference/search/cross-domain-search"}]},{"group":"System","pages":[{"openapi":"get /v1/health","title":"Health check","href":"/api-reference/system/health-check"},{"openapi":"get /v1/health/sync","title":"Sync health status","href":"/api-reference/system/sync-health-status"}]},{"group":"Images","pages":[{"openapi":"get /v1/images/{domain}/{entity_type}/{entity_id}/{size}","title":"Get image by entity","href":"/api-reference/images/get-image-by-entity"}]},{"group":"Webhooks","pages":[{"title":"Webhooks","sidebarTitle":"Webhooks","icon":"webhook","href":"/api-reference/webhooks/overview"}]}]},{"tab":"MCP","pages":[{"title":"MCP","href":"/mcp/overview"}]}]},"basePath":"","title":"Genre breakdown - Rewind","buildId":"dpl_Fyv1NbzwP68g2bEH2Roy98uY1zmE","deploymentId":"dpl_Fyv1NbzwP68g2bEH2Roy98uY1zmE","dynamics":["c2aa737661","b0f84f53ff","a9bb46feb3","2b790eda92"],"chunks":["OpenApiReferenceProvider-DdEMm2kG.js","utils-BMo572L7.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-C-4m9KAx.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-DPLK2Oq9.js","snippetPresets-BKjfJMC9.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","Page-BIYvYBgk.js","ApiExamples-DTsgtCEj.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-C8vmhyQM.js","shallow-r9w8LQGS.js","getApiPlaygroundDisplay-DjPI64HQ.js","CodeSnippet-C8Bvhl16.js","CodeSnippets-BtWUwcMy.js","getPastedJson-Dcm_3Pgl.js","icon-BXwrTpjc.js","MethodPill-CcjfVmmy.js","DuplicateIcon-BuKIbXAQ.js","createIcon-DaL9yXsO.js","DynamicMarkdown-Co5nikxh.js","SectionHeading-P4UNTsMZ.js","axios-vUo_bRtp.js","Markdown-CEfymfIH.js","clsx-Dq9TQuNi.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-D2J8knkn.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-BgZ2ThuU.js"]}