Reviews

Get a review

GET/v1/reviews/{reviewId}

No API keyRate-limited

One public review.

Parameters#

Path parameters#

Name	Type	Description
reviewIdrequired	string	The review’s id, a UUID. Pattern: `^[0-9a-f-]{36}$` · Example: `2ea78192-78b7-49c9-80d0-893d247e4787`

Try it#

Sends a real request to the production API through this site. No credentials are used, so you see exactly what anyone would.

Request#

curl "https://api.rankdmusic.app/v1/reviews/2ea78192-78b7-49c9-80d0-893d247e4787"

const response = await fetch('https://api.rankdmusic.app/v1/reviews/2ea78192-78b7-49c9-80d0-893d247e4787');
const body = await response.json();

if (!response.ok) {
  const code = typeof body.error === 'string' ? body.error : body.error.code;
  throw new Error(`Rankd API ${response.status}: ${code}`);
}

const { data, meta } = body;

import Foundation

let url = URL(string: "https://api.rankdmusic.app/v1/reviews/2ea78192-78b7-49c9-80d0-893d247e4787")!
let (data, response) = try await URLSession.shared.data(from: url)

guard let http = response as? HTTPURLResponse, http.statusCode == 200 else {
    throw URLError(.badServerResponse)
}

let body = try JSONSerialization.jsonObject(with: data) as? [String: Any]
let result = body?["data"]

import requests

response = requests.get("https://api.rankdmusic.app/v1/reviews/2ea78192-78b7-49c9-80d0-893d247e4787", timeout=10)
body = response.json()

if not response.ok:
    error = body["error"]
    raise RuntimeError(error if isinstance(error, str) else error["code"])

data = body["data"]

Response#

A successful response is { "data": …, "meta": … }. data is a Review, and meta is a Meta.

Field	Type	Description
idalways	string	The review’s id.
userId	string	Who wrote it.
usernamealways	string	Their username.
music	MusicRef
bodyalways	string	The review.
containsSpoilers	boolean	The author marked it as containing spoilers.
ratingValue	integer or null	The rating given with it, 0–100.
visibility	string	Always `public` without credentials.
createdAt	string (date-time) or null	When it was written.
updatedAt	string (date-time) or null	When it last changed.

Responses#

200The review.

Captured from production: GET /v1/reviews/2ea78192-78b7-49c9-80d0-893d247e4787

200 response

{
  "data": {
    "id": "2ea78192-78b7-49c9-80d0-893d247e4787",
    "userId": "usr_01KY0JGXMWTT8H9WFN9RTM5JP9",
    "username": "kyle",
    "music": {
      "provider": "apple_music",
      "type": "song",
      "id": "1590368894",
      "title": "All Too Well (10 Minute Version) [Taylor's Version] [From The Vault]",
      "artistName": "Taylor Swift",
      "artworkUrl": "https://is1-ssl.mzstatic.com/image/thumb/Music115/v4/15/38/9b/15389bf4-8074-06c3-11ee-655b5453af68/21UM1IM25046.rgb.jpg/600x600bb.jpg",
      "albumId": "1590368448",
      "albumTitle": "Red (Taylor’s Version) [+ A Message from Taylor]"
    },
    "body": "amazing 🤩",
    "containsSpoilers": false,
    "ratingValue": 100,
    "visibility": "public",
    "createdAt": "2026-09-29T17:48:53.928Z",
    "updatedAt": "2026-09-29T17:48:53.928Z"
  },
  "meta": {
    "apiVersion": 1,
    "migrationPhase": 3,
    "sourceOfTruth": "per_account"
  }
}

404No such review, or it is not public.

Captured from production: GET /v1/reviews/00000000-0000-0000-0000-000000000000

404 response

{
  "error": {
    "code": "not_found",
    "message": "Review not found."
  }
}

429Too many requests this minute. Wait Retry-After seconds, then try again.

Headers: Retry-After Seconds to wait. Always 60.

429 response

{
  "error": "rate limited"
}