# Supadata بديل لـ YouTube البيانات

قارن YouTube تكاليف النسخ والبيانات التعريفية وميزات التسميات التوضيحية الأصلية والوصول إلى الوكيل. قم بالترحيل من Supadata باستخدام أمثلة Python وBash القابلة للتشغيل.

Supadata حقائق تمت مراجعتها 2026-11-10. FlashData الأسعار والبدلات التجريبية تستخدم كتالوجاتها العامة الحالية.

- [الميزات](#features)
- [مقارنة التكاليف](#costs)
- [ترحيل النص](#migration)
- [البيانات الوصفية والجملة](#workflows)
- [لوكلاء الذكاء الاصطناعي](#agents)
- [الأسئلة الشائعة](#faq)

<a id="features"></a>
## مقارنة الميزات

للتطبيقات والوكلاء الذين يجمعون YouTube التسميات التوضيحية والبيانات الوصفية الحالية.

### حافظ على دفع YouTube استرجاع اقتصادي

| ميزة | FlashData | Supadata |
| --- | --- | --- |
| الاستخدام المدفوع بدون اشتراك | نعم — اعتمادات الدفع أولاً بأول؛ مشتريات من $10 | الخطط المدفوعة — Basic: $60/سنة · Pro: $17/شهر |
| النص الأصلي أو البيانات الوصفية · السعر لكل 1,000 | $0.50 — ادفع حسب الاستخدام · لا توجد رسوم شهرية | $5.67 على Pro — $17 / 3,000 included credits; full allowance مستعمل |
| دفعة بدون خطة شهرية | ما يصل إلى 100 استفسار / دفعة — مفتاح المالك للدفع أولاً بأول؛ الحد التجريبي منفصل | Pro وما فوق — فيديو ونص batch نقاط النهاية |

### ابحث عن مقاطع الفيديو وقم ببناء مكتبة بحثية

| ميزة | FlashData | Supadata |
| --- | --- | --- |
| البحث عن مقاطع الفيديو حسب الموضوع | نعم — البحث عن الكلمات الرئيسية مع مرشحات التاريخ والمدة والنوع والفرز | نعم — البحث عن مقاطع الفيديو والقنوات وقوائم التشغيل باستخدام المرشحات |
| قم بتحديث البيانات الوصفية للفيديو دون جلب التسميات التوضيحية | نعم — العنوان والقناة والمدة والصور المصغرة وأعداد المشاركة | نعم — نقطة نهاية منفصلة للبيانات الوصفية مع حقول المؤلف والوسائط والإحصائيات |
| لغات التسميات التوضيحية في البيانات الوصفية للفيديو | نعم — hasTranscripts و transcriptLanguages | في الرد النصي — availableLangs; مخطط بيانات تعريف منفصل |

### احتفظ بالنصوص المفيدة للاستشهادات والتحليل

| ميزة | FlashData | Supadata |
| --- | --- | --- |
| نص ذو طابع زمني لاستشهادات المصدر | JSON شرائح في ثواني — النص مع أوقات البداية والنهاية | JSON قطع بالمللي ثانية — النص مع الإزاحة والمدة |
| النص الكامل والطوابع الزمنية من نفس الرد | نعم — fullText ويتم إرجاع القطع معًا | اختر النص أو القطع — text=true يُرجع سلسلة؛ وإلا انضم إلى الأجزاء الموجودة في تطبيقك |
| لغات التسميات التوضيحية المتعددة الموجودة في طلب واحد | ما يصل إلى 10 لغة — المسارات والأخطاء لكل لغة | لغة مفضلة واحدة — lang على نقطة نهاية النص |
| حدد التسميات التوضيحية المقدمة من القائم بالتحميل أو التي تم إنشاؤها بواسطة YouTube | نعم — صريح params.auto=false أو true | لم يتم توثيق محدد الأصل — يحدد الوضع الاسترجاع الأصلي مقابل إنشاء الذكاء الاصطناعي |
| التعامل مع التسميات التوضيحية غير المتاحة بشكل صريح | المسارات الموجودة فقط — تقوم مصفوفات اللغة بإرجاع المسارات بالإضافة إلى الأخطاء؛ لا النسخ الجديد | اختر خيارًا احتياطيًا أصليًا أو AI — يمكن للوضع = التلقائي إنشاء تحويل الكلام إلى نص؛ استرجاع الحدود الأصلية للتسميات التوضيحية الموجودة |

### الانتقال من طلب واحد إلى سير عمل قابل للتكرار

| ميزة | FlashData | Supadata |
| --- | --- | --- |
| الطلبات التفاعلية والخلفية | الوقت الحقيقي أو async — اختر وضع التنفيذ واحفظ المهمة ID | نتيجة أو نسخة العمل — HTTP 200 إرجاع البيانات؛ HTTP 202 يرجع شغل ID |
| معالجة قائمة معدة من مقاطع الفيديو | دفعة API أو Bulk Jobs وحدة التحكم — قم بتحميل ملف ID؛ احتفظ بأجزاء البيان والنتيجة | غير متزامن batch API · Pro+ — يقبل قوائم الفيديو أو قوائم التشغيل أو القنوات |
| اجمع قائمة تشغيل أو قناة كاملة | توريد فيديو صريح IDs — قم بإعداد القائمة قبل المعالجة المجمعة أو المجمعة | أشرطة فيديو من طراز قائمة التشغيل أو القناة batch الإدخال — Regular videos; excludes Shorts and live |
| الإخراج للتطبيقات وLLMs | JSON، نص عادي أو Markdown — اختر الرد وتنسيق المحتوى | JSON بالنص أو القطع — استخدم محتوى النص في التطبيق الخاص بك أو المطالبة |
| حزم SDK للغة | Python، TypeScript وانطلق | Python و JavaScript / TypeScript |
| MCP وصول لمضيف الوكيل | نعم — جهاز التحكم عن بعد MCP مع OAuth أو مفتاح API | نعم — MCP خادم مع Supadata بيانات الاعتماد |
| تجربة برمجية قبل تسجيل المالك | نعم — ما يصل إلى 100 طلبات النسخ الأصلية · 72 ساعة | الحساب API مفتاح أولا — 100 رصيد مجاني كل شهر بعد الاشتراك |

Supadata يدعم النسخ الناتج عن الذكاء الاصطناعي ومنصات اجتماعية متعددة. تقوم نقاط نهاية التسمية التوضيحية FlashData باسترداد المسارات YouTube الموجودة. تقدم كلتا الخدمتين MCP وSDK.

### احتفظ بعبء عمل بحثي صغير في متناول الجميع

ادفع مقابل YouTube طلبات البيانات التي تستخدمها. أضف اشتراكًا لاحقًا إذا كان السعر الأقل والرصيد المضمن يناسب حجمك.

[سعر عبء العمل الخاص بك](#costs)

### حافظ على مصدر التسمية التوضيحية صريحًا

حدد YouTube التسميات التوضيحية التي تم إنشاؤها أو المقدمة من القائم بالتحميل، واحتفظ باللغة التي تم إرجاعها واحتفظ بالطوابع الزمنية للاستشهادات. اطلب المسارات الموجودة بعدة لغات دون إنشاء تحويل جديد للكلام إلى نص.

[خريطة قارئ النص الخاص بك](#migration)

### تنمو من فيديو واحد إلى خط أنابيب

استخدم نفس شكل الطلب للعمل realtime و async و batch. أضف Google البحث إلى سير عمل البحث باستخدام نفس الحساب والرصيد المشترك.

[بناء الخطوة التالية](#workflows)

<a id="costs"></a>
## سعر سير عمل الفيديو الكامل

USD. نسخة أصلية واحدة بلغة واحدة أو بحث واحد عن البيانات الوصفية هو طلب واحد ورصيد Supadata واحد. البيانات الوصفية بالإضافة إلى النص الأصلي عبارة عن طلبين لكل فيديو. FlashData يستخدم كتالوج بيانات YouTube المباشر، مع تطبيق قيمة الرصيد المضمن قبل الاستخدام الإضافي. معدل الوحدة المعروض هو معدل الاستخدام؛ Supadata هي رسوم الخطة مقسومة على المبلغ الشهري الكامل. Basic سنوي فقط: $60 مدفوع مقدمًا، كما هو موضح كـ $5/شهر يعادل 300 رصيدًا كل شهر، وليس 3,600 متاحًا على الفور. تستخدم خطط Supadata الأخرى قائمة الأسعار الشهرية. يتم إيقاف إعادة الشحن التلقائي في هذا التقدير حتى يتم تحديده؛ عند اختيارها، فإن أصغر الحزم المنشورة الكاملة تغطي النقص. قد يتم شراء توقيت إعادة الشحن التلقائي الفعلي مبكرًا. لا تفترض مبالغ الشراء وجود رصيد ابتدائي. FlashData عمليات إعادة التعبئة تبدأ من $10؛ عملية الشراء قد تترك أموالاً لوقت لاحق. Supadata الاعتمادات الشهرية لا تتجدد. يتم استبعاد الاعتمادات التجريبية والضرائب واستخدامات API الأخرى والخصومات السنوية على الخطط الأخرى وتوليد الذكاء الاصطناعي والترجمة. عند صفر طلبات، تبقى رسوم الخطة المحددة، والسعر الفعلي غير محدد.

### FlashData YouTube خطط البيانات

| FlashData خطة | لكل 1,000 طلبات | الرسوم الشهرية | الطلبات المشمولة شهريًا |
| --- | --- | --- | --- |
| الدفع حسب الاستخدام | $0.50 | $0.00 | 0 |
| Micro | $0.40 | $49.00 | 125,000 |
| Starter | $0.35 | $199.00 | 571,428 |
| Pro | $0.30 | $499.00 | 1,666,666 |
| Scale | $0.25 | $999.00 | 4,000,000 |
| Business | $0.20 | $1,999.00 | 10,000,000 |

[تسعير البيانات YouTube كامل](https://flashdata.dev/ar/pricing/youtube-data)

### Supadata الخطط المنشورة

| Supadata خطة | خطة الدفع | الاعتمادات / الشهر | لكل 1,000 بالبدل الكامل | حزمة إعادة الشحن التلقائي |
| --- | --- | --- | --- | --- |
| مجاني | $0.00 / شهر | 100 | $0.00 | غير متوفر |
| Basic · annual only | $60.00 / سنة ($5.00 / ما يعادل شهر) | 300 | $16.67 | $10.00 / 1,000 رصيد |
| Pro · monthly | $17.00 / شهر | 3,000 | $5.67 | $10.00 / 1,000 رصيد |
| Mega · monthly | $47.00 / شهر | 30,000 | $1.57 | $10.00 / 5,000 رصيد |
| Giga · monthly | $297.00 / شهر | 300,000 | $0.99 | $20.00 / 20,000 رصيد |
| Supa · monthly | $897.00 / شهر | 1,000,000 | $0.90 | $20.00 / 20,000 رصيد |

### مثال: البيانات الوصفية بالإضافة إلى النص الأصلي لكل فيديو

FlashData ادفع حسب الاستخدام مقابل Supadata Mega شهريًا، مع تضمين إعادة الشحن التلقائي. هذه مقارنة واضحة للخطة؛ حدد خططًا أخرى بشكل مستقل في الآلة الحاسبة HTML.

| فيديوهات / شهر | طلبات البيانات | FlashData الاستخدام النموذجي | Supadata Mega + عبوات شحن كاملة | حزم إعادة الشحن |
| --- | --- | --- | --- | --- |
| 100 | 200 | $0.10 | $47.00 | 0 |
| 1,000 | 2,000 | $1.00 | $47.00 | 0 |
| 10,000 | 20,000 | $10.00 | $47.00 | 0 |
| 100,000 | 200,000 | $100.00 | $387.00 | 34 |

### حرية الوصول وتوليد الذكاء الاصطناعي

Supadata عبوات مجانية 100 رصيد شهري. يستخدم نصه الأصلي رصيدًا واحدًا؛ يستخدم جيل الذكاء الاصطناعي رصيدين في الدقيقة. وبالتالي فإن النص الذي تم إنشاؤه لمدة 30 دقيقة يستخدم 60 رصيدًا. يمكن أن يؤدي الوضع التلقائي الافتراضي إلى تشغيل عملية الإنشاء؛ mode=native يتجنب هذا الإجراء الاحتياطي. يتم استبعاد الإنشاء والترجمة والبحث الموسع من هذه المقارنة.

يمكن للاشتراكات المؤهلة التي تم التحقق منها FlashData الحصول على بدل أولي يصل إلى 4,000 قياسي YouTube طلبات البيانات. إنها ليست طبقة مجانية شهرية.

<a id="migration"></a>
## ترحيل قارئ النص الأصلي

| التغيير | Supadata | FlashData | ماذا تفعل |
| --- | --- | --- | --- |
| طلب | GET /v1/transcript مع عنوان url واللغة والنص والوضع | POST /v1/queries/realtime مع المصدر و video_id و المعلمات | استخرج الحرف 11 YouTube ID. مفتاح Supadata لا يصادق على FlashData. |
| المصادقة | x-api-key: مفتاحك Supadata | X-API-Key: مفتاحك FlashData | قم بإنشاء أو إعادة استخدام بيانات الاعتماد بإذن youtube_transcript. أسماء الرؤوس غير حساسة لحالة الأحرف؛ تغييرات الاعتماد. |
| الأصلي مقابل المولد | الوضع = أصلي يسترد التسميات التوضيحية الموجودة؛ يمكن أن يعود الوضع التلقائي إلى الذكاء الاصطناعي؛ يستخدم الإنشاء دائمًا الذكاء الاصطناعي | youtube_transcript يقرأ التسميات التوضيحية YouTube الموجودة | نقل الاسترجاع الأصلي أولاً. احتفظ بخطوة منفصلة لتحويل الكلام إلى نص لمقاطع الفيديو التي تحتاج إلى نسخ جديد. |
| أصل التسمية التوضيحية | يختار الوضع الاسترجاع مقابل التوليد | params.auto=true يحدد YouTube التسميات التوضيحية التي تم إنشاؤها؛ false يحدد التسميات التوضيحية المقدمة من القائم بالتحميل | هذه الإعدادات التلقائية ليست متكافئة. FlashData تلقائي لا يبدأ أبدًا تحويل الكلام إلى نص. |
| اللغة | اللغة المفضلة؛ يمكن أن تعود اللغات غير المتوفرة إلى أول لغة متاحة | params.language صريحة؛ auto=true يحاول المتغير -orig ثم الكود المطلوب | تحقق من languageCode و requestedLanguageCode. FlashData لا يختار بصمت لغة أخرى أو أصل التسمية التوضيحية. |
| شرائح | المحتوى []: النص والإزاحة والمدة بالمللي ثانية | النتائج[0].الأجزاء[]: نص، البداية والنهاية في ثوانٍ | إزاحة = جولة (البداية × 1000)؛ المدة = الجولة ((النهاية − البداية) × 1000). الحفاظ على التداخلات بدلاً من تغيير الإشارات. |
| نص عادي | text=true يُرجع المحتوى كسلسلة | النتائج[0].fullText | اقرأ fullText للتلخيص واحتفظ بالمقاطع لاستشهادات الطابع الزمني. |
| اكتشاف اللغة | availableLangs في الرد النصي | transcriptLanguages في youtube_metadata | قم بإحضار البيانات الوصفية عندما يحتاج تطبيقك إلى قائمة اللغات الكاملة. لا تخترع availableLangs من مسار واحد تم إرجاعه. |
| الانتهاء | HTTP 200 النتيجة أو HTTP 202 + jobId | الحالة الحقيقية = done؛ async عودة التقديمات FlashData الوظيفة IDs | التعامل مع حالات كل مزود بشكل منفصل. قم بإنهاء Supadata الوظائف الموجودة هناك قبل ترحيل العمل الجديد. |

### 1. إعداد الوصول

قم بإنشاء أو إعادة استخدام مفتاح FlashData بإذن youtube_transcript في [API مفاتيح](https://flashdata.dev/app/api-keys). أضف youtube_metadata لمهمة بيانات التعريف الاختيارية. تأكد من [الاعتمادات المتاحة](https://flashdata.dev/app/billing) أو استخدم [الوصول التجريبي للوكيل المؤهل](#agents). احتفظ بالمفاتيح في بيئة أو متجر سري.

Supadata يتم استبدال الطلب الأصلي:

```bash
# Existing Supadata call: use your saved SUPADATA_API_KEY.
curl --get --fail-with-body --silent --show-error \
  'https://api.supadata.ai/v1/transcript' \
  --header "x-api-key: $SUPADATA_API_KEY" \
  --data-urlencode 'url=https://www.youtube.com/watch?v=FUfGcZ092b0' \
  --data-urlencode 'lang=en' --data-urlencode 'text=false' \
  --data-urlencode 'mode=native'
```

FlashData استبدال JSON جسم بـ POST /v1/queries/realtime:

```json
{
  "source": "youtube_transcript",
  "video_id": "FUfGcZ092b0",
  "params": {
    "language": "en",
    "auto": true
  }
}
```

### 2. احفظ البرنامج النصي، ثم قم بتشغيله

اختر Python أو Bash. يقدم كل مجلد إخراج جديد طلبًا واحدًا؛ تؤدي إعادة استخدام المجلد إلى قراءة الإخراج المحفوظ دون إجراء مكالمة API أخرى. تشترك الإصدارات في تنسيق الملف المحفوظ. اختر مقطع فيديو يتضمن مسار التسمية التوضيحية المطلوب.

#### Python

يتطلب Python 3.10+. ثبّت المكتبة باستخدام python -m pip install requests. في مجلد عمل جديد، احفظ السكربت الكامل أدناه باسم youtube-migrate.py قبل تشغيله.

```python
import argparse
import getpass
import json
import math
import os
import re
from pathlib import Path

import requests

parser = argparse.ArgumentParser()
parser.add_argument("operation", choices=["transcript", "metadata"])
parser.add_argument("video_id")
parser.add_argument("folder", type=Path)
parser.add_argument("--language", default="en")
parser.add_argument("--origin", choices=["auto", "manual"], default="auto")
args = parser.parse_args()
if not re.fullmatch(r"[A-Za-z0-9_-]{11}", args.video_id):
    raise SystemExit("Use an 11-character YouTube video ID")
source = "youtube_" + args.operation
params = ({"language": args.language, "auto": args.origin == "auto"}
          if args.operation == "transcript"
          else {"include_formats": False, "include_chapters": True})
body = {"source": source, "video_id": args.video_id, "params": params}
out = args.folder
if not out.exists():
    key = os.environ.get("FLASHDATA_API_KEY") or getpass.getpass("FlashData API key: ")
    if not key.strip():
        raise SystemExit("An API key is required")
    out.mkdir(parents=True)
    (out / "request.json").write_text(json.dumps(body), encoding="utf-8")
    try:
        response = requests.post(
            "https://data.flashdata.dev/v1/queries/realtime", json=body,
            headers={"X-API-Key": key, "Accept": "application/json"},
            timeout=120, allow_redirects=False,
        )
    except requests.RequestException:
        raise SystemExit("Outcome unknown. Keep this folder and check History before retrying.")
    (out / "response.json").write_bytes(response.content)
    (out / "http-status.txt").write_text(str(response.status_code), encoding="utf-8")
    (out / "retry-after.txt").write_text(response.headers.get("Retry-After", ""), encoding="utf-8")
else:
    print("Reading saved output; no API call.")

try:
    saved_request = json.loads((out / "request.json").read_text(encoding="utf-8"))
    status = (out / "http-status.txt").read_text(encoding="utf-8").strip()
except (OSError, ValueError):
    raise SystemExit("Incomplete attempt. Inspect this folder and History before retrying.")
if saved_request != body:
    raise SystemExit("This folder belongs to a different request. Use a new folder.")
if status != "200":
    raise SystemExit(f"HTTP {status}: inspect response.json and retry-after.txt")
data = json.loads((out / "response.json").read_text(encoding="utf-8"))
if not isinstance(data, dict) or data.get("status") != "done" or data.get("source") != source:
    raise SystemExit("Request did not complete successfully; inspect response.json")
results = data.get("results")
if not isinstance(results, list) or len(results) != 1 or not isinstance(results[0], dict):
    raise SystemExit("Expected one result; inspect response.json")
item = results[0]
if item.get("videoId") != args.video_id:
    raise SystemExit("Returned video does not match the request")
if args.operation == "transcript":
    allowed = {args.language}
    if args.origin == "auto" and not args.language.endswith("-orig"):
        allowed.add(args.language + "-orig")
    if item.get("languageCode") not in allowed or item.get("isAutoGenerated") is not params["auto"]:
        raise SystemExit("Returned caption language or origin does not match")
    if not isinstance(item.get("segments"), list):
        raise SystemExit("Expected caption segments")
    content = []
    for cue in item["segments"]:
        if not isinstance(cue, dict):
            raise SystemExit("Invalid caption segment")
        start, end, text = cue.get("start"), cue.get("end"), cue.get("text")
        if (type(start) not in (int, float) or type(end) not in (int, float)
                or not math.isfinite(start) or not math.isfinite(end)
                or start < 0 or end < start or not isinstance(text, str)):
            raise SystemExit("Invalid caption segment")
        content.append({"text": text, "offset": round(start * 1000),
                        "duration": round((end - start) * 1000)})
    normalized = {"content": content, "lang": item["languageCode"].removesuffix("-orig")}
else:
    normalized = {name: item.get(name) for name in (
        "videoId", "title", "channel", "duration", "viewCount", "likeCount",
        "commentCount", "hasTranscripts", "transcriptLanguages", "chapters")}
(out / "normalized.json").write_text(
    json.dumps(normalized, ensure_ascii=False, indent=2) + "\n", encoding="utf-8"
)
print(f"Saved {out}/normalized.json; actual usage: {json.dumps(data.get('usage'))}")

```

تشغيل من مجلد العمل هذا:

```bash
python youtube-migrate.py transcript FUfGcZ092b0 transcript-001
```

يؤدي هذا إلى تحديد التسميات التوضيحية الإنجليزية التي تم إنشاؤها بواسطة YouTube. أضف --origin دليل للمسار المقدم من القائم بالتحميل، أو --language CODE لاختيار لغة.

طلب بيانات وصفية منفصلة اختيارية:

```bash
python youtube-migrate.py metadata FUfGcZ092b0 metadata-001
```

#### Bash

يتطلب Bash، cURL 7.76+ وjq 1.6+. احفظ هذا البرنامج النصي الكامل باسم youtube-migrate.sh في مجلد العمل الخاص بك قبل running:

```bash
#!/usr/bin/env bash
set -euo pipefail
operation="${1:?Use: transcript|metadata VIDEO_ID OUTPUT_FOLDER [LANGUAGE] [auto|manual]}"
video_id="${2:?Set VIDEO_ID}"
out="${3:?Set OUTPUT_FOLDER}"
language="${4:-en}"
origin="${5:-auto}"
[[ "$operation" == transcript || "$operation" == metadata ]] || exit 1
[[ "$video_id" =~ ^[A-Za-z0-9_-]{11}$ ]] || exit 1
[[ "$origin" == auto || "$origin" == manual ]] || exit 1
body=$(jq -n --arg source "youtube_$operation" --arg id "$video_id" \
  --arg language "$language" --arg origin "$origin" '
  {source: $source, video_id: $id, params:
    (if $source == "youtube_transcript" then {language: $language, auto: ($origin == "auto")}
     else {include_formats: false, include_chapters: true} end)}')
if [[ ! -e "$out" ]]; then
  if [[ -z "${FLASHDATA_API_KEY:-}" ]]; then
    read -r -s -p 'FlashData API key: ' FLASHDATA_API_KEY; printf '\n'
  fi
  : "${FLASHDATA_API_KEY:?An API key is required}"
  mkdir -p -- "$out"
  printf '%s\n' "$body" > "$out/request.json"
  curl --fail-with-body --silent --show-error --max-time 120 \
    --request POST 'https://data.flashdata.dev/v1/queries/realtime' \
    --header "X-API-Key: $FLASHDATA_API_KEY" \
    --header 'Content-Type: application/json' --header 'Accept: application/json' \
    --data-binary "@$out/request.json" --output "$out/response.json" \
    --dump-header "$out/response-headers.txt" --write-out '%{http_code}' \
    > "$out/http-status.txt" || {
      printf 'Request failed. Keep the output folder and inspect History before retrying.\n' >&2
      exit 1
    }
else
  printf 'Reading saved output; no API call.\n'
fi
jq -e --argjson expected "$body" '. == $expected' "$out/request.json" >/dev/null
[[ "$(cat "$out/http-status.txt")" == 200 ]] || {
  printf 'Inspect the saved HTTP status, response and Retry-After header.\n' >&2; exit 1;
}
normalized=$(jq -e --argjson request "$body" '
  if .source != $request.source or .status != "done" then error("Request not done") else . end
  | .results | if type != "array" then error("Expected results")
    elif length != 1 then error("Expected one result") else .[0] end
  | if .videoId != $request.video_id then error("Wrong video") else . end
  | if $request.source == "youtube_metadata" then
      {videoId, title, channel, duration, viewCount, likeCount, commentCount,
       hasTranscripts, transcriptLanguages, chapters}
    else
      if (.languageCode != $request.params.language and
          ($request.params.auto != true or ($request.params.language | endswith("-orig")) or
           .languageCode != ($request.params.language + "-orig"))) or
          .isAutoGenerated != $request.params.auto then error("Wrong language or origin") else . end
      | {lang: (.languageCode | sub("-orig$"; "")), content: [.segments[] |
          if (.start | type) != "number" or (.end | type) != "number" or (.text | type) != "string"
          then error("Invalid caption segment")
          elif (.start | isfinite | not) or (.end | isfinite | not) or .start < 0 or .end < .start
          then error("Invalid caption timing")
          else {text, offset: (.start * 1000 | round), duration: ((.end - .start) * 1000 | round)} end]}
    end' "$out/response.json")
printf '%s\n' "$normalized" > "$out/normalized.json"
printf 'Saved %s/normalized.json; actual usage: ' "$out"
jq -c '.usage' "$out/response.json"

```

تشغيل من مجلد العمل هذا:

```bash
bash youtube-migrate.sh transcript FUfGcZ092b0 transcript-001
```

الوسائط الاختيارية بعد المجلد هي اللغة والأصل؛ على سبيل المثال، يحدد الدليل التسميات التوضيحية الإنجليزية المقدمة من القائم بالتحميل.

طلب بيانات وصفية منفصلة اختيارية:

```bash
bash youtube-migrate.sh metadata FUfGcZ092b0 metadata-001
```

للوصول التجريبي المؤقت، قم بتشغيل الطلبات بشكل تسلسلي بفارق ثانية واحدة على الأقل.

### 3. قراءة الإخراج

response.json يحافظ على النتيجة الأولية والاستخدام. normalized.json يحول ثوانٍ مقطع النص إلى إزاحة/duration ميلي ثانية. هذا محول مقطع، وليس استجابة كاملة متوافقة مع Supadata: availableLangs غير ملفق. يحتفظ إخراج البيانات التعريفية بالقيم الخالية. الطلبات الفاشلة أو المتقطعة تحتفظ بأدلتها وتتوقف.

توضيحية normalized.json:

```json
{
  "content": [
    {
      "text": "Example caption text.",
      "offset": 1250,
      "duration": 2250
    }
  ],
  "lang": "en"
}
```

[مخطط النص](https://flashdata.dev/ar/docs/sources/youtube_transcript/reference.md)

<a id="workflows"></a>
## البيانات الوصفية وسير العمل المجمع

| البيانات | Supadata /v1/metadata | FlashData youtube_metadata |
| --- | --- | --- |
| هوية الفيديو | id | النتائج[0].videoId |
| العنوان والوصف | العنوان والوصف | النتائج[0].العنوان، النتائج[0].الوصف |
| قناة | author.displayName; additionalData.channelId | النتائج[0].channel; النتائج[0].channelId |
| المشاركة | stats.views, stats.likes, stats.comments | النتائج[0].viewCount, likeCount, commentCount |
| المدة | media.duration (ثواني) | النتائج[0].المدة (ثواني) |
| صورة مصغرة | media.thumbnailUrl | النتائج[0].المصغرات[]; اختر الحجم الذي يحتاجه تطبيقك |
| تاريخ النشر | createdAt | النتائج[0].uploadDate; تطبيع تنسيقه في التطبيق الخاص بك |
| اكتشاف التسمية التوضيحية | اقرأ availableLangs من الرد النصي | النتائج[0].hasTranscripts و transcriptLanguages |

### عدة لغات موجودة في طلب واحد

إرسال مصفوفة لغة لتلقي المسارات والأخطاء، حتى بالنسبة لمصفوفة تحتوي على لغة واحدة. افحص الأخطاء حتى عندما تكون الحالة done. هذه هي المسارات الموجودة، وليست التسميات التوضيحية المترجمة أو المنشأة.

```json
{
  "source": "youtube_transcript",
  "video_id": "FUfGcZ092b0",
  "params": {
    "language": [
      "en",
      "es"
    ],
    "auto": true
  }
}
```

### إثراء المكتبة البحثية

قم بإحضار البيانات الوصفية مرة واحدة، واحفظ الفيديو ID ولغات التسميات التوضيحية المتاحة، ثم استرد المسار الذي تحتاجه. احتفظ بعدد التفاعلات الفارغة كـ null بدلاً من تحويلها إلى صفر.

[YouTube أفضل ممارسات البيانات](https://flashdata.dev/ar/docs/guides/youtube-data-guide/reference.md)

### معالجة قائمة الفيديو IDs

قم بتوسيع مدخلاتك إلى فيديو واضح IDs، ثم استخدم ملف دفعة أو ملف مجمع. FlashData لا يقبل Supadata playlistId كمدخل منسدل batch. احفظ حالة كل عنصر ومخرجاته قبل إعادة محاولة failed العناصر.

[مرجع المعالجة بالجملة](https://flashdata.dev/ar/docs/reference/bulk-processing/reference.md)

### إجراء البحوث وفقا لجدول زمني

استمر في بيانات اعتماد المالك ونقطة التفتيش completed مقاطع الفيديو وقراءة المخرجات المحفوظة عند إعادة التشغيل. توقف بسبب إلغاء الوصول أو عدم كفاية الرصيد؛ لا تقم بإنشاء تجربة أخرى لمواصلة مهمة مجدولة.

[مهام الوكيل المتكررة](https://flashdata.dev/ar/docs/guides/recurring-tasks/reference.md)

### Production قرارات الهجرة

- حل مدخلات قائمة التشغيل/channel للفيديو الصريح IDs قبل FlashData معالجة الملفات المجمعة أو المجمعة ؛ Supadata playlistId ليس إدخالاً مباشرًا.
- يتكلف البحث Supadata رصيدًا واحدًا لكل صفحة نتيجة 20، أو الحد الأقصى (الحد/20) بحد أقصى. FlashData قياسي YouTube يدعم البحث ما يصل إلى 20 النتائج؛ البحث الموسع له سعر منفصل. مرشحات الخريطة ولا تنقل الرموز المميزة للصفحة.
- Supadata يوثق نافذة نتيجة مهمة completed لمدة ساعة واحدة. استنزاف الوظائف الموجودة هناك وتخزين النتائج قبل ترحيل العمل الجديد. احتفظ بالوظيفة الخاصة بمزود الخدمة IDs منفصلة.
- احتفظ بالوسائط عبر الأنظمة الأساسية واستخراج الذكاء الاصطناعي والترجمة والنسخ الصوتي على مساراتها الحالية ما لم يتم تنفيذ سير عمل مكافئ.

<a id="agents"></a>
## محاكمة الوكيل والمطالبة والاستخدام المتكرر

يمكن للوكلاء المؤهلين البدء بـ 1 رصيد (أرصدة)، ما يصل إلى 100 طلبات النسخ الأصلية لمدة 72 ساعة. تشترك البيانات الوصفية والنصوص في هذا البدل.

1. إعادة استخدام الوصول الحالي أولاً؛ وإلا فابدأ بتجربة واحدة مؤهلة باستخدام الأذونات المطلوبة فقط.
2. قم بإرجاع نتيجة مفيدة، واحفظ المخرجات الأولية والاستخدام، واحتفظ بنفس ملف التعريف ودليل الحالة.
3. يقوم المالك بتسجيل الدخول أو الاشتراك والتحقق من البريد الإلكتروني والموافقة على المطالبة والنطاقات والوصول إلى الرصيد المشترك.
4. إعادة استخدام بيانات اعتماد المالك للمهام المتكررة. لا يتم نقل الاعتمادات التجريبية غير المستخدمة. التوقف بعد الإلغاء أو عدم كفاية الرصيد؛ لا تقم أبدًا بإنشاء تجربة أخرى للمتابعة.

```text
Migrate the native YouTube transcript part of this project from Supadata to FlashData.
Read https://flashdata.dev/auth.md and https://flashdata.dev/docs/sources/youtube_transcript/reference.md.
Reuse a saved FlashData credential before requesting an eligible temporary trial.
Use youtube_transcript permission and one explicit video ID, language and caption origin.
Do not map Supadata mode=auto to FlashData auto=true: the latter selects existing YouTube-generated captions.
Save the raw response and actual usage. Convert segment seconds to milliseconds if my reader expects offset/duration.
Do not fabricate captions or available languages. Report missing tracks and keep AI generation separate.
Ask the owner to claim access before recurring use. Store credentials outside chat and source control.
Reuse saved outputs on restart and stop after revocation; never create repeated trials to keep running.
```

[المحاكمة والمطالبة](https://flashdata.dev/ar/docs/guides/agent-onboarding/reference.md) · [مستقل CLI](https://flashdata.dev/ar/docs/guides/flashdata-cli/reference.md) · [MCP إتصال](https://flashdata.dev/ar/docs/integrations/mcp-clients/reference.md)

<a id="faq"></a>
## أسئلة الهجرة

### هل يمكن لـ FlashData استبدال نسخ الذكاء الاصطناعي لـ Supadata؟

تسترد مصادر النص والتسميات التوضيحية الخاصة بـ FlashData التسميات التوضيحية الموجودة بالفعل على YouTube. إنهم لا يقومون بنسخ الصوت أو ترجمة النص أو إجراء التحليل البصري. انقل استرجاع YouTube الأصلي إلى FlashData؛ احتفظ بخدمة منفصلة لتحويل الكلام إلى نص أو الفيديو عبر الأنظمة الأساسية أو استخراج الذكاء الاصطناعي عندما يحتاج تطبيقك إلى ذلك.

### ماذا يطلب المرء شراء؟

تغطي الآلة الحاسبة نصًا واحدًا موجودًا بلغة واحدة أو بحثًا واحدًا عن البيانات الوصفية للفيديو. يستخدم جلب كلاهما طلبين لكل فيديو. Supadata فاتورة كل من هذه العمليات برصيد واحد. FlashData يستخدم معدل البيانات YouTube الخاص بالخطة المحددة. البحث الموسع والنسخ بالذكاء الاصطناعي والترجمة وتسليم الوسائط خارج هذا التقدير.

### هل FlashData أرخص دائمًا؟

قارن عبء العمل الفعلي لديك والخطط المحددة. Supadata يشمل 100 رصيد كل شهر مجانًا. تجربة الوكيل المؤقت لـ FlashData محدودة وتنتهي؛ إنها ليست طبقة مجانية شهرية. عند مستوى الصوت المنخفض، قد يغطي البدل المجاني المهمة بأكملها. تؤثر رسوم الخطة المدفوعة وحزم إعادة الشحن والأرصدة غير المستخدمة على المبلغ الذي تدفعه.

### هل Supadata يدعم بالفعل MCP وSDKs؟

نعم. تدعم كلتا الخدمتين عمليات التكامل MCP وPython/JavaScript. FlashData يوفر أيضًا Go SDK، مستقل CLI وتجربة وكيل مؤقتة يمكن المطالبة بها للوصول المتكرر. اختر الواجهة التي يدعمها مضيفك؛ MCP وحده ليس سبباً للتبديل.

### ماذا يحدث إذا كان مسار التسمية التوضيحية مفقودًا؟

تعامل معها على أنها فجوة في البيانات. لا يقوم FlashData بالتبديل بين التسميات التوضيحية المقدمة من القائم بالتحميل والتسميات التوضيحية التي تم إنشاؤها بواسطة YouTube أو تجميع النص. بالنسبة لمصفوفة اللغة، قم بفحص الأخطاء حتى عندما يكون الطلب done. يمكن لـ Supadata إنشاء نص في الوضع التلقائي، بينما يمكن للوضع الأصلي إرجاع HTTP 206 للنص غير المتاح؛ فواتير التوثيق الخاصة بها تستجيب بائتمان واحد.

### هل يمكنني الاحتفاظ بشكل استجابة الطلب الحالي؟

احتفظ بالمحول الخاص بك. يقوم المثال بتحويل FlashData مقاطع إلى إدخالات محتوى مع إزاحة ومدة بالمللي ثانية، لكنه لا يطالب باستجابة كاملة متوافقة مع Supadata. اقرأ FlashData البيانات الوصفية إذا كنت بحاجة إلى اللغات المتاحة، وقم بترحيل حالة الوظيفة والخطأ ومعالجة الاستخدام بشكل صريح.

[احصل على مفتاح API](https://flashdata.dev/signup)
