TIDAL

aid: tidal
url: https://raw.githubusercontent.com/api-evangelist/tidal/refs/heads/main/apis.yml
apis:
- aid: tidal:tidal-catalog-api
  name: TIDAL Catalog API
  tags:
  - Music
  - Catalog
  - Albums
  - Artists
  - Tracks
  - Videos
  humanURL: https://developer.tidal.com/documentation/api-sdk/api-sdk-overview
  properties:
  - url: https://developer.tidal.com/documentation/api-sdk/api-sdk-overview
    type: Documentation
  - url: https://tidal-music.github.io/tidal-api-reference/
    type: Documentation
  - url: openapi/tidal-catalog-api-openapi.yml
    type: OpenAPI
  - url: json-schema/tidal-album-schema.json
    type: JSONSchema
  - url: json-schema/tidal-artist-schema.json
    type: JSONSchema
  - url: json-schema/tidal-track-schema.json
    type: JSONSchema
  - url: json-ld/tidal-context.jsonld
    type: JSONLD
  - type: NaftikoCapability
    url: capabilities/catalog-albums.yaml
  - type: NaftikoCapability
    url: capabilities/catalog-artists.yaml
  - type: NaftikoCapability
    url: capabilities/catalog-tracks.yaml
  - type: NaftikoCapability
    url: capabilities/catalog-videos.yaml
  description: Browse TIDAL's high-fidelity music catalog. Resource-oriented JSON:API surface for albums, artists,
    tracks, videos, genres, lyrics, credits, artworks, providers, and biographies, with cursor pagination,
    sparse fieldsets, sort, filter, and JSON:API `include` relationship traversal.
- aid: tidal:tidal-search-api
  name: TIDAL Search API
  tags:
  - Music
  - Search
  - Suggestions
  humanURL: https://developer.tidal.com/documentation/api-sdk/api-sdk-overview
  properties:
  - url: https://developer.tidal.com/documentation/api-sdk/api-sdk-overview
    type: Documentation
  - url: openapi/tidal-search-api-openapi.yml
    type: OpenAPI
  - type: NaftikoCapability
    url: capabilities/search-search-results.yaml
  - type: NaftikoCapability
    url: capabilities/search-suggestions.yaml
  - type: NaftikoCapability
    url: capabilities/search-history.yaml
  description: Search the TIDAL catalog with personalized search results, type-ahead suggestions, and per-user
    search history. Supports filtering by entity type and respects user locale and country.
- aid: tidal:tidal-playlists-api
  name: TIDAL Playlists API
  tags:
  - Music
  - Playlists
  humanURL: https://developer.tidal.com/documentation/api-sdk/api-sdk-overview
  properties:
  - url: https://developer.tidal.com/documentation/api-sdk/api-sdk-overview
    type: Documentation
  - url: openapi/tidal-playlists-api-openapi.yml
    type: OpenAPI
  - url: json-schema/tidal-playlist-schema.json
    type: JSONSchema
  - type: NaftikoCapability
    url: capabilities/playlists-playlists.yaml
  description: Create, read, update, delete, and reorder TIDAL playlists. Manage playlist items, cover art,
    owners, and editorial vs. user-created classifications. Requires playlists.read and playlists.write scopes.
- aid: tidal:tidal-users-api
  name: TIDAL Users API
  tags:
  - Users
  - Accounts
  - Terms
  humanURL: https://developer.tidal.com/documentation/api-sdk/api-sdk-overview
  properties:
  - url: https://developer.tidal.com/documentation/api-sdk/api-sdk-overview
    type: Documentation
  - url: openapi/tidal-users-api-openapi.yml
    type: OpenAPI
  - url: json-schema/tidal-user-schema.json
    type: JSONSchema
  - type: NaftikoCapability
    url: capabilities/users-users.yaml
  - type: NaftikoCapability
    url: capabilities/users-terms.yaml
  - type: NaftikoCapability
    url: capabilities/users-clients.yaml
  description: User account management surface. Read user profile and country, manage accepted terms, list
    registered installations and clients, submit user reports, and request data exports for GDPR/CCPA compliance.
- aid: tidal:tidal-user-collections-api
  name: TIDAL User Collections API
  tags:
  - Users
  - Collections
  - Library
  - My Collection
  humanURL: https://developer.tidal.com/documentation/api-sdk/api-sdk-overview
  properties:
  - url: https://developer.tidal.com/documentation/api-sdk/api-sdk-overview
    type: Documentation
  - url: openapi/tidal-user-collections-api-openapi.yml
    type: OpenAPI
  - type: NaftikoCapability
    url: capabilities/user-collections-albums.yaml
  - type: NaftikoCapability
    url: capabilities/user-collections-artists.yaml
  - type: NaftikoCapability
    url: capabilities/user-collections-tracks.yaml
  - type: NaftikoCapability
    url: capabilities/user-collections-playlists.yaml
  - type: NaftikoCapability
    url: capabilities/user-collections-videos.yaml
  - type: NaftikoCapability
    url: capabilities/user-collections-folders.yaml
  description: "TIDAL's My Collection — the user's saved albums, artists, tracks, videos, playlists, folders,
    and save-for-later items. Add, remove, organize into folders, and traverse the collection via JSON:API
    relationships. Requires collection.read/write scopes."
- aid: tidal:tidal-recommendations-api
  name: TIDAL Recommendations API
  tags:
  - Music
  - Recommendations
  - Mixes
  - Personalization
  - Discovery
  humanURL: https://developer.tidal.com/blog/discover-explore-play-tidals-recommendation-apis-unraveled
  properties:
  - url: https://developer.tidal.com/blog/discover-explore-play-tidals-recommendation-apis-unraveled
    type: Documentation
  - url: openapi/tidal-recommendations-api-openapi.yml
    type: OpenAPI
  - type: NaftikoCapability
    url: capabilities/recommendations-user-recommendations.yaml
  - type: NaftikoCapability
    url: capabilities/recommendations-daily-mixes.yaml
  - type: NaftikoCapability
    url: capabilities/recommendations-discovery-mixes.yaml
  - type: NaftikoCapability
    url: capabilities/recommendations-new-release-mixes.yaml
  - type: NaftikoCapability
    url: capabilities/recommendations-dynamic-pages.yaml
  description: Personalized recommendations powered by TIDAL's algorithmic mixes. Daily Mix, Discovery Mix,
    New Release Mix, and Offline Mix, plus dynamic editorial pages and modules curated for the user. Requires
    recommendations.read scope.
- aid: tidal:tidal-playback-api
  name: TIDAL Playback API
  tags:
  - Music
  - Playback
  - Streaming
  - Hi-Fi
  - HiRes
  - Manifests
  - Downloads
  humanURL: https://developer.tidal.com/documentation/api-sdk/api-sdk-overview
  properties:
  - url: https://developer.tidal.com/documentation/api-sdk/api-sdk-overview
    type: Documentation
  - url: https://github.com/tidal-music/tidal-sdk
    type: Documentation
  - url: openapi/tidal-playback-api-openapi.yml
    type: OpenAPI
  - type: NaftikoCapability
    url: capabilities/playback-play-queues.yaml
  - type: NaftikoCapability
    url: capabilities/playback-track-manifests.yaml
  - type: NaftikoCapability
    url: capabilities/playback-video-manifests.yaml
  - type: NaftikoCapability
    url: capabilities/playback-downloads.yaml
  description: Playback prerequisites — play queues, encrypted track manifests (HLS/DASH with HI_RES_LOSSLESS,
    LOSSLESS, HIGH, LOW quality tiers), video manifests, offline tasks, downloads, and usage rules. Per TIDAL
    policy, audio bytes flow exclusively through the official TIDAL Player SDK; the Playback API only issues
    signed manifests. Requires playback scope.
- aid: tidal:tidal-social-api
  name: TIDAL Social API
  tags:
  - Music
  - Social
  - Sharing
  - Comments
  - Reactions
  humanURL: https://developer.tidal.com/documentation/api-sdk/api-sdk-overview
  properties:
  - url: https://developer.tidal.com/documentation/api-sdk/api-sdk-overview
    type: Documentation
  - url: openapi/tidal-social-api-openapi.yml
    type: OpenAPI
  - type: NaftikoCapability
    url: capabilities/social-shares.yaml
  - type: NaftikoCapability
    url: capabilities/social-comments.yaml
  - type: NaftikoCapability
    url: capabilities/social-reactions.yaml
  - type: NaftikoCapability
    url: capabilities/social-appreciations.yaml
  description: TIDAL's social surface — shares, saved shares, DSP sharing links (deep links to TIDAL content
    from other DSPs), comments, reactions, and artist appreciations across albums, artists, tracks, videos,
    and playlists.
- aid: tidal:tidal-commerce-api
  name: TIDAL Commerce API
  tags:
  - Music
  - Commerce
  - Purchases
  - Pricing
  - Stripe
  - Square
  humanURL: https://developer.tidal.com/documentation/api-sdk/api-sdk-overview
  properties:
  - url: https://developer.tidal.com/documentation/api-sdk/api-sdk-overview
    type: Documentation
  - url: openapi/tidal-commerce-api-openapi.yml
    type: OpenAPI
  - type: NaftikoCapability
    url: capabilities/commerce-purchases.yaml
  - type: NaftikoCapability
    url: capabilities/commerce-price-configurations.yaml
  - type: NaftikoCapability
    url: capabilities/commerce-stripe-connections.yaml
  description: TIDAL's marketplace and creator-commerce surface — direct fan purchases of music, artist
    price configurations, Stripe and Square connections (reflecting TIDAL's Block / Square parentage), and
    Stripe dashboard links for connected artists.
- aid: tidal:tidal-claims-api
  name: TIDAL Claims API
  tags:
  - Music
  - Claims
  - Artists
  - Verification
  - Rights
  humanURL: https://developer.tidal.com/documentation/api-sdk/api-sdk-overview
  properties:
  - url: https://developer.tidal.com/documentation/api-sdk/api-sdk-overview
    type: Documentation
  - url: openapi/tidal-claims-api-openapi.yml
    type: OpenAPI
  - type: NaftikoCapability
    url: capabilities/claims-artist-claims.yaml
  - type: NaftikoCapability
    url: capabilities/claims-content-claims.yaml
  - type: NaftikoCapability
    url: capabilities/claims-manual-artist-claims.yaml
  description: Artist verification and content rights claims for the TIDAL Artist platform. Artists claim
    profiles, content owners assert ownership of catalog items, and TIDAL operations review manual claim
    workflows.
name: TIDAL
tags:
- Music
- Streaming
- Hi-Fi
- HiRes Lossless
- Audio
- Block
- Square
kind: contract
image: https://kinlane-productions2.s3.amazonaws.com/apis-json/apis-json-logo.jpg
access: 3rd-Party
common:
- type: Portal
  url: https://tidal.com
- type: Documentation
  url: https://developer.tidal.com
- type: Documentation
  url: https://developer.tidal.com/documentation
- type: Documentation
  url: https://tidal-music.github.io/tidal-api-reference/
- type: GettingStarted
  url: https://developer.tidal.com/documentation/api-sdk/api-sdk-quick-start
- type: Authentication
  url: https://developer.tidal.com/documentation/api-sdk/api-sdk-authorization
- type: SignUp
  url: https://developer.tidal.com/dashboard
- type: TermsOfService
  url: https://developer.tidal.com/documentation/guidelines/guidelines-developer-terms
- type: Documentation
  url: https://developer.tidal.com/documentation/guidelines-developer-guidelines-2_0
- type: Documentation
  url: https://developer.tidal.com/documentation/guidelines/guidelines-design-guidelines
- type: Documentation
  url: https://developer.tidal.com/documentation/api-sdk/api-sdk-manage-apps
- type: Blog
  url: https://developer.tidal.com/blog
- type: Blog
  url: https://tidal.com/magazine
- type: PrivacyPolicy
  url: https://tidal.com/privacy
- type: TermsOfService
  url: https://tidal.com/terms
- type: StatusPage
  url: https://status.tidal.com
- type: GitHubOrganization
  url: https://github.com/tidal-music
- type: SDK
  url: https://github.com/tidal-music/tidal-sdk-web
  name: TIDAL SDK for Web (TypeScript)
- type: SDK
  url: https://github.com/tidal-music/tidal-sdk-ios
  name: TIDAL SDK for iOS (Swift)
- type: SDK
  url: https://github.com/tidal-music/tidal-sdk-android
  name: TIDAL SDK for Android (Kotlin)
- type: SDK
  url: https://github.com/tidal-music/tidal-sdk
  name: TIDAL SDK (overview)
- type: Tool
  url: https://github.com/tidal-music/embed-player
  name: TIDAL Embed Player
- type: Tool
  url: https://github.com/tidal-music/tidal-algorithmic-mixes
  name: TIDAL Algorithmic Mixes (Python)
- type: Tool
  url: https://github.com/tidal-music/networktime
  name: networktime (SNTP client, Kotlin Multiplatform)
- type: Tool
  url: https://github.com/tidal-music/openapi-generator
  name: OpenAPI Generator (TIDAL fork)
- type: Tool
  url: https://github.com/tidal-music/eslint-config-tidal
  name: TIDAL ESLint Config
- type: Forum
  url: https://github.com/tidal-music/discussions
  name: TIDAL Developer Discussions
- type: Documentation
  url: https://developer.tidal.com/documentation/open-source
  name: Open source at TIDAL
- url: https://tidal.com/pricing
  data:
  - id: free
    name: Free
    entries:
    - geo: US
      unit: 1
      label: User
      limit: 1
      price: 0
      metric: user
      timeFrame: month
      description: Ad-supported free tier with limited audio quality.
    elements:
    - name: Ad-supported listening
    - name: Limited skips and shuffle-only on some content
    - name: Standard audio quality
    description: Free ad-supported listening.
  - id: individual
    name: Individual
    entries:
    - geo: US
      unit: 1
      label: User
      limit: 1
      price: 10.99
      metric: user
      timeFrame: month
      description: Single-user Hi-Fi plan.
    elements:
    - name: HiRes Lossless (FLAC up to 192 kHz / 24-bit)
    - name: Dolby Atmos Music
    - name: Offline listening
    - name: Ad-free
    - name: DJ extensions and crossfade
    description: Hi-Fi streaming for one listener.
  - id: family
    name: Family
    entries:
    - geo: US
      unit: 1
      label: Plan
      limit: 6
      price: 16.99
      metric: user
      timeFrame: month
      description: Up to 6 family members on a single Hi-Fi plan.
    elements:
    - name: HiRes Lossless for up to 6 family members
    - name: Dolby Atmos Music
    - name: Offline listening per member
    - name: Individual recommendations per profile
    description: Hi-Fi streaming for the whole household.
  - id: student
    name: Student
    entries:
    - geo: US
      unit: 1
      label: User
      limit: 1
      price: 4.99
      metric: user
      timeFrame: month
      description: Discounted Hi-Fi plan for verified students.
    elements:
    - name: HiRes Lossless
    - name: Dolby Atmos Music
    - name: SheerID verification required
    description: Hi-Fi streaming for verified students.
  - id: dj
    name: DJ
    entries:
    - geo: US
      unit: 1
      label: User
      limit: 1
      price: 19.99
      metric: user
      timeFrame: month
      description: Adds DJ Extensions to the Individual plan.
    elements:
    - name: HiRes Lossless
    - name: DJ Extensions for Serato, Rekordbox, djay, VirtualDJ, Engine DJ
    - name: Beatgrid, cue, and key metadata
    description: Hi-Fi streaming with DJ software integrations.
  name: Plans
  type: Plans
- url: plans/tidal-plans-pricing.yml
  type: Plans
- url: rate-limits/tidal-rate-limits.yml
  type: RateLimits
- url: finops/tidal-finops.yml
  type: FinOps
- type: Features
  data:
  - JSON:API-compliant catalog spanning albums, artists, tracks, videos, genres, lyrics, credits, and artwork
  - HiRes Lossless audio (FLAC up to 192 kHz / 24-bit) and Dolby Atmos Music for premium tiers
  - 100M+ track catalog with high-quality metadata, credits, and lyrics
  - Personalized Daily Mixes, Discovery Mix, New Release Mix, and Offline Mix recommendations
  - User Collections (My Collection) — albums, artists, playlists, tracks, videos, folders, save-for-later
  - Playback via signed track and video manifests (HLS / DASH) restricted to the TIDAL Player SDK
  - Search with personalized results, type-ahead suggestions, and per-user search history
  - Social surface — shares, comments, reactions, appreciations, and DSP sharing deep-links
  - Creator commerce — direct fan purchases, artist price configurations, Stripe and Square connections
  - Artist platform — artist claims, content claims, and manual artist verification workflows
  - OAuth 2.0 Authorization Code with PKCE (user-context) and Client Credentials (server-to-server)
  - Granular OAuth scopes — collection.read/write, playlists.read/write, playback, recommendations.read,
    search.read/write, user.read, entitlements.read
  - Official SDKs for Web (TypeScript), iOS (Swift), and Android (Kotlin)
  - Embed Player for in-page TIDAL playback on third-party sites
  - Open-source algorithmic mixes (Python) and OpenAPI generator fork
  - JSON:API features — cursor pagination, sparse fieldsets, sort, filter, compound documents via `include`
  - Single canonical OpenAPI spec aggregating 240+ paths and 320+ operations published at developer.tidal.com
  sources:
  - https://developer.tidal.com/documentation/api-sdk/api-sdk-overview
  - https://tidal-music.github.io/tidal-api-reference/
  - https://github.com/tidal-music
  - https://tidal.com/pricing
  updated: '2026-05-25'
created: '2026-05-25'
modified: '2026-05-25'
position: Consuming
description: TIDAL is a high-fidelity music streaming service owned by Block (Square's parent, acquired 2021)
  offering HiRes Lossless FLAC audio up to 192 kHz / 24-bit and Dolby Atmos Music across a 100M+ track catalog.
  TIDAL's developer platform exposes a unified JSON:API web API at openapi.tidal.com/v2 covering catalog
  metadata, personalized recommendations, playlists, user collections, playback manifests, search, social
  features, creator commerce, and artist claims. Playback bytes are restricted to the official TIDAL Player
  SDK for Web, iOS, and Android. All APIs use OAuth 2.0 — Authorization Code with PKCE for user-context flows
  and Client Credentials for server-to-server use. TIDAL also operates the TIDAL Embed Player and the
  open-source tidal-music GitHub organization.
maintainers:
- FN: Kin Lane
  email: [email protected]
  X: apievangelist
  url: https://apievangelist.com
specificationVersion: '0.16'