Viberate General Apple Playlist API

The General Apple Playlist API from Viberate — 3 operation(s) for general apple playlist.

Operations 3

GET /playlist-apple/search Apple Playlist Search by Title #
GET /playlist-apple/by-channel/apple/{linkID} Apple Playlist Search by Channel #
GET /playlist-apple/{uuid}/details Apple Playlist’s Details #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/viberate:viberate-general-apple-playlist-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

viberate-general-apple-playlist-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Viberate General Apple Playlist API
  description: '# Introduction

    Welcome to Viberate API, your source of daily-refreshed data on millions of music entities.'
  version: 1.24.0
  x-logo:
    url: https://viberate.ams3.cdn.digitaloceanspaces.com/share/docs-logo.png
    altText: Viberate logo
    href: https://www.viberate.com/home
servers:
- url: https://data.viberate.com/api/v1
security:
- Access-Key: []
tags:
- name: General Apple Playlist
  x-displayName: General
paths:
  /playlist-apple/search:
    get:
      summary: Apple Playlist Search by Title
      tags:
      - General Apple Playlist
      description: Search for apple playlists by their title. Search is elastic, so approximates can provide correct search results.
      parameters:
      - in: query
        name: q
        required: true
        description: '


          Apple playlist’s title'
        schema:
          type: string
      - in: query
        name: limit
        required: false
        description: '


          Maximum number of results per page'
        schema:
          type: integer
          default: 20
      - in: query
        name: offset
        required: false
        description: Offset of results
        schema:
          type: integer
          default: 0
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
                properties:
                  api_version:
                    type: string
                    example: v1.24.0
                  data:
                    type: array
                    items:
                      type: object
                      properties:
                        uuid:
                          type: string
                          example: bb69eb97-693c-4323-abb7-9105c29dbe58
                        external_id:
                          type: string
                          example: pl.5ba88a2e00154f8b8814e6ecb4fa3728
                        name:
                          type: string
                          example: 'Jukebox Hits: ''00s Adult Hits'
                        image:
                          type: string
                          example: https://is5-ssl.mzstatic.com/image/thumb/Features62/v4/51/a6/fa/51a6fa66-f154-cc3b-3369-8310e6c9586d/pr_source.png/500x500cc.jpg
                        curator:
                          type: string
                          example: Apple Music
                        track_count:
                          type: integer
                          example: 15
                        genres:
                          type: array
                          items:
                            type: object
                            properties:
                              id:
                                type: integer
                                example: 2
                              name:
                                type: string
                                example: Pop
                              slug:
                                type: string
                                example: pop
                          example:
                          - id: 2
                            name: Pop
                            slug: pop
                          - id: 7
                            name: Rock
                            slug: rock
                        subgenres:
                          type: array
                          items:
                            type: object
                            properties:
                              id:
                                type: integer
                                example: 10
                              name:
                                type: string
                                example: Mainstream Pop
                              slug:
                                type: string
                                example: mainstream-pop
                          example:
                          - id: 10
                            name: Mainstream Pop
                            slug: mainstream-pop
                        playlist_type:
                          type: object
                          properties:
                            id:
                              type: integer
                              example: 1
                            name:
                              type: string
                              example: Editorial
                    example:
                    - uuid: bb69eb97-693c-4323-abb7-9105c29dbe58
                      external_id: pl.5ba88a2e00154f8b8814e6ecb4fa3728
                      name: 'Jukebox Hits: ''00s Adult Hits'
                      image: https://is5-ssl.mzstatic.com/image/thumb/Features62/v4/51/a6/fa/51a6fa66-f154-cc3b-3369-8310e6c9586d/pr_source.png/500x500cc.jpg
                      curator: Apple Music
                      track_count: 15
                      genres:
                      - id: 2
                        name: Pop
                        slug: pop
                      - id: 7
                        name: Rock
                        slug: rock
                      subgenres:
                      - id: 10
                        name: Mainstream Pop
                        slug: mainstream-pop
                      playlist_type:
                        id: 1
                        name: Editorial
                    - uuid: 363e5c9a-fab2-4bea-971a-11a078981d63
                      external_id: pl.285d019500634d61b05c5ecc18dca839
                      name: 'Hits: 2011'
                      image: https://is3-ssl.mzstatic.com/image/thumb/Features62/v4/57/68/e5/5768e58b-2463-791e-4561-067a2282e9f0/pr_source.png/500x500cc.jpg
                      curator: Apple Music
                      track_count: 21
                      genres:
                      - id: 2
                        name: Pop
                        slug: pop
                      - id: 6
                        name: Electronic
                        slug: electronic
                      subgenres:
                      - id: 10
                        name: Mainstream Pop
                        slug: mainstream-pop
                      playlist_type:
                        id: 1
                        name: Editorial
                    - uuid: 37e46fb7-5d51-4142-9490-855bdf3bc420
                      external_id: pl.f782466fc7c9499daac34e27c6ff76ac
                      name: 'Hits: 2013'
                      image: https://is2-ssl.mzstatic.com/image/thumb/Features71/v4/7c/bf/bb/7cbfbbea-8911-a243-e40e-0ca9a90c178e/pr_source.png/500x500cc.jpg
                      curator: Apple Music
                      track_count: 20
                      genres:
                      - id: 2
                        name: Pop
                        slug: pop
                      - id: 6
                        name: Electronic
                        slug: electronic
                      subgenres:
                      - id: 10
                        name: Mainstream Pop
                        slug: mainstream-pop
                      playlist_type:
                        id: 1
                        name: Editorial
                    - uuid: 4076f4b4-89dd-486b-9b1b-fddea31ee101
                      external_id: pl.4fe671d3bd994738ace5ae974daebc10
                      name: Happy Hits
                      image: https://is3-ssl.mzstatic.com/image/thumb/Features125/v4/bc/44/c0/bc44c09a-3239-a82a-4d82-9b9cf7947bcb/U0MtTVMtV1ctSGFwcHlfSGl0cy1BREFNX0lEPTExMjQ1ODEzMTAucG5n.png/500x500SC.DN01.jpg?l=en-CA
                      curator: Apple Music Pop
                      track_count: 100
                      genres:
                      - id: 2
                        name: Pop
                        slug: pop
                      - id: 6
                        name: Electronic
                        slug: electronic
                      subgenres:
                      - id: 10
                        name: Mainstream Pop
                        slug: mainstream-pop
                      - id: 30
                        name: Dance
                        slug: dance
                      playlist_type:
                        id: 1
                        name: Editorial
                    - uuid: 74551be7-8751-4cca-9629-980a0c0b30a8
                      external_id: pl.dc349df19c6f410d874c197db63ecfed
                      name: Afrobeats Hits
                      image: https://is1-ssl.mzstatic.com/image/thumb/Features125/v4/21/09/ee/2109ee16-0177-e85f-89c7-917ef16cb192/U0MtTVMtQUZSLUFmcm9iZWF0c19IaXRzLUFkYW1fSUQ9OTkyMjc5ODk0LnBuZw.png/500x500SC.DN01.jpg?l=en-CA
                      curator: Apple Music African
                      track_count: 119
                      genres:
                      - id: 18
                        name: African
                        slug: african
                      subgenres:
                      - id: 108
                        name: Afrobeat
                        slug: afrobeat
                      - id: 14
                        name: Contemporary R&B
                        slug: contemporary-rnb
                      playlist_type:
                        id: 1
                        name: Editorial
                    - uuid: 85720d15-9282-47c4-8c39-c2db8981ff07
                      external_id: pl.e2c1ff8a11b74e20aa3b4978d3dfb48f
                      name: 'Hits: 2013'
                      image: https://is1-ssl.mzstatic.com/image/thumb/Features62/v4/d4/25/b0/d425b03a-64fd-7115-8ac9-dfa450321184/pr_source.png/500x500cc.jpg
                      curator: Apple Music
                      track_count: 20
                      genres:
                      - id: 2
                        name: Pop
                        slug: pop
                      - id: 6
                        name: Electronic
                        slug: electronic
                      subgenres:
                      - id: 10
                        name: Mainstream Pop
                        slug: mainstream-pop
                      playlist_type:
                        id: 1
                        name: Editorial
                    - uuid: bbaa47e5-e603-4876-9d7c-35a0dac55db0
                      external_id: pl.b8ff6c5f695f4611a9ea35af77217e5a
                      name: 'Hits: 1994'
                      image: https://is5-ssl.mzstatic.com/image/thumb/Features71/v4/d2/7c/30/d27c302c-559f-ef11-5a26-5949f59117ff/pr_source.png/500x500cc.jpg
                      curator: Apple Music
                      track_count: 18
                      genres:
                      - id: 2
                        name: Pop
                        slug: pop
                      - id: 7
                        name: Rock
                        slug: rock
                      subgenres:
                      - id: 10
                        name: Mainstream Pop
                        slug: mainstream-pop
                      - id: 30
                        name: Dance
                        slug: dance
                      playlist_type:
                        id: 1
                        name: Editorial
                    - uuid: c4479b04-7937-4863-9d8a-edca80d956a3
                      external_id: pl.4581ca91c7014df6950c7108847f3b4d
                      name: 'Hits: 2006'
                      image: https://is3-ssl.mzstatic.com/image/thumb/Features62/v4/29/41/f9/2941f905-3052-017a-570d-40ac19861a24/pr_source.png/500x500cc.jpg
                      curator: Apple Music
                      track_count: 20
                      genres:
                      - id: 2
                        name: Pop
                        slug: pop
                      - id: 7
                        name: Rock
                        slug: rock
                      subgenres:
                      - id: 10
                        name: Mainstream Pop
                        slug: mainstream-pop
                      - id: 42
                        name: Alternative Rock
                        slug: alternative-rock
                      playlist_type:
                        id: 1
                        name: Editorial
                    - uuid: da0ce424-5c02-41ff-8312-6284a630c305
                      external_id: pl.f5d3cb8283254e9fbe22198dbdafe6b3
                      name: 'Hits: 2007'
                      image: https://is2-ssl.mzstatic.com/image/thumb/Features71/v4/48/18/83/48188380-e183-79fd-8e16-b3d93164c66f/pr_source.png/500x500cc.jpg
                      curator: Apple Music
                      track_count: 16
                      genres:
                      - id: 7
                        name: Rock
                        slug: rock
                      - id: 2
                        name: Pop
                        slug: pop
                      subgenres:
                      - id: 10
                        name: Mainstream Pop
                        slug: mainstream-pop
                      playlist_type:
                        id: 1
                        name: Editorial
                    - uuid: e4251720-b692-4a98-b9fe-5bccaf52698f
                      external_id: pl.f72539a0532d4219b8e119e11bcd8dc5
                      name: Drive Hits
                      image: https://is4-ssl.mzstatic.com/image/thumb/Features71/v4/43/99/34/439934c2-8b82-f57b-e2c9-1e58f9b80607/pr_source.png/500x500cc.jpg
                      curator: Apple Music
                      track_count: 16
                      genres:
                      - id: 2
                        name: Pop
                        slug: pop
                      - id: 6
                        name: Electronic
                        slug: electronic
                      subgenres:
                      - id: 10
                        name: Mainstream Pop
                        slug: mainstream-pop
                      - id: 30
                        name: Dance
                        slug: dance
                      playlist_type:
                        id: 1
                        name: Editorial
                  pagination:
                    type: object
                    properties:
                      total:
                        type: integer
                        example: 977
                      current:
                        type: integer
                        example: 10
                      limit:
                        type: integer
                        example: 20
                      offset:
                        type: integer
                        example: 0
        '400':
          description: invalid_request
        '404':
          description: not_found
        '500':
          description: internal_server_error
      operationId: getPlaylistAppleSearch
      x-operation-id-source: derived
  /playlist-apple/by-channel/apple/{linkID}:
    get:
      summary: Apple Playlist Search by Channel
      tags:
      - General Apple Playlist
      description: Search for playlists by their Apple ID.
      parameters:
      - in: path
        name: linkID
        required: true
        description: 'Apple ID


          *Example: `pl.ed8779a7a70e479696817eb2b08d1486`*'
        schema:
          type: string
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
                properties:
                  api_version:
                    type: string
                    example: v1.24.0
                  data:
                    type: object
                    properties:
                      uuid:
                        type: string
                        example: aeb4f1c8-192b-4927-8e2c-2d815f7def87
                      external_id:
                        type: string
                        example: pl.ed8779a7a70e479696817eb2b08d1486
                      name:
                        type: string
                        example: TT18 - Manu Delago
                      image:
                        type: string
                        example: https://is2-ssl.mzstatic.com/image/thumb/SG-S3-US-Std-Image-000001/v4/4b/57/4a/4b574a76-7ef8-5c16-b3a2-36a275e34851/image/500x500cc.jpg
                      curator:
                        type: string
                        example: Tru Thoughts
                      track_count:
                        type: integer
                        example: 49533
                      genres:
                        type: array
                        items:
                          type: object
                          properties:
                            id:
                              type: integer
                              example: 6
                            name:
                              type: string
                              example: Electronic
                            slug:
                              type: string
                              example: electronic
                        example:
                        - id: 6
                          name: Electronic
                          slug: electronic
                        - id: 3
                          name: Hip Hop
                          slug: hip-hop
                        - id: 4
                          name: R&B
                          slug: rnb
                      subgenres:
                        type: array
                        items:
                          type: object
                          properties:
                            id:
                              type: integer
                              example: 118
                            name:
                              type: string
                              example: Jazz Fusion
                            slug:
                              type: string
                              example: jazz-fusion
                        example:
                        - id: 118
                          name: Jazz Fusion
                          slug: jazz-fusion
                      playlist_type:
                        type: object
                        properties:
                          id:
                            type: integer
                            example: 3
                          name:
                            type: string
                            example: Indie Curator
        '400':
          description: invalid_request
        '404':
          description: not_found
        '500':
          description: internal_server_error
      operationId: getPlaylistAppleByChannelAppleByLinkID
      x-operation-id-source: derived
  /playlist-apple/{uuid}/details:
    get:
      summary: Apple Playlist’s Details
      tags:
      - General Apple Playlist
      description: Get detailed information about the apple playlist.
      parameters:
      - in: path
        name: uuid
        required: true
        description: "\n\nApple Playlist UUID \n\n*Example: `aeb4f1c8-192b-4927-8e2c-2d815f7def87`*"
        schema:
          type: string
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
                properties:
                  api_version:
                    type: string
                    example: v1.24.0
                  data:
                    type: object
                    properties:
                      uuid:
                        type: string
                        example: aeb4f1c8-192b-4927-8e2c-2d815f7def87
                      external_id:
                        type: string
                        example: pl.ed8779a7a70e479696817eb2b08d1486
                      name:
                        type: string
                        example: TT18 - Manu Delago
                      image:
                        type: string
                        example: https://is2-ssl.mzstatic.com/image/thumb/SG-S3-US-Std-Image-000001/v4/4b/57/4a/4b574a76-7ef8-5c16-b3a2-36a275e34851/image/500x500cc.jpg
                      curator:
                        type: string
                        example: Tru Thoughts
                      track_count:
                        type: integer
                        example: 49533
                      genres:
                        type: array
                        items:
                          type: object
                          properties:
                            id:
                              type: integer
                              example: 6
                            name:
                              type: string
                              example: Electronic
                            slug:
                              type: string
                              example: electronic
                        example:
                        - id: 6
                          name: Electronic
                          slug: electronic
                        - id: 3
                          name: Hip Hop
                          slug: hip-hop
                        - id: 4
                          name: R&B
                          slug: rnb
                      subgenres:
                        type: array
                        items:
                          type: object
                          properties:
                            id:
                              type: integer
                              example: 118
                            name:
                              type: string
                              example: Jazz Fusion
                            slug:
                              type: string
                              example: jazz-fusion
                        example:
                        - id: 118
                          name: Jazz Fusion
                          slug: jazz-fusion
                      playlist_type:
                        type: object
                        properties:
                          id:
                            type: integer
                            example: 3
                          name:
                            type: string
                            example: Indie Curator
        '400':
          description: invalid_request
        '404':
          description: not_found
        '500':
          description: internal_server_error
      operationId: getPlaylistAppleByUuidDetails
      x-operation-id-source: derived
components:
  securitySchemes:
    Access-Key:
      type: apiKey
      description: API key to authorize requests.
      name: Access-Key
      in: header
x-tagGroups:
- name: ''
  tags:
  - MCP Connection Guide
- name: ''
  tags:
  - Rate Limiting
- name: ''
  tags:
  - Viberate Entity IDs
- name: Artist
  tags:
  - General
  - Airplay
  - Beatport
  - Deezer
  - Facebook
  - Instagram
  - TikTok
  - Shazam
  - Social Media
  - Soundcloud
  - Spotify
  - Viberate
  - Youtube
  - Apple Music
- name: Track
  tags:
  - General Track
  - Airplay Track
  - Deezer Track
  - Facebook Track
  - Instagram Track
  - Twitter Track
  - TikTok Track
  - Shazam Track
  - Social Track
  - Soundcloud Track
  - Spotify Track
  - Apple Track
  - Viberate Track
  - Youtube Track
  - Trending Track
- name: Label
  tags:
  - General Label
  - Spotify Label
  - Viberate Label
- name: Event
  tags:
  - General Event
- name: Venue
  tags:
  - General Venue
  - Viberate Venue
- name: Spotify Playlist
  tags:
  - General Playlist
  - Viberate Playlist
- name: Apple Playlist
  tags:
  - General Apple Playlist
  - Viberate Apple Playlist
- name: Festival
  tags:
  - General Festival
  - Instagram Festival
  - TikTok Festival
  - Spotify Festival
  - Viberate Festival
  - Youtube Festival
- name: City
  tags:
  - General City
  - Viberate City