یوتیوب دانلودر

با استفاده از این وب سرویس میتوانید انواع ویدیو را از یوتیوب با کیفیت دلخواه یا فقط صوت دریافت کنید.

مشخصات

مشخصه	مقدار
دسته‌بندی	دانلودر
وضعیت	فعال
نسخه API	apis-2
فرمت پاسخ	JSON
آدرس پایه	https://open.nestapi.ir
مسیر	/apis-2/youtube-downloader
لینک کامل	https://open.nestapi.ir/apis-2/youtube-downloader

متدهای HTTP

متد	مسیر	نوع ورودی
GET	/apis-2/youtube-downloader	Query String

پارامترها

پارامترهای Query String

نام	نوع	الزامی	پیش‌فرض	توضیحات
url	string	بله	—	لینک ویدیو، شورتس، لینک کوتاه یا شناسه ویدیوی یوتیوب
quality	string	خیر	—	کیفیت خروجی: best، 2160p، 1440p، 1080p، 720p، 480p، 360p یا audio

نمونه درخواست

لینک مستقیم

GET https://open.nestapi.ir/apis-2/youtube-downloader?url=https://www.youtube.com/watch%3Fv%3DdQw4w9WgXcQ

نمونه کد

cURL

curl -X GET "https://open.nestapi.ir/apis-2/youtube-downloader?url=https://www.youtube.com/watch%3Fv%3DdQw4w9WgXcQ"

PHP

<?php

// composer require nestapi/nestapi
require 'vendor/autoload.php';

use NestApi\NestApi;
use NestApi\Exception\ApiException;
use NestApi\Exception\TransportException;

$api = new NestApi(version: 2);

try {
    $response = $api->youtubeDownloader(url: 'https://www.youtube.com/watch?v=dQw4w9WgXcQ');

    print_r($response->data);
} catch (ApiException $e) {
    // Error reported by the API (validation, not found, rate limit, ...)
    echo $e->getMessage();
} catch (TransportException $e) {
    // Network error or unusable response; not a subclass of ApiException
    echo 'Network error: ' . $e->getMessage();
}

Python

# pip install nestapi-py
from nestapi import ApiError, NestApi, TransportError

with NestApi(version=2) as api:
    try:
        response = api.youtube_downloader(url="https://www.youtube.com/watch?v=dQw4w9WgXcQ")

        print(response.data)
    except ApiError as e:
        # Error reported by the API (validation, not found, rate limit, ...)
        print(e.error_code, e)
    except TransportError as e:
        # Network error or unusable response; not a subclass of ApiError
        print("Network error:", e)

JavaScript

// npm install @devh3n/nestapi
import { ApiError, NestApi, TransportError } from "@devh3n/nestapi";

const api = new NestApi({ version: 2 });

try {
  const response = await api.youtubeDownloader({ url: "https://www.youtube.com/watch?v=dQw4w9WgXcQ" });

  console.log(response.data);
} catch (error) {
  if (error instanceof ApiError) {
    // Error reported by the API (validation, not found, rate limit, ...)
    console.error(error.errorCode, error.message);
  } else if (error instanceof TransportError) {
    // Network error or unusable response; not a subclass of ApiError
    console.error("Network error:", error.message);
  }
}

کدهای خطا

کد	وضعیت	علت
NOT_FOUND	404	مسیر وجود ندارد، یا متد روی آن ثبت نشده
PARAM_NOT_FOUND	400	پارامتر لازم ارسال نشده
VALIDATION_ERROR	422	پارامتر آمده ولی نوع، قالب یا بازه‌اش نادرست است
SERVICE_UNAVAILABLE	502	خطا در پردازش درخواست یا استخراج فایل‌های قابل دانلود

لینک های بیشتر

• راهنمای اتصال به سرویس
• فرمت خروجی موفقیت API
• فرمت خروجی خطای API
• کدهای خطای عمومی