{"openapi":"3.1.0","info":{"title":"ListenBrainz API","version":"1.0.0","description":"A live window into ListenBrainz — the open, MetaBrainz-run music-scrobbling social network, the open-data answer to Last.fm — as an API. Pull the sitewide listening charts: the most-listened artists, recordings or releases over a week, month, quarter, year or all time, each with its listen count; a user's most recent listens; or what a user is playing right now. The pulse of what the open-music community is listening to, delivered as clean JSON for music, social and dashboard apps. Live data, no key. Distinct from music-metadata and lyrics APIs.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/listenbrainz-api","description":"oanor gateway"}],"tags":[{"name":"Charts"},{"name":"Users"},{"name":"Meta"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/charts":{"get":{"operationId":"get_v1_charts","tags":["Charts"],"summary":"Sitewide listening charts","description":"","parameters":[{"name":"entity","in":"query","required":false,"description":"artists | recordings | releases","schema":{"type":"string"},"example":"artists"},{"name":"range","in":"query","required":false,"description":"week | month | quarter | year | all_time","schema":{"type":"string"},"example":"week"},{"name":"count","in":"query","required":false,"description":"Max 1-100","schema":{"type":"string"},"example":"25"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":25,"range":"week","charts":[{"mbid":"69158f97-4c07-4c4e-baf8-4e4ab1ed666e","name":"Boards of Canada","rank":1,"artist":"Boards of Canada","listen_count":33354},{"mbid":"f59c5520-5f46-4d2c-b2c4-822eabf53419","name":"Linkin Park","rank":2,"artist":"Linkin Park","listen_count":17407},{"mbid":"a74b1b7f-71a5-4011-9441-d0b5e4122711","name":"Radiohead","rank":3,"artist":"Radiohead","listen_count":13545},{"mbid":"9fff2f8a-21e6-47de-a2b8-7f449929d43f","name":"Drake","rank":4,"artist":"Drake","listen_count":12043},{"mbid":"20244d07-534f-4eff-b4d4-930878889970","name":"Taylor Swift","rank":5,"artist":"Taylor Swift","listen_count":11600},{"mbid":"164f0d73-1234-4e2c-8743-d77bf2191051","name":"Ye","rank":6,"artist":"Ye","listen_count":11351},{"mbid":"f27ec8db-af05-4f36-916e-3d57f91ecf5e","name":"Michael Jackson","rank":7,"artist":"Michael Jackson","listen_count":10800},{"mbid":"381086ea-f511-4aba-bdf9-71c753dc5077","name":"Kendrick Lamar","rank":8,"artist":"Kendrick Lamar","listen_count":10517},{"mbid":"b51c672b-85e0-48fe-8648-470a2422229f","name":"aespa","rank":9,"artist":"aespa","listen_count":9921},{"mbid":"b10bbbfc-cf9e-42e0-be17-e2c3e1d2600d","name":"The Beatles","rank":10,"artist":"The Beatles","listen_count":9685},{"mbid":"c8b03190-306c-4120-bb0b-6f2ebfc06ea9","name":"The Weeknd","rank":11,"artist":"The Weeknd","listen_count":8726},{"mbid":"63aa26c3-d59b-4da4-84ac-716b54f1ef4d","name":"Tame Impala","rank":12,"artist":"Tame Impala","listen_count":8399},{"mbid":"c42e60f4-4520-4954-b6e4-82bbdf532c11","name":"JPEGMAFIA","rank":13,"artist":"JPEGMAFIA","listen_count":8250},{"mbid":"056e4f3e-d505-4dad-8ec1-d04f521cbb56","name":"Daft Punk","rank":14,"artist":"Daft Punk","listen_count":8244},{"mbid":"260b6184-8828-48eb-945c-bc4cb6fc34ca","name":"Charli xcx","rank":15,"artist":"Charli xcx","listen_count":8153},{"mbid":"a6c6897a-7415-4f8d-b5a5-3a5e05f3be67","name":"twenty one pilots","rank":16,"artist":"twenty one pilots","listen_count":8065},{"mbid":"83d91898-7763-47d7-b03b-b92132375c47","name":"Pink Floyd","rank":17,"artist":"Pink Floyd","listen_count":8010},{"mbid":"e21857d5-3256-4547-afb3-4b6ded592596","name":"Gorillaz","rank":18,"artist":"Gorillaz","listen_count":7934},{"mbid":"f4fdbb4c-e4b7-47a0-b83b-d91bbfcfa387","name":"Ariana Grande","rank":19,"artist":"Ariana Grande","listen_count":7216},{"mbid":"b95ce3ff-3d05-4e87-9e01-c97b66af13d4","name":"Eminem","rank":20,"artist":"Eminem","listen_count":6987},{"mbid":"084308bd-1654-436f-ba03-df6697104e19","name":"Green Day","rank":21,"artist":"Green Day","listen_count":6946},{"mbid":"89aa5ecb-59ad-46f5-b3eb-2d424e941f19","name":"Bad Bunny","rank":22,"artist":"Bad Bunny","listen_count":6885},{"mbid":"074e3847-f67f-49f9-81f1-8c8cea147e8e","name":"Bring Me the Horizon","rank":23,"artist":"Bring Me the Horizon","listen_count":6844},{"mbid":"7527f6c2-d762-4b88-b5e2-9244f1e34c46","name":"Deftones","rank":24,"artist":"Deftones","listen_count":6629},{"mbid":"5b11f4ce-a62d-471e-81fc-a69a8278c7da","name":"Nirvana","rank":25,"artist":"Nirvana","listen_count":6586}],"entity":"artists"},"meta":{"timestamp":"2026-06-09T03:03:26.136Z","request_id":"7fc9748d-9f64-456c-9232-8cd06c737671"},"status":"ok","message":"Charts retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/now-playing":{"get":{"operationId":"get_v1_now_playing","tags":["Users"],"summary":"What a user is playing now","description":"","parameters":[{"name":"username","in":"query","required":true,"description":"Username","schema":{"type":"string"},"example":"rob"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"username":"rob","playing_now":false},"meta":{"timestamp":"2026-06-09T03:03:26.257Z","request_id":"8b8efc82-034d-47d5-8323-3378f3073d26"},"status":"ok","message":"Now playing retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/user":{"get":{"operationId":"get_v1_user","tags":["Users"],"summary":"A user's recent listens","description":"","parameters":[{"name":"username","in":"query","required":true,"description":"Username","schema":{"type":"string"},"example":"rob"},{"name":"count","in":"query","required":false,"description":"Max 1-100","schema":{"type":"string"},"example":"25"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":25,"listens":[{"track":"Some Resolve","artist":"Röyksopp","release":"Profound Mysteries II","listened_at":"2026-02-18T11:28:29.000Z","recording_mbid":"30d08f4c-d825-4ae1-b79c-44242cddd7c0"},{"track":"Tell Him","artist":"Röyksopp feat. Susanne Sundfør","release":"Profound Mysteries II","listened_at":"2026-02-18T11:21:46.000Z","recording_mbid":"46f0b53f-6731-457c-93e7-57cff0e5b0c2"},{"track":"Remembering the Departed","artist":"Röyksopp","release":"Profound Mysteries II","listened_at":"2026-02-18T11:16:20.000Z","recording_mbid":"a8eb2940-b706-4e35-afd2-f15feec4eb20"},{"track":"It Was a Good Thing","artist":"Röyksopp feat. Pixx","release":"Profound Mysteries II","listened_at":"2026-02-18T11:12:30.000Z","recording_mbid":"100bdac3-db86-41ba-b987-6f639914834c"},{"track":"Control","artist":"Röyksopp","release":"Profound Mysteries II","listened_at":"2026-02-18T11:08:17.000Z","recording_mbid":"0228a5f7-fd54-4b8c-8d7c-7c6f2d0163b8"},{"track":"Sorry","artist":"Röyksopp feat. Jamie Irrepressible","release":"Profound Mysteries II","listened_at":"2026-02-18T11:02:03.000Z","recording_mbid":"1aa80b5b-0ce3-4f5a-9a1c-67823f332a12"},{"track":"Oh, Lover","artist":"Röyksopp feat. Susanne Sundfør","release":"Profound Mysteries II","listened_at":"2026-02-18T10:57:03.000Z","recording_mbid":"d1d936eb-fef3-4d19-8b73-419b978ede6a"},{"track":"Unity","artist":"Röyksopp feat. Karen Harding","release":"Profound Mysteries II","listened_at":"2026-02-18T10:50:49.000Z","recording_mbid":"07530f77-1296-43a1-aa1d-6936d7246725"},{"track":"Let’s Get It Right","artist":"Röyksopp feat. Astrid S","release":"Profound Mysteries II","listened_at":"2026-02-18T10:45:45.000Z","recording_mbid":"8060eb6b-ca9e-4e5c-9f28-b2297b23665a"},{"track":"Denimclad Baboons","artist":"Röyksopp","release":"Profound Mysteries II","listened_at":"2026-02-18T10:40:38.000Z","recording_mbid":"6400d6f9-83f2-4e18-90fc-03ac5265d269"},{"track":"Let’s Get It Right","artist":"Röyksopp feat. Astrid S","release":"Profound Mysteries II","listened_at":"2026-02-10T08:44:51.000Z","recording_mbid":"8060eb6b-ca9e-4e5c-9f28-b2297b23665a"},{"track":"Denimclad Baboons","artist":"Röyksopp","release":"Profound Mysteries II","listened_at":"2026-02-10T08:39:45.000Z","recording_mbid":"6400d6f9-83f2-4e18-90fc-03ac5265d269"},{"track":"Oh, Lover","artist":"Röyksopp feat. Susanne Sundfør","release":"Profound Mysteries II","listened_at":"2026-02-10T08:35:35.000Z","recording_mbid":"d1d936eb-fef3-4d19-8b73-419b978ede6a"},{"track":"La Guapa","artist":"B-Tribe","release":"Sensual Sensual","listened_at":"2026-02-05T18:30:04.000Z","recording_mbid":"b8df962a-6127-4d6d-a157-b414e14cb0a1"},{"track":"Tribute to J.S. Bach","artist":"B-Tribe","release":"Sensual Sensual","listened_at":"2026-02-05T18:26:35.000Z","recording_mbid":"41301395-6d54-43ea-bf32-9f09295dbee6"},{"track":"Zapateado","artist":"B-Tribe","release":"Sensual Sensual","listened_at":"2026-02-05T18:23:15.000Z","recording_mbid":"584d20cf-50a9-4742-9f10-b1d00134598b"},{"track":"Sensual Sensual","artist":"B-Tribe","release":"Sensual Sensual","listened_at":"2026-02-05T16:11:52.000Z","recording_mbid":"d5cad631-15d8-4636-bdf0-76d477c0ad0f"},{"track":"Háblame","artist":"B-Tribe","release":"Sensual Sensual","listened_at":"2026-02-05T16:05:48.000Z","recording_mbid":"affdd631-e955-4bb1-b25a-a4f11ce143b0"},{"track":"Sometimes","artist":"B-Tribe","release":"Sensual Sensual","listened_at":"2026-02-05T16:01:41.000Z","recording_mbid":"3b8e3dfb-c3f7-4e27-8eba-c8ea541d60b2"},{"track":"Alegría","artist":"B-Tribe","release":"Sensual Sensual","listened_at":"2026-02-05T15:56:26.000Z","recording_mbid":"6c0f1271-23ff-4ab7-891b-2e39676a5f5e"},{"track":"Overture (Concierto de Aranjuez)","artist":"B-Tribe","release":"Sensual Sensual","listened_at":"2026-02-05T15:50:27.000Z","recording_mbid":"180179f1-7a86-4dbd-917a-35ecfcfce78e"},{"track":"A Feeling","artist":"Christian Löffler feat. Adna","release":"Until We Meet Again","listened_at":"2026-02-05T15:44:09.000Z","recording_mbid":"10b8b705-bfc6-4227-898d-300dc104bc6d"},{"track":"What We Used to Say","artist":"Christian Löffler feat. Adna","release":"Until We Meet Again","listened_at":"2026-02-05T15:40:26.000Z","recording_mbid":"6e2bdba2-3884-48fd-b082-61c3fb332c73"},{"track":"Our Rhythm","artist":"Christian Löffler","release":"Until We Meet Again","listened_at":"2026-02-05T15:36:39.000Z","recording_mbid":"4b57faab-90fc-47a9-a9b8-13e53c832620"},{"track":"Closer","artist":"Christian Löffler feat. Shallou","release":"Until We Meet Again","listened_at":"2026-02-05T15:32:21.000Z","recording_mbid":"20d90dbb-451a-47de-a0aa-bd00eea1ae40"}],"username":"rob","total_listen_count":25},"meta":{"timestamp":"2026-06-09T03:03:27.509Z","request_id":"f872d774-44be-4637-afa8-9e2adf05fca1"},"status":"ok","message":"User listens retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/meta":{"get":{"operationId":"get_v1_meta","tags":["Meta"],"summary":"Service metadata","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"ranges":["week","month","quarter","year","all_time"],"source":"ListenBrainz public API (live)","service":"listenbrainz-api","entities":["artists","recordings","releases"],"endpoints":{"GET /v1/meta":"This document.","GET /v1/user":"A user's recent listens (username=, e.g. rob, count).","GET /v1/charts":"Sitewide listening charts (entity=artists|recordings|releases, range=week|month|quarter|year|all_time, count).","GET /v1/now-playing":"What a user is playing now (username=)."},"description":"Live data from ListenBrainz, the open MetaBrainz music-scrobbling network: sitewide listening charts (most-listened artists, recordings or releases by week/month/year/all-time with listen counts), a user's recent listens, and what a user is playing now. Live, no key. Distinct from music-metadata and lyrics APIs.","upstream_status":"ok"},"meta":{"timestamp":"2026-06-09T03:03:27.829Z","request_id":"0d5cc58f-a409-4434-8553-e6c8bef09a89"},"status":"ok","message":"Meta","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":600,"rps_limit":5,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":600,"monthly_call_quota":14000,"rps_limit":15,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":1600,"monthly_call_quota":68000,"rps_limit":30,"hard_limit":true},{"slug":"business","name":"Business","price_cents_month":4100,"monthly_call_quota":340000,"rps_limit":50,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/listenbrainz-api"}