---
title: "Get Similar Playlists"
method: GET
path: "/api/playlist/{platform}/{id}/similarplaylists"
tags: ["Playlist"]
---

# Get Similar Playlists

`GET /api/playlist/{platform}/{id}/similarplaylists`

## Request

- Base URL: `https://api.chartmetric.com`
- URL: `https://api.chartmetric.com/api/playlist/{platform}/{id}/similarplaylists`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/chartmetric/apis/chartmetric-developer-api/docs/api/playlist/:platform/:id/similarplaylists/get.ts> (a function with typed inputs; its response is checked against the schema)

Return playlists similar to the target playlist on the given platform (Spotify or SoundCloud), with overlap flags for shared moods/genres.

## Path parameters

- `id` integer, required: Chartmetric playlist ID.
- `platform` 'spotify' | 'soundcloud', required: Streaming platform. One of `spotify` or `soundcloud`.

## Query parameters

- `indie` boolean: If true, return only indie-curated similar playlists. Defaults to false.
- `limit` integer: Maximum number of items to return per request.
- `offset` integer: Number of items to skip from the start of the result set; pair with `limit` to paginate.

## Response `200`

Success

- object
  - `obj` object[], required
    - `id` union, required: Chartmetric playlist ID of the similar playlist.
      - integer
      - string
    - `playlist_id` string, nullable: Platform-native playlist ID (e.g. Spotify URI suffix).
    - `name` string, nullable: Playlist name.
    - `image_url` string, nullable: Cover image URL.
    - `followers` integer, nullable: Current follower count of the similar playlist (Spotify).
    - `likes` integer, nullable: Current like count of the similar playlist (SoundCloud).
    - `genre` string, nullable: Comma-separated list of genres associated with the playlist.
    - `permalink` string, nullable: SoundCloud playlist permalink slug.
    - `owner_name` string, nullable: Display name of the playlist owner.
    - `owner_permalink` string, nullable: SoundCloud permalink slug of the playlist owner.
    - `user_id` union: Platform-native owner/user ID.
      - integer
      - string
    - `owner_id` union: Chartmetric curator (owner) ID for the playlist.
      - integer
      - string
    - `tags` object[], nullable: List of tags/genres on the similar playlist.
      - `id` integer, required: Chartmetric tag/genre ID.
      - `name` string, required: Tag/genre name.
      - `source` string, nullable: Source of the tag (e.g. `spotify`).
      - `type` string, nullable: Tag type (e.g. `genre`, `mood`).
      - `url` string, nullable: Optional URL associated with the tag.
      - `created_at` string, date-time, nullable: When the tag association was first observed.
      - `modified_at` string, date-time, nullable: When the tag association was last updated.
    - `genres` object[], nullable: List of genres on the similar playlist with overlap flags.
      - `id` integer, required: Chartmetric genre ID.
      - `name` string, nullable: Genre name.
      - `isOverlappingGenre` boolean: Whether this genre is shared with the target playlist.
    - `moods` object[], nullable: List of moods on the similar playlist with overlap flags.
      - `id` integer, required: Chartmetric mood ID.
      - `name` string, nullable: Mood name (e.g. `Chill`, `Energetic`).
      - `isOverlappingMood` boolean: Whether this mood is shared with the target playlist.
    - `isOverlappingGenre` boolean: Whether the playlist shares at least one genre with the target.

---

[API](https://skmtc.dev/chartmetric/apis/chartmetric-developer-api.md) - [All operations](https://skmtc.dev/chartmetric/apis/chartmetric-developer-api/llms.txt) - [OpenAPI document](https://skmtc.dev/chartmetric/apis/chartmetric-developer-api/revisions/94dac96833a3?raw)