POST/api/v1/media/music/search

Music Search

Search Spotify for tracks, artists, and albums. Returns names, cover art, preview URLs, and metadata.

Authentication

All Media API requests require your gyramedia_ key in the Authorization header.

Authorization: Bearer gyramedia_xxxxxxxxxxxx

Example request

curl -X POST https://gyra.ng/api/v1/media/music/search \
  -H "Authorization: Bearer gyramedia_xxxxx" \
  -H "Content-Type: application/json" \
  -d '{
  "q": "Wizkid Essence",
  "type": "track",
  "limit": 10
}'

Response

200 OK · application/json

{
  "query": "Wizkid Essence",
  "type": "track",
  "count": 10,
  "results": [
    {
      "id": "5p1OvDeMBBMWvGj9xTa0VY",
      "name": "Essence",
      "artists": "Wizkid, Tems",
      "album": "Made in Lagos",
      "coverArt": "https://i.scdn.co/image/...",
      "previewUrl": "https://p.scdn.co/mp3-preview/...",
      "durationMs": 248000,
      "externalUrl": "https://open.spotify.com/track/..."
    }
  ],
  "balanceAfter": 4.10
}

Error codes

401invalid_api_keyMissing or revoked key

403wrong_categoryKey is not a media key

402insufficient_creditsWallet balance too low

429rate_limitedToo many requests

400invalid_requestMissing parameters