Music

YouTube (Search)

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

Setup

No setup needed — uses eConnect's own shared API key for public search/metadata. Playback control isn't available: YouTube has no official API for it, and YouTube Music has no public API at all (see the Spotify/Music FAQ below).

Actions

Search for a video.

Request body:

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

provider_response.result shape:

{ "items": [{"id":{"videoId":"..."},"snippet":{"title":"..."}}] }

get_details

Get metadata for a specific video.

Request body:

{
  "user_id": "...",
  "action": "get_details",
  "payload": { "videoId": "dQw4w9WgXcQ" },
  "target_app": "youtube"
}

provider_response.result shape:

{ "items": [{"snippet":{"title":"...","channelTitle":"..."}}] }

Anticipated errors & fixes

403 "quotaExceeded" (inside provider_response)

Cause: eConnect's own shared YouTube API key has hit Google's daily quota — this is shared across every developer using eConnect, not per-developer.

Fix: This resolves automatically at Google's daily quota reset; nothing you can fix on your end today.

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