Access reviews of releases via API

[romainhild]

I am looking to list all the reviews that the users made to a review, but I couldn't find any way to get them.
Is there any endpoint to do that, or maybe the data is hidden somewhere ?

[AnssiAhola]

Officially there's no way to get the reviews for a release, but out of curiosity I tried to call /releases/{release_id}/reviews api and it actually worked!
And based on the response there's a /reviews/{id}/replies endpoint where you can fetch the replies to specific review.

GET https://api.discogs.com/releases/1873013/reviews

{
    "pagination": {
        "page": 1,
        "pages": 4,
        "per_page": 25,
        "items": 86,
        "urls": {
            "last": "https://api.discogs.com/releases/1873013/reviews?page=4&per_page=25",
            "next": "https://api.discogs.com/releases/1873013/reviews?page=2&per_page=25"
        }
    },
    "results": [
        {
            "id": 5682297,
            "replies_url": "https://api.discogs.com/reviews/5682297/replies",
            "reply_to": 0,
            "review_plaintext": "Hello.\nI have this edition in good listening condition (vg+). But I'm desperate to add the original posters and stickers, including those on the cover... Can anyone help me?\nThank you very much!\nSincerely,\nRaphaël (From France)",
            "review_html": "Hello.<br>I have this edition in good listening condition (vg+). But I&#x27;m desperate to add the original posters and stickers, including those on the cover... Can anyone help me?<br>Thank you very much!<br>Sincerely,<br>Raphaël (From France)",
            "last_modified": "2025-08-23T04:58:11-07:00",
            "date_added": "2025-08-23T04:58:11-07:00",
            "url": "https://api.discogs.com/reviews/5682297",
            "user": {
                "id": 3821204,
                "username": "boece363",
                "avatar_url": "https://i.discogs.com/ETiQ1hx_IiqNRG50eng3tRczVZ8hSIUbG6S0qrxsvq8/rs:fill/g:sm/q:40/h:300/w:300/czM6Ly9kaXNjb2dz/LXVzZXItYXZhdGFy/cy9VLTM4MjEyMDQt/MTY5NjA1ODMxNS5q/cGVn.jpeg",
                "url": "https://api.discogs.com/users/boece363"
            },
            "num_replies": 0,
            "type": "Comment",
            "status": "Accepted",
            "message_type": "Comment"
        },
        {...}
    ]
}

Not sure at the moment if we should support these hidden endpoint when they are not documented officially.

At least for now you can call this endpoint using the client like so

print(client._get(client._base_url + "/releases/{release_id}/reviews"))

[AnssiAhola]

I think the Discogs API TOS prevents us from implementing this as this 'might be' considered as "undocumented functionality"
https://support.discogs.com/hc/en-us/articles/360009334593-API-Terms-of-Use#h_615d1a7c-ec01-4bc6-af1f-5dde6bfecec2

Bummer.

[romainhild]

That's great ! Thank you very much !
I understand that it's not officially supported so it might change without warning but for now it will do.

[romainhild]

Yeah that's unfortunate but understandable. Maybe we can ask them to document it ? We never know 🤷

[JOJ0]

If you feel like it @romainhild open a support ticket with Discogs and suggest that! Good idea!

[romainhild]

I have just submitted the request. I'll let you know if there is any news.