API docs

Jump to

Authentication · Search · Audio · Video · Limits · Errors

Authentication

Create a free key in your dashboard. Send it with every request, in one of two ways:

GET /api/search

For Search: finds songs by name and returns the matching results. Use it to show a list to your users.

Parameters

Request

GET https://nazriya.teamgod.online/api/search?q=aarzu&key=YOUR_KEY

Response 200

{
  "success": true,
  "results": [
    {
      "title": "Aarzu",
      "id": "VIDEO_ID",
      "duration": "3:45",
      "thumbnail": "https://...",
      "url": "https://..."
    }
  ]
}

Response is passed through exactly as the source returns it, so field names may be slightly different from this example.

Code

JavaScript
const r = await fetch("https://nazriya.teamgod.online/api/search?q=aarzu", { headers: { "x-api-key": "YOUR_KEY" } });
const data = await r.json();

Python
import requests
data = requests.get("https://nazriya.teamgod.online/api/search", params={"q": "aarzu", "key": "YOUR_KEY"}).json()

GET /api/audio

For Audio: returns the playable audio link for a song. Use it for audio players and music bots.

Parameters

Request

GET https://nazriya.teamgod.online/api/audio?q=aarzu&key=YOUR_KEY

Response 200

{
  "success": true,
  "title": "Aarzu",
  "duration": "3:45",
  "audio": "https://.../audio-link"
}

Response is passed through exactly as the source returns it, so field names may be slightly different from this example.

Code

JavaScript
const r = await fetch("https://nazriya.teamgod.online/api/audio?q=aarzu", { headers: { "x-api-key": "YOUR_KEY" } });
const data = await r.json();

Python
import requests
data = requests.get("https://nazriya.teamgod.online/api/audio", params={"q": "aarzu", "key": "YOUR_KEY"}).json()

GET /api/video

For Video: returns the playable video link for a song. Use it for video players and video chat bots.

Parameters

Request

GET https://nazriya.teamgod.online/api/video?q=aarzu&key=YOUR_KEY

Response 200

{
  "success": true,
  "title": "Aarzu",
  "duration": "3:45",
  "video": "https://.../video-link"
}

Response is passed through exactly as the source returns it, so field names may be slightly different from this example.

Code

JavaScript
const r = await fetch("https://nazriya.teamgod.online/api/video?q=aarzu", { headers: { "x-api-key": "YOUR_KEY" } });
const data = await r.json();

Python
import requests
data = requests.get("https://nazriya.teamgod.online/api/video", params={"q": "aarzu", "key": "YOUR_KEY"}).json()

Free plan limits

Failed requests are not counted against your quota. Need more? Contact @heartfailer for the paid plan.

Errors

{ "success": false, "error": "Invalid API key." }