جستجو فیلم در آپ تی وی

با استفاده از این وب‌سرویس میتوانید فیلم، سریال یا انیمیشن مورد نظر خود را در آپ تی وی جستجو کنید و با ارسال لینک هر عنوان، مشخصات کامل آن (امتیاز IMDb، عوامل، تریلر، کیفیت‌ها و حجم فایل‌ها، فصل‌ها و قسمت‌های سریال) را دریافت کنید.

مشخصات

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

متدهای HTTP

متد	مسیر	نوع ورودی
`GET`	`/apis-1/search-uptvs`	Query String

پارامترها

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

نام	نوع	الزامی	پیش‌فرض	توضیحات
`q`	`string`	بله	—	عنوان فیلم، سریال یا انیمیشن (حداکثر ۱۵۰ کاراکتر)؛ در صورت ارسال url لازم نیست
`url`	`string`	خیر	—	لینک صفحهٔ فیلم یا سریال در آپ‌تی‌وی (https://www.uptvs.com/contents/...) برای دریافت مشخصات کامل، کیفیت‌ها، فصل‌ها و لینک‌های دانلود
`page`	`integer`	خیر	`1`	شماره صفحهٔ نتایج (۱ تا ۵۰)
`limit`	`integer`	خیر	`15`	تعداد نتایج در هر صفحه (۱ تا ۳۰)

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

لینک مستقیم

GET https://open.nestapi.ir/apis-1/search-uptvs?q=%D8%A8%D8%AA%D9%85%D9%86

نمونه کد

cURL
PHP
Python
JavaScript

curl -X GET "https://open.nestapi.ir/apis-1/search-uptvs?q=%D8%A8%D8%AA%D9%85%D9%86"

<?php

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

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

$api = new NestApi();

try {
    $response = $api->searchUptvs(q: 'بتمن');

    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();
}

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

with NestApi() as api:
    try:
        response = api.search_uptvs(q="بتمن")

        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)

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

const api = new NestApi();

try {
  const response = await api.searchUptvs({ q: "بتمن" });

  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	پارامتر آمده ولی نوع، قالب یا بازه‌اش نادرست است
`INVALID_URL`	400	آدرس URL ارسالی نامعتبر است
`CONTENT_NOT_FOUND`	404	فیلم یا سریال موردنظر یافت نشد
`NO_RESULTS`	404	نتیجه‌ای برای عبارت موردنظر یافت نشد
`UPSTREAM_ERROR`	502	خطا در پاسخ دریافتی از سرویس بالادستی
`HTTP_CONNECTION_ERROR`	502	برقراری ارتباط با سرویس بالادستی ممکن نشد
`HTTP_TIMEOUT`	504	سرویس بالادستی در زمان مقرر پاسخ نداد

مشخصات​

متدهای HTTP​

پارامترها​

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

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

لینک مستقیم​

نمونه کد​

کدهای خطا​

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