# ScrapeCreators ทางเลือกสำหรับ YouTube ข้อมูล

เปรียบเทียบค่าเมทาดาทาและคำบรรยาย YouTube แพ็กเกจเติมเงิน และการพบข้อมูลในแคช ย้ายมา FlashData ด้วยตัวอย่างแปลงฟิลด์ Python และ Bash ที่เรียกใช้ได้สำหรับแอปและเอเจนต์

ข้อมูลวิดีโอสด การใช้จ่ายเริ่มต้นน้อยลง ย้าย YouTube การเรียกใช้ข้อมูลเมตาและคำอธิบายภาพโดยยังคงรักษาการผสานรวมข้อมูลโซเชียลที่เหลือของคุณ

ScrapeCreators ตรวจสอบข้อเท็จจริงแล้ว 2026-11-10 FlashData ราคาและค่าเผื่อการทดลองใช้มาจากแค็ตตาล็อกสาธารณะในปัจจุบัน

- [คุณสมบัติ](#features)
- [ราคาและแคช](#costs)
- [โยกย้ายคำขอ](#migration)
- [ขั้นตอนการวิจัย](#workflow)
- [สำหรับตัวแทน AI](#agents)
- [คำถามที่พบบ่อย](#faq)

<a id="features"></a>
## เปรียบเทียบคุณสมบัติ

### ลดต้นทุนข้อมูลใหม่ YouTube

| คุณสมบัติ | FlashData | ScrapeCreators |
| --- | --- | --- |
| อัตราค่าเข้า / 1,000 ข้อมูลเมตาหรือการโทรคำบรรยาย | $0.50 — การใช้งานแบบจ่ายตามการใช้งาน | $1.88 — Freelance · โทรใหม่หนึ่งเครดิต |
| อัตราหน่วยต่ำสุดที่ระบุไว้ / 1,000 โทร | $0.20 — แผนรายเดือนเสริม ยังคงมีค่าธรรมเนียมอยู่ | $0.994 — Business · $497 แพ็คแบบเติมเงิน; ไม่รวม Enterprise แบบกำหนดเอง |
| การซื้อเครดิตที่ชำระครั้งแรก | จาก $10 | $47 — 25,000-เครดิต Freelance แพ็ก |
| จ่ายตามที่คุณไปโดยไม่มีค่าธรรมเนียมรายเดือน | ใช่ | ใช่ |

### ค้นหาวิดีโอและรีเฟรชข้อเท็จจริงที่คุณต้องการ

| คุณสมบัติ | FlashData | ScrapeCreators |
| --- | --- | --- |
| ค้นหาวิดีโอตามคำหลักและตัวกรอง | ใช่ — ตัวกรองวันที่ ระยะเวลา ประเภท และการเรียงลำดับ | ใช่ — ตัวกรองการค้นหาและการแบ่งหน้าโทเค็นความต่อเนื่อง |
| ข้อมูลเมตาสำหรับวิดีโอที่รู้จัก | ใช่ — ชื่อ ช่อง ระยะเวลา ภาพขนาดย่อ และจำนวนการมีส่วนร่วม | ใช่ — วิดีโอ/Short จุดสิ้นสุดรายละเอียด |
| เครื่องหมายบทสำหรับการนำทาง | ใช่ — include_chapters; ชื่อเรื่องที่มีเวลา start/end เมื่อปรากฏ | ใช่ — บทต่างๆ ในวิดีโอตอบกลับเมื่อมีอยู่ |
| ค้นหาแทร็กคำอธิบายภาพที่มีอยู่ | รายการภาษาของข้อมูลเมตา — hasTranscripts และ transcriptLanguages | ข้อมูลเมตา captionTracks — รหัสภาษาและรายละเอียดแทร็ก |

### เลือกคำบรรยายและหลักฐานให้ชัดเจน

| คุณสมบัติ | FlashData | ScrapeCreators |
| --- | --- | --- |
| ข้อความและการประทับเวลาจากการตอบกลับเดียวกัน | ข้อความฉบับเต็ม + ส่วนที่มีการกำหนดเวลา — เริ่มต้น/end ครั้งในหน่วยวินาที | ข้อความฉบับเต็ม + ส่วนที่มีการกำหนดเวลา — startMs/endMs เป็นสตริงมิลลิวินาที |
| คำบรรยายหลายภาษาในคำขอเดียว | มากถึง 10 ภาษา — แทร็กที่มีอยู่พร้อมข้อผิดพลาดต่อภาษา | หนึ่งภาษาที่เลือก — ภาษาหรือการเลือก original_audio ต่อการถอดเสียง |
| เลือกที่มาของคำบรรยายอย่างชัดเจน | ผู้อัปโหลดหรือสร้างขึ้น YouTube — params.auto เลือกหนึ่งต้นทาง | การเลือกภาษาและเสียงพูด — original_audio ไม่ใช่การสลับที่มาของคำบรรยาย |
| การจัดการคำบรรยายที่ขาดหายไป | แทร็กที่มีอยู่และข้อผิดพลาดที่ชัดเจน — อาร์เรย์ภาษาจะรักษาเส้นทางที่ประสบความสำเร็จและรายงานการเลือกที่ขาดหายไป | ช่องการถอดเสียงเป็น Null — แทร็กที่ร้องขอหายไปจะต้องเสียเครดิตเป็นศูนย์ ไม่ YouTube การถอดเสียง AI |
| เลือกว่าข้อมูลที่นำกลับมาใช้ใหม่มีอายุเท่าใด | นโยบายแคชในแอปพลิเคชันของคุณ — ประหยัดเวลาในการดึงข้อมูลและตัดสินใจว่าจะดึงข้อมูลอีกครั้งเมื่อใด | cache_max_age — ตัวเลือก 1–30 วัน; การเข้าถึงแคชมีค่าใช้จ่ายเป็นศูนย์เครดิตและเปิดเผย cached_at |

### เรียกใช้เวิร์กโฟลว์ข้อมูลที่ทำซ้ำได้

| คุณสมบัติ | FlashData | ScrapeCreators |
| --- | --- | --- |
| ประมวลผลไฟล์วิดีโอที่บันทึกไว้ IDs | จัดการงานจำนวนมาก — ส่งไฟล์ ติดตามงาน และดึงข้อมูลเอาต์พุต | การโทรปลายทางต่อวิดีโอ — จัดการลูปไฟล์และพื้นที่จัดเก็บผลลัพธ์ในการผสานรวมของคุณ |
| ย้ายคอลเลกชันที่ยาวไปสู่งานเบื้องหลัง | API แบบ Async, Batch และ Bulk — คงงานIDs ติดตามสถานะและรับผลลัพธ์ | การโทรแบบซิงโครนัส YouTube — เข้าคิวและจุดตรวจสอบต่อการโทรวิดีโอในพนักงานของคุณ |
| เอาต์พุตที่มีโครงสร้างและอ่านได้ | JSON ข้อความธรรมดา หรือ Markdown — เลือกผ่านส่วนหัวการตอบกลับ API | รูปแบบ JSON API และ CLI — CLI ยังส่งออก CSV ตาราง และ Markdown |
| การติดตั้งเทอร์มินัล | ปฏิบัติการแบบสแตนด์อโลน — Linux, macOS ถึง Windows;; ไม่ มี พยัก หน้า/Python เวลาทํางาน | เวลาต่อนาที CLI — @scrapecreators/cli |
| MCP และทักษะตัวแทน | ใช่ | ใช่ |
| ดำเนินการต่อจากข้อมูลไปยังการจัดส่งสื่อที่โฮสต์ | ใช่ — YouTube ดาวน์โหลดลงที่เก็บข้อมูลของคุณ สิทธิ์แยกต่างหากและราคาตาม GB | แยกเวิร์กโฟลว์การดาวน์โหลด — YouTube ข้อมูลเมตาและ API การถอดเสียงไม่ส่งไฟล์สื่อ |

ทั้งสองเสนอการเข้าถึงแบบชำระล่วงหน้า 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 |

จำนวนคำขอที่รวมไว้คำนวณโดยใช้ยอดคงเหลือร่วมทั้งหมดของแพ็กเกจกับ YouTube Data มาตรฐาน Extended Search และ Download มีอัตราแยกต่างหาก [ราคาทั้งหมด](https://flashdata.dev/th/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 ข้อมูลเมตาและคำอธิบายภาพใช้คำขอ 2 รายการจากทั้งสองด้าน เฉพาะการเข้าถึงแคชเมตาดาต้า/transcriptที่ป้อนด้านบนเท่านั้นที่จะถูกหักออก ไม่ถือว่าแคชการค้นหา โมเดลนี้จะนับคำบรรยายที่ส่งคืน ไม่ใช่จำนวนครั้งที่พลาด และไม่รวมการสร้าง AI FlashData ใช้มาตรฐานปัจจุบัน YouTube ราคาข้อมูล โดยจัดสรรแผนเผื่อเลือกทั้งหมดก่อนการใช้งานเพิ่มเติม การค้นหาและดาวน์โหลดเพิ่มเติมมีราคาแยกต่างหาก ไม่รวมยอดคงเหลือเริ่มต้น การทดลองใช้งาน โบนัสเครดิต ภาษี และการใช้งานอื่น ๆ การซื้อเริ่มต้นจากยอดคงเหลือเป็นศูนย์: การเติมเงิน FlashData มีขั้นต่ำ $10 ScrapeCreators การซื้อจะปัดเศษเป็นแพ็กที่เลือกทั้งหมด เครดิตที่ซื้อที่ไม่ได้ใช้สามารถให้บริการงานในภายหลังได้ ScrapeCreators ไม่มีการต่ออายุแพ็ครายเดือน แผนรายเดือน FlashData ที่เลือกยังคงมีค่าธรรมเนียมโดยไม่มีคำขอ

### ลักษณะการทำงานของแคช

สำหรับ endpoint เมทาดาทา/บทถอดเสียงที่รองรับ cache_max_age รับค่า 1d, 3d, 7d, 14d หรือ 30d หากพบในแคชจะไม่ใช้เครดิตและรายงาน cached_at หากไม่พบจะคิดอัตราปกติ ไม่ถือว่าการค้นหาจะพบในแคชโดยอัตโนมัติ ตรวจสอบว่าข้อมูลที่บันทึกไว้ใหม่พอสำหรับงานหรือไม่ [บันทึกและนำผลลัพธ์กลับมาใช้](https://flashdata.dev/th/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 manual ค่าเริ่มต้นคือคำบรรยายภาษาอังกฤษที่สร้าง 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
```

สำหรับคำบรรยายที่ผู้อัปโหลดให้ไว้ ให้ผนวก en manual แต่ละโฟลเดอร์เอาต์พุตใหม่จะส่งคำขอหนึ่งรายการ อาร์กิวเมนต์และโฟลเดอร์เดียวกันนำเอาต์พุตที่บันทึกไว้กลับมาใช้ใหม่ ใช้โฟลเดอร์ใหม่เพื่อการรีเฟรชโดยเจตนาหลังจากตรวจสอบความพยายามครั้งก่อน

### 3. อ่านเอาต์พุตที่แมปและการใช้งานจริง

Captions-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/th/docs/sources/youtube_transcript/reference.md) · [สคีมาเมทาดาทา](https://flashdata.dev/th/docs/sources/youtube_metadata/reference.md)

### หากคำขอแรกล้มเหลว

- 401/403: ตรวจสอบคีย์ที่บันทึกไว้และการอนุญาตแหล่งที่มา หยุดหากถูกเพิกถอน
- 402: เติมยอดคงเหลือของเจ้าของก่อนที่จะดำเนินการต่อ
- 429: อ่านส่วนหัว Retry-After ที่บันทึกไว้; ลดความถี่ในการร้องขอ การทดลองใช้ชั่วคราวอนุญาตหนึ่งคำขอต่อวินาที
- เส้นทางที่ขาดหายไป: ตรวจสอบภาษาและที่มาที่มีอยู่ ScrapeCreators สามารถส่งคืนการตอบกลับที่สำเร็จด้วยสำเนา null อย่าสับสนกับแทร็ก completed FlashData
- โฟลเดอร์หมดเวลาหรือไม่สมบูรณ์: ตรวจสอบประวัติและเอาต์พุตก่อนลองอีกครั้ง สคริปต์จะรักษาความพยายามไว้โดยไม่ต้องส่งใหม่โดยอัตโนมัติ

[ข้อผิดพลาดและรหัสสถานะ](https://flashdata.dev/th/docs/errors/reference.md)

<a id="workflow"></a>
## ค้นหา → รายการสั้น → เพิ่มคุณค่า → อ้างอิง

| ขั้นตอน | ทำงาน | จำนวนคำขอ |
| --- | --- | --- |
| ค้นพบ | เรียกใช้คำขอค้นหา P YouTube | P คำขอค้นหามาตรฐาน นับคำขอจริง ไม่ใช่ทุกวิดีโอที่ส่งคืนเป็นการค้นหาแยกต่างหาก |
| เลือก | ทำซ้ำและรายการโปรด N วิดีโอ IDs | การกรองท้องถิ่น ยังไม่มีการขอข้อมูลเมตาหรือคำอธิบายภาพ |
| เต็มอิ่ม | ดึงข้อมูลเมตาสำหรับรายการสั้น IDs | คำขอข้อมูลเมตา N; ทำซ้ำเมื่อต้องการรีเฟรชเมตริกเท่านั้น |
| อ้างอิง | ดึงข้อมูลแทร็กคำบรรยายที่มีอยู่หนึ่งแทร็กต่อ ID | N คำขอใบรับรองผลการเรียนเมื่อมี จัดเก็บภาษา ต้นกำเนิด และการกำหนดเวลาคิวด้วยแหล่งที่มา URL |
| ใช้ซ้ำ | อ่านผลลัพธ์ที่บันทึกไว้สำหรับงานถัดไป | ไม่มีการร้องขอจากผู้ให้บริการเมื่อแอปของคุณสามารถใช้ไฟล์ที่บันทึกไว้ของตัวเองซ้ำได้ |

10 คำขอค้นหาบวก 50 วิดีโอสั้น ๆ ที่มีข้อมูลเมตาและคำบรรยายต้องมี 110 คำขอมาตรฐานก่อนที่จะนำมาใช้ซ้ำในเครื่อง แยกต้นทุนการค้นพบออกจากการเพิ่มคุณค่า ผลการค้นหาไม่ใช่คำขอค้นหาแยกต่างหาก

### การค้นหาไม่ใช่การโยกย้ายเคอร์เซอร์แบบดรอปอิน

ScrapeCreators สามารถส่งคืนผลลัพธ์ได้หลายประเภทด้วย continuationToken การค้นหามาตรฐานของ FlashData จะแสดงผลลัพธ์วิดีโอ Extended Search มีข้อจำกัดและราคาแยกกัน เริ่มดำเนินการค้นหาใหม่แทนที่จะใช้เคอร์เซอร์เก่าซ้ำ

[YouTube การอ้างอิงการค้นหา](https://flashdata.dev/th/docs/sources/youtube_search/reference.md)

### เก็บหลักฐานพร้อมคำตอบ

จัดเก็บวิดีโอ ID, URL, ภาษาที่เลือก, ที่มาของคำบรรยาย และเวลาเริ่มต้นของเซ็กเมนต์ ลิงก์การอ้างอิงสามารถชี้ไปที่การประทับเวลานั้นได้ อย่าติดป้ายกำกับแทร็กคำบรรยายที่ขาดหายไปว่าเป็นการถอดเสียงที่สำเร็จที่ว่างเปล่า

[ตัวอย่างคำบรรยายพร้อมเวลา](https://flashdata.dev/th/docs/guides/timestamped-captions-recipe/reference.md)

### Scale ID รายการแยกกัน

หลังจากการค้นหาครั้งหนึ่งใช้งานได้ ให้ใช้คำขอ batch สำหรับรายการหรือการประมวลผลไฟล์จำนวนมาก ติดตามงาน IDs บันทึก completed เอาต์พุต แล้วลองใหม่เฉพาะ failed รายการ ให้นักวิ่งของคุณรับผิดชอบตารางเวลา

[เอกสารอ้างอิงการประมวลผล Bulk](https://flashdata.dev/th/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/th/docs/guides/agent-onboarding/reference.md) · [CLI แบบสแตนด์อโลน](https://flashdata.dev/th/docs/guides/flashdata-cli/reference.md) · [ตั้งค่า MCP](https://flashdata.dev/th/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 รองรับตัวแทน AI ด้วยหรือไม่

ใช่ เสนอทักษะ MCP, OAuth, CLI และตัวแทน โฟลว์ตัวแทนของ FlashData เพิ่มการทดลองใช้ชั่วคราวที่มีสิทธิ์ การอ้างสิทธิ์ของเจ้าของ และบันทึกข้อมูลรับรองเพื่อการใช้งานต่อไป เลือก API และเวิร์กโฟลว์ที่งานของคุณต้องการ MCP การสนับสนุนเพียงอย่างเดียวก็ไม่ต่างกัน
