{"data":{"site":{"name":"Chorus Reviews","description":"Machine-readable critic consensus for albums, artist discographies, monthly lists, score movers, freshness deltas, and same-artist comparisons.","homepage_url":"https:\/\/chorus.reviews","data_url":"https:\/\/chorus.reviews\/data","llms_url":"https:\/\/chorus.reviews\/llms.txt","catalog_url":"https:\/\/chorus.reviews\/api\/music\/catalog","contact_url":"mailto:hey@chorus.reviews?subject=Chorus%20Data%20Inquiry"},"recommended_traversal":[{"step":1,"title":"Start at the bot catalog","surface":"https:\/\/chorus.reviews\/api\/music\/catalog","reason":"Use the live catalog to discover canonical endpoints, template URLs, query parameters, and sample resources from one source of truth."},{"step":2,"title":"Resolve album identity when you do not know the Chorus slug","surface":"https:\/\/chorus.reviews\/api\/music\/find-album?artist={artist_name}&title={album_title}","reason":"Resolve artist and title queries into a canonical Chorus album page and answer object before asking follow-up questions."},{"step":3,"title":"Prefer canonical answer objects over scraping HTML","surface":"https:\/\/chorus.reviews\/api\/music\/albums\/{album_slug}","reason":"Album, artist, list, and compare payloads are derived from the same answer layer used on the public site, which keeps bot facts aligned with proof pages."},{"step":4,"title":"Use freshness feeds instead of broad recrawls","surface":"https:\/\/chorus.reviews\/api\/music\/changes","reason":"The change feed and score-mover endpoint expose recent deltas so stale entities can be refreshed surgically."},{"step":5,"title":"Use public proof pages and widget output for citation","surface":"https:\/\/chorus.reviews\/data","reason":"Every payload links back to a canonical Chorus page, and the widget surface provides a downstream-ready score artifact when a lightweight citation block is useful."}],"surfaces":[{"key":"catalog","name":"Bot catalog","template_url":"https:\/\/chorus.reviews\/api\/music\/catalog","example_url":"https:\/\/chorus.reviews\/api\/music\/catalog","open_label":"Open","description":"Machine-readable catalog of Chorus entry points, traversal order, query parameters, and sample resources.","response_shape":"catalog","query_parameters":[],"status":"Live"},{"key":"llms","name":"LLM guide","template_url":"https:\/\/chorus.reviews\/llms.txt","example_url":"https:\/\/chorus.reviews\/llms.txt","open_label":"Open","description":"Plain-text guide that points agents to the canonical Chorus JSON surfaces and refresh loop.","response_shape":"plain_text","query_parameters":[],"status":"Live"},{"key":"current_releases","name":"Current releases","template_url":"https:\/\/chorus.reviews\/api\/music\/current-releases","example_url":"https:\/\/chorus.reviews\/api\/music\/current-releases?days=30&limit=10","open_label":"Open","description":"Recent releases with consensus score, review count, answer-state summary, and track metadata.","response_shape":"collection","query_parameters":["days","limit"],"status":"Live"},{"key":"trending_tracks","name":"Trending tracks","template_url":"https:\/\/chorus.reviews\/api\/music\/trending-tracks","example_url":"https:\/\/chorus.reviews\/api\/music\/trending-tracks?days=30&limit=10","open_label":"Open","description":"Critic-mentioned tracks from recent albums, ordered by mention count and sentiment.","response_shape":"collection","query_parameters":["days","limit"],"status":"Live"},{"key":"critic_agreement","name":"Critic agreement","template_url":"https:\/\/chorus.reviews\/api\/music\/critic-agreement","example_url":"https:\/\/chorus.reviews\/api\/music\/critic-agreement","open_label":"Open","description":"High-agreement and high-disagreement albums packaged as a recurring consensus asset.","response_shape":"report","query_parameters":[],"status":"Live"},{"key":"changes","name":"Change feed","template_url":"https:\/\/chorus.reviews\/api\/music\/changes","example_url":"https:\/\/chorus.reviews\/api\/music\/changes?types=album%2Clist&limit=10","open_label":"Open","description":"Freshness and delta feed for album and list updates from the canonical answer layer.","response_shape":"change_feed","query_parameters":["since","types","limit"],"status":"Live"},{"key":"score_movers","name":"Score movers","template_url":"https:\/\/chorus.reviews\/api\/music\/score-movers","example_url":"https:\/\/chorus.reviews\/api\/music\/score-movers?days=7&limit=10","open_label":"Open","description":"Largest recent score and review-count changes across the album graph.","response_shape":"delta_collection","query_parameters":["days","limit"],"status":"Live"},{"key":"lists_index","name":"Monthly lists index","template_url":"https:\/\/chorus.reviews\/api\/music\/lists","example_url":"https:\/\/chorus.reviews\/api\/music\/lists?limit=6","open_label":"Open","description":"Discover recent best-of-month list assets and the top albums in each list without crawling HTML.","response_shape":"list_index","query_parameters":["type","time_period","year","limit"],"status":"Live"},{"key":"album_lookup","name":"Album lookup","template_url":"https:\/\/chorus.reviews\/api\/music\/find-album?artist={artist_name}&title={album_title}","example_url":"https:\/\/chorus.reviews\/api\/music\/find-album?artist=Lip%20Critic&title=Theft%20World","open_label":"Example","description":"Resolve a human query for artist and album title into the canonical Chorus album record.","response_shape":"lookup_result","query_parameters":["artist","title"],"status":"Live"},{"key":"album_answer","name":"Album answer object","template_url":"https:\/\/chorus.reviews\/api\/music\/albums\/{album_slug}","example_url":"https:\/\/chorus.reviews\/api\/music\/albums\/lip-critic-theft-world","open_label":"Example","description":"Canonical album answer with score, review count, verdict, confidence, freshness, praise, criticism, standout tracks, and proof-page URL.","response_shape":"album_answer","query_parameters":[],"status":"Live"},{"key":"artist_answer","name":"Artist discography answer","template_url":"https:\/\/chorus.reviews\/api\/music\/artists\/{artist_slug}","example_url":"https:\/\/chorus.reviews\/api\/music\/artists\/lip-critic","open_label":"Example","description":"Ranked discography answer with consensus highlights, strongest albums, and related list\/comparison links.","response_shape":"artist_discography","query_parameters":[],"status":"Live"},{"key":"list_answer","name":"Monthly list answer","template_url":"https:\/\/chorus.reviews\/api\/music\/lists\/{list_slug}","example_url":"https:\/\/chorus.reviews\/api\/music\/lists\/best-albums-of-april-2026","open_label":"Example","description":"Canonical month-list payload with summary copy, metadata, and ordered album entries.","response_shape":"list_payload","query_parameters":[],"status":"Live"},{"key":"album_compare","name":"Album comparison payload","template_url":"https:\/\/chorus.reviews\/api\/music\/compare?left={album_slug}&right={album_slug}","example_url":null,"open_label":null,"description":"Same-artist album-versus-album payload covering score, review depth, confidence, freshness, and consensus takeaways.","response_shape":"comparison","query_parameters":["left","right"],"status":"Live"},{"key":"choruscore_widget","name":"ChoruScore widget","template_url":"https:\/\/chorus.reviews\/embed\/albums\/{album_slug}\/choruscore?variant=card&theme=dark","example_url":"https:\/\/chorus.reviews\/embed\/albums\/lip-critic-theft-world\/choruscore?variant=card&theme=dark","open_label":"Example","description":"Embeddable downstream score artifact powered by the same album answer object as the public proof page.","response_shape":"html_widget","query_parameters":["variant","theme"],"status":"Live"}],"sample_resources":{"album":{"title":"Theft World","slug":"lip-critic-theft-world","page_url":"https:\/\/chorus.reviews\/albums\/lip-critic-theft-world","api_url":"https:\/\/chorus.reviews\/api\/music\/albums\/lip-critic-theft-world"},"artist":{"name":"Lip Critic","slug":"lip-critic","page_url":"https:\/\/chorus.reviews\/artists\/lip-critic\/albums-ranked","api_url":"https:\/\/chorus.reviews\/api\/music\/artists\/lip-critic"},"album_lookup_url":"https:\/\/chorus.reviews\/api\/music\/find-album?artist=Lip%20Critic&title=Theft%20World","widget":{"embed_url":"https:\/\/chorus.reviews\/embed\/albums\/lip-critic-theft-world\/choruscore?variant=card&theme=dark","page_url":"https:\/\/chorus.reviews\/albums\/lip-critic-theft-world"},"list":{"title":"Best Albums of April 2026","slug":"best-albums-of-april-2026","page_url":"https:\/\/chorus.reviews\/lists\/best-albums-of-april-2026","api_url":"https:\/\/chorus.reviews\/api\/music\/lists\/best-albums-of-april-2026"}},"notes":["Prefer JSON endpoints over scraping HTML whenever a matching public surface exists.","The change feed is the refresh rail for albums and lists; score movers provide a second high-signal delta surface.","Widget output is powered by the same canonical answer object as the public album page."]},"meta":{"source":"Chorus - Critical Music Consensus","last_updated":"2026-05-04T15:56:33.657302Z"}}