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

قارن بين YouTube تكاليف البيانات الوصفية والتسميات التوضيحية والحزم المدفوعة مسبقًا ونتائج ذاكرة التخزين المؤقت. قم بالترحيل إلى FlashData باستخدام المحولات الميدانية Python وBash القابلة للتشغيل للتطبيقات والوكلاء.

بيانات فيديو جديدة. إنفاق بداية أصغر. انقل YouTube البيانات الوصفية ومكالمات التسميات التوضيحية مع الاحتفاظ ببقية تكامل بياناتك الاجتماعية.

واستعرضت وقائع ScrapeCreators 2026-11-10. وتأتي أسعار FlashData وبدلات المحاكمة من فهرسها العام الحالي.

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

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

### خفض تكلفة البيانات YouTube الجديدة

| ميزة | FlashData | ScrapeCreators |
| --- | --- | --- |
| معدل الدخول المدفوع / 1,000 البيانات الوصفية أو مكالمات التسميات التوضيحية | $0.50 — استخدام الدفع عند الاستخدام | $1.88 — Freelance · مكالمات جديدة برصيد واحد |
| أدنى سعر للوحدة مدرج / 1,000 مكالمات | $0.20 — خطة شهرية اختيارية؛ لا تزال رسومها سارية | $0.994 — Business · $497 باقة الدفع المسبق؛ تم استبعاد المؤسسة المخصصة |
| أول شراء ائتماني مدفوع | من $10 | $47 — 25,000-رصيد Freelance باقة |
| ادفع كما تذهب دون رسوم شهرية | نعم | نعم |

### ابحث عن مقاطع الفيديو وقم بتحديث الحقائق التي تحتاجها

| ميزة | FlashData | ScrapeCreators |
| --- | --- | --- |
| ابحث عن مقاطع الفيديو حسب الكلمات الرئيسية والمرشحات | نعم — مرشحات التاريخ والمدة والنوع والفرز | نعم — مرشحات البحث وترقيم الصفحات لرمز الاستمرار |
| البيانات الوصفية لمقطع فيديو معروف | نعم — العنوان والقناة والمدة والصور المصغرة وأعداد المشاركة | نعم — Video/Short تفاصيل نقطة النهاية |
| علامات الفصل للملاحة | نعم — include_chapters; العناوين مع بداية/end مرات عند وجودها | نعم — فصول في استجابة الفيديو عند وجودها |
| اكتشف مسارات التسميات التوضيحية المتاحة | قائمة لغة البيانات الوصفية — hasTranscripts و transcriptLanguages | البيانات الوصفية captionTracks — رموز اللغة وتفاصيل المسار |

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

| ميزة | FlashData | ScrapeCreators |
| --- | --- | --- |
| النص والطوابع الزمنية من نفس الرد | نص كامل + أجزاء محددة بوقت — ابدأ/end مرات في ثواني | نص كامل + أجزاء محددة بوقت — startMs/endMs كنصوص تمثل الوقت بالمللي ثانية |
| عدة لغات تسمية توضيحية في طلب واحد | ما يصل إلى 10 لغة — المسارات الموجودة بالإضافة إلى الأخطاء لكل لغة | لغة واحدة مختارة — اللغة أو اختيار original_audio لكل مكالمة نصية |
| اختر أصل التسمية التوضيحية بشكل صريح | الرافع أو الذي تم إنشاؤه YouTube — params.auto يختار أصل واحد | اختيار اللغة والصوت المنطوق — original_audio ليس مفتاحًا لأصل التسمية التوضيحية |
| التعامل مع التسمية التوضيحية المفقودة | المسارات الموجودة والأخطاء الصريحة — تحافظ صفائف اللغة على المسارات الناجحة وتبلغ عن التحديدات المفقودة | حقول النص فارغة — المسارات المطلوبة المفقودة تكلف صفرًا من الاعتمادات. لا YouTube النسخ AI |
| اختر المدة التي قد تكون عليها البيانات المعاد استخدامها | سياسة ذاكرة التخزين المؤقت في التطبيق الخاص بك — احفظ أوقات الاسترجاع وحدد موعد الجلب مرة أخرى | cache_max_age — 1–30 خيارات اليوم؛ تبلغ تكلفة النقرات في ذاكرة التخزين المؤقت صفرًا من الاعتمادات وتكشف cached_at |

### تشغيل سير عمل بيانات قابل للتكرار

| ميزة | FlashData | ScrapeCreators |
| --- | --- | --- |
| معالجة ملف محفوظ من الفيديو IDs | الوظائف المجمعة المُدارة — قم بإرسال الملف وتتبع مهمته واسترجاع المخرجات | مكالمات نقطة النهاية لكل فيديو — إدارة حلقة الملف وتخزين النتائج في التكامل الخاص بك |
| نقل المجموعات الطويلة إلى وظائف الخلفية | واجهات برمجة التطبيقات غير المتزامنة والدُفعية والمجمّعة — استمر في العمل IDs، وتتبع الحالة واحصل على النتائج | مكالمات YouTube متزامنة — قائمة الانتظار ونقاط التفتيش لكل مكالمات فيديو في العامل الخاص بك |
| مخرجات منظمة وقابلة للقراءة | JSON، نص عادي أو Markdown — تم التحديد من خلال رؤوس الاستجابة API | التنسيقات JSON API وCLI — CLI يصدر أيضًا CSV والجداول و Markdown |
| التثبيت الطرفي | مستقل قابل للتنفيذ — Linux، macOS و Windows؛ لا يوجد وقت تشغيل Node/Python | npm CLI — @scrapecreators/cli |
| MCP ومهارات الوكيل | نعم | نعم |
| تابع من البيانات إلى تسليم الوسائط المستضافة | نعم — YouTube التنزيل على مساحة التخزين الخاصة بك؛ إذن منفصل والتسعير على أساس جيجابايت | سير عمل تنزيل منفصل — YouTube لا تقوم البيانات التعريفية وواجهات برمجة التطبيقات النصية بتسليم ملفات الوسائط |

كلاهما يوفر إمكانية الوصول للدفع المسبق، MCP، CLI ومهارات الوكيل. ScrapeCreators يغطي أيضًا منصات التواصل الاجتماعي الأخرى وتعليقات YouTube. زيارات ذاكرة التخزين المؤقت المدعومة مجانية.

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

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

### ابدأ بعملية شراء أصغر

FlashData عمليات تعبئة الرصيد تبدأ من $10. قم بنقل عبء عمل واحد YouTube أولاً، بينما يستمر التكامل الحالي في التعامل مع التعليقات والأنظمة الأساسية الاجتماعية الأخرى.

### اختر مسار التسمية التوضيحية الدقيق

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

<a id="costs"></a>
## قارن بين الطلبات الجديدة ونتائج ذاكرة التخزين المؤقت والمشتريات المقدمة

| ScrapeCreators عرض | شراء لمرة واحدة | الاعتمادات | لكل 1,000 مكالمات جديدة ذات رصيد واحد | الرسوم الشهرية |
| --- | --- | --- | --- | --- |
| العرض المجاني الأولي | $0 | 100 مرة واحدة | بدل البداية المجانية | $0 |
| Freelance | $47.00 | 25,000 | $1.88 | $0 |
| Business | $497.00 | 500,000 | $0.994 | $0 |
| المؤسسة | مخصص | 1,000,000+ | مخصص | $0 للاعتمادات المدفوعة مسبقًا |

هذه باقات مسبقة الدفع بدون تجديد شهري. Business هو بالضبط $0.994 لكل 1,000 مكالمات ذات رصيد واحد؛ $0.99 مستدير. الاعتمادات المشتراة ليس لها انتهاء صلاحية بموجب السياسة الحالية. يتم استبعاد أرصدة المكافآت الأولية والمكتسبة من النموذج.

| 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 |

FlashData متضمن - أعداد الطلبات تخصص الرصيد المشترك الكامل للبيانات YouTube القياسية. البحث الموسع والتنزيل لهما أسعار منفصلة. [التسعير الكامل](https://flashdata.dev/ar/pricing/youtube-data).

### مثال: البيانات الوصفية والتسميات التوضيحية لـ 1,000 مقاطع فيديو

2,000 طلبات، لا توجد عمليات بحث للاكتشاف. FlashData ادفع حسب الاستخدام مقابل ScrapeCreators Freelance. حساب مرات الوصول إلى ذاكرة التخزين المؤقت التي تمت ملاحظتها فقط؛ لا يتم إرسال الطلبات التي تم تجنبها من خلال التخزين المحلي الخاص بك إلى أي من المزودين.

| زيارات ذاكرة التخزين المؤقت المجانية | FlashData مكالمات | FlashData الاستخدام | FlashData شراء | ScrapeCreators رصيد | ScrapeCreators قيمة الاستخدام | ScrapeCreators شراء |
| --- | --- | --- | --- | --- | --- | --- |
| 0 | 2,000 | $1.00 | $10.00 | 2,000 | $3.76 | $47.00 |
| 1,000 | 2,000 | $1.00 | $10.00 | 1,000 | $1.88 | $47.00 |
| 2,000 | 2,000 | $1.00 | $10.00 | 0 | $0.00 | $0.00 |

USD، شهر للطلبات. يستخدم البحث الجديد عن البيانات التعريفية أو نتيجة التسميات التوضيحية الأصلية أو طلب البحث القياسي رصيدًا واحدًا ScrapeCreators. تستخدم بيانات التعريف بالإضافة إلى التسميات التوضيحية طلبين على كلا الجانبين. يتم خصم فقط بيانات التعريف/transcript المخبأة التي تم إدخالها أعلاه؛ لا يفترض التخزين المؤقت للبحث. يحسب هذا النموذج التسميات التوضيحية التي تم إرجاعها، وليس محاولات المسار المفقود، ويستبعد إنشاء الذكاء الاصطناعي. FlashData يستخدم معياره الحالي YouTube أسعار البيانات، مع تخصيص بدل الخطة المحدد بالكامل قبل الاستخدام الإضافي. يتم تسعير البحث الموسع والتنزيل بشكل منفصل. يتم استبعاد الأرصدة الافتتاحية والتجارب والائتمانات الإضافية والضرائب والاستخدامات الأخرى. تبدأ عمليات الشراء من رصيد صفر: FlashData الحد الأدنى للتعبئة هو $10؛ ScrapeCreators مشتريات تصل إلى حزم كاملة مختارة. يمكن للاعتمادات المشتراة غير المستخدمة أن تخدم مهام لاحقة. ScrapeCreators ليس لديه تجديد شهري للباقة؛ لا تزال خطة FlashData الشهرية المحددة برسومها عند صفر طلبات.

### سلوك ذاكرة التخزين المؤقت

في نقاط نهاية البيانات الوصفية المدعومة/transcript، يقبل cache_max_age 1d أو 3d أو 7d أو 14d أو 30d. تستخدم الزيارات رصيدًا صفريًا وتقدم تقريرًا cached_at؛ يخطئ استخدام المعدل الطبيعي. لا يتم افتراض نتائج البحث في ذاكرة التخزين المؤقت. قرر ما إذا كانت البيانات المحفوظة حديثة بما يكفي للمهمة. [حفظ النتائج وإعادة استخدامها](https://flashdata.dev/ar/docs/guides/save-results/reference.md).

### عروض البداية

ScrapeCreators يبدأ مع 100 إئتمانات مجانية تم التحقق منها FlashData يمكن أن تحصل الاشارات على علاوة أولية تصل إلى الحد الأقصى 4,000 المعيار YouTube طلبات البيانات. وهذه العروض لا تعاد صياغتها شهريا. وترد أدناه محاكمة العميل المؤقت المنفصلة.

<a id="migration"></a>
## قم بترحيل مقطع فيديو واحد والطوابع الزمنية للتسميات التوضيحية الخاصة به

### 1. قم بإعداد الوصول واختيار المسار

قم بإنشاء مفتاح أو إعادة استخدامه بإذن youtube_transcript، بالإضافة إلى youtube_metadata لاستدعاء البيانات التعريفية الاختيارية. [API مفاتيح](https://flashdata.dev/app/api-keys) · [الاعتمادات](https://flashdata.dev/app/billing). قم بتخزين FLASHDATA_API_KEY في البيئة أو استخدم المطالبة المخفية للبرنامج النصي؛ لا تلصقه أبدًا في الدردشة.

الطلب الحالي لرسم الخرائط فقط:

```bash
# Existing call, for mapping only; reuse your saved key.
curl --get --fail-with-body --silent --show-error \
  'https://api.scrapecreators.com/v1/youtube/video/transcript' \
  --header "x-api-key: $SCRAPECREATORS_API_KEY" \
  --data-urlencode 'url=https://www.youtube.com/watch?v=FUfGcZ092b0' \
  --data-urlencode 'language=en'
```

FlashData POST https://data.flashdata.dev/v1/queries/realtime مع X-API-Key وهذا JSON الجسم:

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

original_audio=true يختار اللغة المنطوقة. FlashData params.auto=true يحدد YouTube التسميات التوضيحية التي تم إنشاؤها. حدد اللغة والأصل بشكل منفصل.

### 2. احفظ البرنامج النصي قبل running

يتطلب Python 3.10+. ثبّت المكتبة باستخدام python -m pip install requests. في مجلد عمل جديد، احفظ السكربت الكامل أدناه باسم creator-research.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")
    transcript = []
    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")
        transcript.append({"text": text,
                           "startMs": str(math.floor(start * 1000 + 0.5)),
                           "endMs": str(math.floor(end * 1000 + 0.5)),
                           "startTimeText": f"{int(start) // 60}:{int(start) % 60:02d}"})
    normalized = {"videoId": item["videoId"],
                  "url": "https://www.youtube.com/watch?v=" + item["videoId"],
                  "transcript": transcript, "transcript_only_text": item.get("fullText"),
                  "language": item.get("languageName"), "languageCode": item["languageCode"],
                  "isAutoGenerated": item["isAutoGenerated"]}
else:
    duration = item.get("duration")
    if duration is not None and (type(duration) not in (int, float)
                                or not math.isfinite(duration) or duration < 0):
        raise SystemExit("Invalid video duration")
    normalized = {"id": item["videoId"], "title": item.get("title"),
                  "url": "https://www.youtube.com/watch?v=" + item["videoId"],
                  "description": item.get("description"),
                  "viewCountInt": item.get("viewCount"), "likeCountInt": item.get("likeCount"),
                  "commentCountInt": item.get("commentCount"),
                  "durationMs": None if duration is None else math.floor(duration * 1000 + 0.5),
                  "channel": {"id": item.get("channelId"), "title": item.get("channel")},
                  "uploadDateRaw": item.get("uploadDate")}
(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 creator-research.py transcript FUfGcZ092b0 captions-001
# Optional metadata, run separately:
python creator-research.py metadata FUfGcZ092b0 metadata-001
```

بالنسبة للتسميات التوضيحية المقدمة من القائم بالتحميل، قم بإلحاق دليل --origin. الإعداد الافتراضي هو التسميات التوضيحية الإنجليزية التي تم إنشاؤها بواسطة YouTube.

وبدلاً من ذلك، استخدم Bash وcURL 7.76+ وjq 1.6+. احفظ النص الكامل أدناه باسم creator-research.sh في مجلد عمل جديد.

```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
      if .duration == null then .
      elif (.duration | type) != "number" then error("Invalid video duration")
      elif (.duration | isfinite | not) or .duration < 0 then error("Invalid video duration") else . end
      | {id: .videoId, title, url: ("https://www.youtube.com/watch?v=" + .videoId), description,
         viewCountInt: .viewCount, likeCountInt: .likeCount, commentCountInt: .commentCount,
         durationMs: (if .duration == null then null else (.duration * 1000 | round) end),
         channel: {id: .channelId, title: .channel}, uploadDateRaw: .uploadDate}
    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
      | if (.segments | type) != "array" then error("Expected caption segments") else . end
      | {videoId, url: ("https://www.youtube.com/watch?v=" + .videoId),
         transcript_only_text: .fullText, language: .languageName, languageCode, isAutoGenerated,
         transcript: [.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, startMs: (.start * 1000 | round | tostring), endMs: (.end * 1000 | round | tostring),
            startTimeText: (((.start / 60 | floor) | tostring) + ":" +
              ((.start | floor) % 60 | if . < 10 then "0" + tostring else tostring end))} 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 creator-research.sh transcript FUfGcZ092b0 captions-001
# Optional metadata, run separately:
bash creator-research.sh metadata FUfGcZ092b0 metadata-001
```

بالنسبة للتسميات التوضيحية المقدمة من القائم بالتحميل، قم بإلحاقها يدويًا. يقدم كل مجلد إخراج جديد طلبًا واحدًا. نفس الوسائط والمجلد يعيد استخدام المخرجات المحفوظة؛ استخدم مجلدًا جديدًا للتحديث المتعمد بعد فحص المحاولة السابقة.

### 3. قراءة الإخراج المعين والاستخدام الفعلي

أغطية001/normalized.json هو مكيف ميداني؛ response.json يحتفظ بالاستجابة الأولية والاستخدام الفعلي. وتتحول الثانية إلى ثانيتين مليئيتين، ويحافظ زكس كيزك (languageCode) و isAutoGenerated على المسار المختار. وهذا ليس استجابة كاملة للإسقاط: لا توجد أرصدة ائتمانية مصنّعة، أو أعلام كاش، أو حقول تحميل أو تواريخ. الـ (ميتاداتا) تحافظ على مقاييس مفقودة null وتاريخه الأصلي uploadDateRaw.

```json
{
  "videoId": "FUfGcZ092b0",
  "url": "https://www.youtube.com/watch?v=FUfGcZ092b0",
  "transcript": [
    {
      "text": "Example caption text.",
      "startMs": "1250",
      "endMs": "3500",
      "startTimeText": "0:01"
    }
  ],
  "transcript_only_text": "Example caption text.",
  "language": "English",
  "languageCode": "en-orig",
  "isAutoGenerated": true
}
```

| ScrapeCreators التكامل | FlashData تغير |
| --- | --- |
| GET /v1/youtube/video?url=… | POST الاستعلام API مع المصدر: youtube_metadata و video_id. قراءة النتائج[0]، وليس جذر الاستجابة. |
| GET /v1/youtube/video/transcript?url=… | استخدم المصدر: youtube_transcript. اضبط params.language و params.auto بشكل صريح. |
| نسخة[].startMs / endMs | FlashData البداية / النهاية ثواني. اضرب كل منها بـ 1,000 وقم بإجراء تسلسل لها كسلاسل لقارئ ميلي ثانية موجود. |
| original_audio=true | تحديد اللغة المنطوقة بـ ScrapeCreators، وليس التسميات التوضيحية التي يتم إنشاؤها تلقائيًا. حل اللغة المطلوبة في التطبيق الخاص بك؛ params.auto يختار أصل التسمية التوضيحية بدلاً من ذلك. |
| اللغة و transcript_only_text | الخريطة languageName و fullText. احتفظ بـ languageCode بشكل منفصل؛ اسم اللغة ورمز اللغة مجالان مختلفان. |
| viewCountInt, likeCountInt, commentCountInt | الخريطة viewCount, likeCount, commentCount. احتفظ بـ null عند غياب أحد المقاييس. |
| durationMs و publishDate | تحويل المدة من ثانية إلى ميلي ثانية. احتفظ بـ uploadDate كحقل أولي حتى يتحقق تطبيقك من صحة تنسيق التاريخ الذي يحتاجه. |
| القناة / الرافع / ownerByline | لا تقوم قناة FlashData وchannelId بإعادة إنتاج الهويات الثلاث. قم بتعيين الحقول التي يحتاجها القارئ فقط؛ احتفظ بمسار منفصل لإسناد رصيد الموسيقى. |
| cached, cached_at, credits_charged | احتفظ بالاستجابة والاستخدام الخام FlashData. سجل وقت الجلب الخاص بك؛ لا تقم بتصنيع علامات التخزين المؤقت للموفر أو ترجمة الأرصدة الدائنة بين مقدمي الخدمة. |

[مخطط النص](https://flashdata.dev/ar/docs/sources/youtube_transcript/reference.md) · [مخطط البيانات الوصفية](https://flashdata.dev/ar/docs/sources/youtube_metadata/reference.md)

### إذا فشل الطلب الأول

- 401/403: check the Save key and source permission; stop if revoked.
- 402: تجديد رصيد المالك قبل الاستئناف.
- 429: اقرأ رأس Retry-After المحفوظ؛ تقليل تكرار الطلب. تسمح التجارب المؤقتة بطلب واحد في الثانية.
- المسار المفقود: تحقق من اللغة والأصل المتاحين. ScrapeCreators يمكنه إرجاع استجابة ناجحة بنص null؛ لا تخلط بين هذا وبين المسار completed FlashData.
- مجلد المهلة أو غير مكتمل: افحص السجل والمخرجات قبل إعادة المحاولة. تحافظ البرامج النصية على المحاولة دون إعادة الإرسال التلقائي.

[الأخطاء ورموز الحالة](https://flashdata.dev/ar/docs/errors/reference.md)

<a id="workflow"></a>
## ابحث عن → القائمة المختصرة → الإثراء → الاستشهاد

| خطوة | العمل | عدد الطلبات |
| --- | --- | --- |
| اكتشف | تشغيل طلبات البحث P YouTube | طلبات البحث القياسية P قم بإحصاء الطلبات الفعلية، وليس كل فيديو تم إرجاعه كبحث منفصل. |
| اختر | إلغاء النسخ والقائمة المختصرة للفيديو N IDs | التصفية المحلية؛ لا توجد بيانات وصفية أو طلب تسمية توضيحية حتى الآن. |
| إثراء | جلب البيانات الوصفية للقائمة المختصرة IDs | طلبات البيانات الوصفية N؛ كرر فقط عندما تحتاج المقاييس إلى التحديث. |
| استشهد | جلب مسار تسمية توضيحية موجود لكل ID | طلبات النص N عندما تكون متاحة. تخزين اللغة والأصل وتوقيت الإشارة مع المصدر URL. |
| إعادة الاستخدام | قراءة النتائج المحفوظة للمهمة التالية | لا يوجد طلب من الموفر عندما يتمكن تطبيقك من إعادة استخدام الملف المحفوظ الخاص به. |

10 طلبات البحث بالإضافة إلى 50 مقاطع الفيديو المختصرة مع البيانات الوصفية والتسميات التوضيحية تتطلب 110 طلبات قياسية قبل إعادة الاستخدام المحلي. فصل تكاليف الاكتشاف عن التخصيب. لا تعتبر نتيجة البحث في حد ذاتها طلب بحث منفصل.

### البحث ليس ترحيلًا للمؤشر

يمكن لـ ScrapeCreators إرجاع عدة أنواع من النتائج باستخدام continuationToken. يؤدي البحث القياسي لـ FlashData إلى إرجاع نتائج الفيديو؛ البحث الموسع له حدود وأسعار منفصلة. ابدأ عملية اكتشاف جديدة بدلاً من إعادة استخدام المؤشر القديم.

[YouTube مرجع البحث](https://flashdata.dev/ar/docs/sources/youtube_search/reference.md)

### احتفظ بالدليل مع الجواب

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

[وصفة التسميات التوضيحية ذات الطابع الزمني](https://flashdata.dev/ar/docs/guides/timestamped-captions-recipe/reference.md)

### Scale القائمة ID بشكل منفصل

بعد إجراء عملية بحث واحدة، استخدم batch طلبات للحصول على قائمة أو معالجة مجمعة لملف. تتبع المهمة IDs، وحفظ completed المخرجات وإعادة المحاولة فقط failed العناصر. اجعل عداءك مسؤولاً عن الجدول الزمني.

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

<a id="agents"></a>
## إثبات الترحيل قبل جدولته

يمكن أن يبدأ عملاء مؤهلون 1 credit (حتى) 100 المعيار YouTube طلبات البيانات) 72 ساعات. ويتقاسم البدل البيانات الوصفية والاستيلاء والبحث.

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

```text
Migrate only this app's YouTube metadata and native-caption calls to FlashData.
Read https://flashdata.dev/auth.md and https://flashdata.dev/agents.md first.
Reuse saved access; start an eligible trial only if needed. Keep credentials out of chat.
Inspect our current fields, language choice, original_audio behavior and cache freshness requirements.
Keep comments, other social platforms and unsupported fields on their existing path.
Run one known video with explicit language and caption origin. Save the raw response and usage.
Map timestamps from seconds to string milliseconds; preserve null counts and missing-track errors.
Reuse saved output before requesting it again. Do not retry an uncertain submission automatically.
Before recurring use, ask the owner to claim access and approve permissions and shared-balance use.
Persist the resulting credential and stop on revocation or insufficient balance.
```

[المحاكمة والمطالبة](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>
## قبل التبديل

### هل هذه اشتراكات شهرية؟

ScrapeCreators Freelance و Business هي باقات مسبقة الدفع وليست اشتراكات. كلاهما لهما رسوم شهرية $0. FlashData لديه أرصدة الدفع أولاً بأول بالإضافة إلى الخطط الشهرية الاختيارية. قارن الاستخدام المستهلك والشراء المطلوب من رصيدك الحالي بشكل منفصل.

### ماذا لو تم تخزين معظم طلباتي التي تبلغ ScrapeCreators مؤقتًا؟

تكلف بيانات التعريف المدعومة ونتائج ذاكرة التخزين المؤقت للنص صفرًا من الاعتمادات. أدخل تلك النتائج المرصودة في الآلة الحاسبة. إذا قبل تطبيقك أعمارهم، فيمكن أن تكلف أقل من FlashData الطلبات الجديدة. يمكنك أيضًا حفظ مخرجات أي من الموفرين محليًا وتجنب تقديم الطلب التالي تمامًا.

### هل تنتهي صلاحية الاعتمادات غير المستخدمة؟

ScrapeCreators يقول أن الأرصدة المشتراة لا تنتهي صلاحيتها بموجب سياستها الحالية. عرض البدء المجاني برصيد 100 ليس إعادة تعبئة شهرية. تنتهي صلاحية تجربة الوكيل المؤقت لـ FlashData؛ تصف صفحات الأسعار والحساب شروط رصيد المالك المعمول بها.

### هل original_audio=true سيعمل كـ params.auto=true؟

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

### هل يمكنني استبدال جميع مكالمات البيانات الاجتماعية الخاصة بي؟

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

### هل يدعم ScrapeCreators أيضًا وكلاء الذكاء الاصطناعي؟

نعم. يقدم MCP، OAuth، CLI ومهارات الوكيل. يضيف تدفق وكيل FlashData تجربة مؤقتة مؤهلة ومطالبة المالك وبيانات الاعتماد المحفوظة للاستخدام المستمر. اختر API وسير العمل الذي تحتاجه مهمتك؛ MCP الدعم وحده ليس الفارق.
