← All platforms

Music

Deezer

target_app: "deezer" · endpoint /v1/music/execute · No credentials needed

Setup

No setup needed — Deezer's search/metadata API is public, no key required.

Actions

search

Search for a track.

Request body:

{
  "user_id": "...",
  "action": "search",
  "payload": { "query": "So Will I Hillsong Worship" },
  "target_app": "deezer"
}

provider_response.result shape:

{ "data": [{"id":123,"title":"...","artist":{"name":"..."}}] }

get_details

Get details for a specific track.

Request body:

{
  "user_id": "...",
  "action": "get_details",
  "payload": { "trackId": "3135556" },
  "target_app": "deezer"
}

provider_response.result shape:

{ "id": 3135556, "title": "...", "artist": {...} }

Anticipated errors & fixes

Empty results for a track that exists

Cause: Deezer's catalog availability varies by country/licensing — a track can be missing in some regions.

Fix: Try a broader query, or accept that some tracks genuinely aren't in Deezer's catalog for all regions.

401 "Unauthorized: Invalid API key."

Cause: Your eConnect Authorization header is missing, malformed, or the key was regenerated/revoked.

Fix: Copy your api_key fresh from the eConnect dashboard and confirm the header reads exactly "Authorization: Bearer <key>".

429 "Too many requests"

Cause: You've exceeded your plan's per-minute rate limit.

Fix: Wait a minute and retry, or upgrade your plan for a higher per-minute limit.

429 "Monthly API limit exceeded"

Cause: You've used your plan's full monthly request allowance.

Fix: Wait for your next billing cycle reset, or upgrade to a plan with a higher monthly limit.

← Back to all platforms