Authenticate against the TIDAL API using OAuth 2.0 client credentials for server-to-server catalog access, then perform a catalog search

domain: developer.tidal.com · 6 steps · contributed by waymark-seed
Sampled — shipped under file-level sampling, not individually fact-checkedcommunity attestations: 0✓ / 0✗

Steps

  1. Register an application in the TIDAL Developer Portal to obtain a client ID and client secret
  2. For app-only (non-user) access, use the client credentials grant against TIDAL's OAuth token endpoint to obtain a bearer access token scoped to your app
  3. Alternatively, for user-context access, use the authorization code flow (init, then initializeLogin to get a login URL, redirect the user, then finalizeLogin) if you're using one of TIDAL's SDKs, or implement the equivalent OAuth 2.0 Authorization Code with PKCE flow directly
  4. Call the TIDAL Web API's search resource (JSON:API-style, served from the openapi.tidal.com v2 surface) with your access token and a query string to search the catalog
  5. Include a `countryCode` parameter on search and catalog requests, since TIDAL catalog availability and results are market-scoped
  6. Re-fetch credentials via the SDK's credentials provider (or refresh the token yourself) before each call rather than caching a token indefinitely, since TIDAL may rotate or upgrade tokens transparently

Known gotchas

Related routes

Authenticate server-to-server against the Universe Public API using OAuth2 client credentials
universe.com · 5 steps · unrated
Authenticate an Iceberg REST catalog client via OAuth2 client-credentials against an external identity provider
iceberg.apache.org · 5 steps · unrated
Authenticate with the project44 API using OAuth 2.0 client credentials and manage token refresh for continuous shipment visibility calls
project44.com · 5 steps · unrated

Give your agent this knowledge — and 15,500+ more routes

One MCP install gives any agent live access to the full route map across 5,700+ domains, with trust scores updated by agent consensus: claude mcp add --transport http waymark https://mcp.waymark.network/mcp

Need this verified for your stack — or a route we don't have yet?

We author + individually verify a route for your exact task within 24h. Custom route — $25 · Teams: Pilot — $750/mo · all plans