# ScrapeCreators Thay thế cho dữ liệu YouTube

So sánh YouTube chi phí siêu dữ liệu và phụ đề, gói trả trước và số lần truy cập bộ đệm. Di chuyển sang FlashData bằng bộ điều hợp trường Python và Bash có thể chạy được cho ứng dụng và tác nhân.

Dữ liệu video mới. Một khoản chi tiêu ban đầu nhỏ hơn. Di chuyển YouTube siêu dữ liệu và cuộc gọi phụ đề trong khi vẫn giữ phần còn lại của quá trình tích hợp dữ liệu xã hội của bạn.

ScrapeCreators sự kiện được xem xét 2026-11-10. FlashData giá cả và trợ cấp dùng thử đến từ các danh mục công khai hiện tại của nó.

- [Tính năng](#features)
- [Giá cả và bộ nhớ đệm](#costs)
- [Di chuyển một yêu cầu](#migration)
- [Quy trình nghiên cứu](#workflow)
- [Dành cho tác nhân AI](#agents)
- [Câu hỏi thường gặp](#faq)

<a id="features"></a>
## So sánh tính năng

### Giảm chi phí dữ liệu mới YouTube

| tính năng | FlashData | ScrapeCreators |
| --- | --- | --- |
| Tỷ lệ trả phí đầu vào / 1,000 siêu dữ liệu hoặc cuộc gọi phụ đề | $0.50 — Sử dụng trả tiền theo mức sử dụng | $1.88 — Freelance · cuộc gọi một tín dụng mới |
| Đơn giá niêm yết thấp nhất / 1,000 cuộc gọi | $0.20 — Gói hàng tháng tùy chọn; phí của nó vẫn được áp dụng | $0.994 — Business · $497 gói trả trước; doanh nghiệp tùy chỉnh bị loại trừ |
| Mua tín dụng trả tiền đầu tiên | Từ $10 | $47 — gói 25,000-tín dụng Freelance |
| Thanh toán theo nhu cầu sử dụng mà không phải trả phí hàng tháng | Có | Có |

### Tìm video và làm mới thông tin bạn cần

| tính năng | FlashData | ScrapeCreators |
| --- | --- | --- |
| Tìm video theo từ khóa và bộ lọc | Có — Bộ lọc ngày, thời lượng, loại và sắp xếp | Có — Bộ lọc tìm kiếm và phân trang mã thông báo tiếp tục |
| Siêu dữ liệu cho một video đã biết | Có — Tiêu đề, kênh, thời lượng, hình thu nhỏ và số lượng tương tác | Có — Video/Short Điểm cuối chi tiết |
| Đánh dấu chương để điều hướng | Có — include_chapters; tiêu đề có điểm bắt đầu/end lần khi có mặt | Có — các chương trong video phản hồi khi có mặt |
| Khám phá các bản phụ đề có sẵn | Danh sách ngôn ngữ siêu dữ liệu — hasTranscripts và transcriptLanguages | Siêu dữ liệu captionTracks — Mã ngôn ngữ và chi tiết bản nhạc |

### Giữ lựa chọn chú thích và bằng chứng rõ ràng

| tính năng | FlashData | ScrapeCreators |
| --- | --- | --- |
| Văn bản và dấu thời gian từ cùng một phản hồi | Toàn văn + phân đoạn theo thời gian — Bắt đầu/end lần trong vài giây | Toàn văn + phân đoạn theo thời gian — startMs/endMs dưới dạng chuỗi mili giây |
| Một số ngôn ngữ phụ đề trong một yêu cầu | Lên tới 10 ngôn ngữ — Các bản nhạc hiện có cộng với lỗi theo ngôn ngữ | Một ngôn ngữ được chọn — lựa chọn ngôn ngữ hoặc original_audio cho mỗi cuộc gọi bản ghi |
| Chọn nguồn gốc chú thích một cách rõ ràng | Người tải lên hoặc do YouTube tạo — params.auto chọn một điểm gốc | Lựa chọn ngôn ngữ và giọng nói — original_audio không phải là nút chuyển nguồn gốc phụ đề |
| Xử lý thiếu phụ đề | Các bản nhạc hiện có và lỗi rõ ràng — Mảng ngôn ngữ lưu giữ các bản nhạc thành công và báo cáo các lựa chọn bị thiếu | Trường bảng điểm rỗng — Thiếu các bản nhạc được yêu cầu sẽ không tốn tín dụng; không YouTube Phiên âm AI |
| Chọn độ cũ của dữ liệu được sử dụng lại | Chính sách bộ đệm trong ứng dụng của bạn — Tiết kiệm thời gian truy xuất và quyết định thời điểm tìm nạp lại | cache_max_age — Tùy chọn 1–30 ngày; lượt truy cập bộ đệm không tốn tín dụng và bị lộ cached_at |

### Chạy quy trình làm việc dữ liệu có thể lặp lại

| tính năng | FlashData | ScrapeCreators |
| --- | --- | --- |
| Xử lý tệp video đã lưu IDs | Công việc hàng loạt được quản lý — Gửi tệp, theo dõi công việc của nó và truy xuất kết quả đầu ra | Cuộc gọi điểm cuối trên mỗi video — Quản lý vòng lặp tệp và lưu trữ kết quả trong tích hợp của bạn |
| Di chuyển các bộ sưu tập dài vào các công việc nền | API không đồng bộ, hàng loạt và hàng loạt — Kiên trì công việc IDs, theo dõi trạng thái và truy xuất kết quả | Cuộc gọi YouTube đồng bộ — Xếp hàng và điểm kiểm tra cho mỗi cuộc gọi video trong nhân viên của bạn |
| Đầu ra có cấu trúc và có thể đọc được | JSON, văn bản thuần túy hoặc Markdown — Được chọn thông qua API tiêu đề phản hồi | Các định dạng JSON API và CLI — CLI cũng xuất CSV, bảng và Markdown |
| Cài đặt thiết bị đầu cuối | Thực thi độc lập — Linux, macOS và Windows; không có thời gian chạy Node/Python | npm CLI — @scrapecreators/cli |
| MCP và kỹ năng tác nhân | Có | Có |
| Tiếp tục từ dữ liệu đến phân phối phương tiện được lưu trữ | Có — YouTube Tải xuống bộ nhớ của bạn; quyền riêng biệt và giá dựa trên GB | Quy trình làm việc của trình tải xuống riêng biệt — YouTube API siêu dữ liệu và bản ghi không cung cấp tệp phương tiện |

Cả hai đều cung cấp quyền truy cập trả trước, MCP, CLI và kỹ năng tác nhân. ScrapeCreators cũng bao gồm các nền tảng xã hội khác và YouTube bình luận. Lượt truy cập bộ đệm được hỗ trợ là miễn phí.

### Làm mới các video bạn quan tâm

Tỷ lệ sử dụng theo yêu cầu thấp hơn rất quan trọng khi bạn làm mới các chỉ số thay đổi hoặc thu thập phụ đề cho video mới. Giữ bản ghi đã lưu và chỉ yêu cầu siêu dữ liệu khi cần cập nhật.

### Bắt đầu với việc mua hàng nhỏ hơn

FlashData nạp tiền tín dụng bắt đầu từ $10. Trước tiên, hãy di chuyển một khối lượng công việc YouTube, trong khi tích hợp hiện tại của bạn tiếp tục xử lý các nhận xét và nền tảng xã hội khác.

### Chọn bản phụ đề chính xác

Chọn rõ ràng phụ đề do người tải lên cung cấp hoặc YouTube tạo. Yêu cầu tới 10 ngôn ngữ hiện có trong một yêu cầu chép lời và xử lý riêng kết quả của từng ngôn ngữ.

<a id="costs"></a>
## So sánh các yêu cầu mới, số lần truy cập bộ đệm và các giao dịch mua trả trước

| ScrapeCreators ưu đãi | Mua một lần | Tín dụng | Mỗi 1,000 cuộc gọi một tín dụng mới | Phí hằng tháng |
| --- | --- | --- | --- | --- |
| Ưu đãi miễn phí ban đầu | $0 | 100 một lần | Trợ cấp khởi đầu miễn phí | $0 |
| Freelance | $47.00 | 25,000 | $1.88 | $0 |
| Business | $497.00 | 500,000 | $0.994 | $0 |
| Doanh nghiệp | tùy chỉnh | 1,000,000+ | tùy chỉnh | $0 cho các khoản tín dụng trả trước |

Đây là những gói trả trước không cần gia hạn hàng tháng. Business chính xác là $0.994 cho mỗi 1,000 cuộc gọi một tín dụng; $0.99 được làm tròn. Tín dụng đã mua không có thời hạn sử dụng theo chính sách hiện hành. Các khoản tín dụng tiền thưởng ban đầu và kiếm được sẽ bị loại khỏi mô hình.

| kế hoạch FlashData | Mỗi 1,000 yêu cầu | Phí hằng tháng | Số yêu cầu đi kèm mỗi tháng |
| --- | --- | --- | --- |
| Thanh toán theo mức sử dụng | $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 |

Số yêu cầu đi kèm giả định toàn bộ số dư dùng chung của gói được dành cho YouTube Data tiêu chuẩn. Extended Search và Download có đơn giá riêng. [Bảng giá đầy đủ](https://flashdata.dev/vi/pricing/youtube-data).

### Ví dụ: siêu dữ liệu và chú thích cho video 1,000

2,000 yêu cầu, không tìm kiếm khám phá. FlashData trả theo mức sử dụng so với ScrapeCreators Freelance. Chỉ đếm số lần truy cập bộ đệm được quan sát; các yêu cầu được tránh thông qua bộ nhớ cục bộ của riêng bạn sẽ không được gửi tới nhà cung cấp nào.

| Lượt truy cập bộ nhớ đệm miễn phí | FlashData cuộc gọi | FlashData cách sử dụng | FlashData mua hàng | ScrapeCreators tín dụng | ScrapeCreators giá trị sử dụng | ScrapeCreators mua hàng |
| --- | --- | --- | --- | --- | --- | --- |
| 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, một tháng yêu cầu. Một lần tra cứu siêu dữ liệu mới, kết quả có phụ đề gốc hoặc yêu cầu tìm kiếm tiêu chuẩn sử dụng một tín dụng ScrapeCreators. Siêu dữ liệu cộng với chú thích sử dụng hai yêu cầu ở cả hai bên. Chỉ các lần truy cập bộ nhớ đệm siêu dữ liệu/transcript được nhập ở trên mới bị khấu trừ; bộ nhớ đệm tìm kiếm không được giả định. Mô hình này tính các chú thích được trả về, không tính các lần thử bỏ sót bản nhạc và loại trừ việc tạo AI. FlashData sử dụng tiêu chuẩn hiện tại YouTube Giá dữ liệu, phân bổ toàn bộ trợ cấp gói đã chọn trước khi sử dụng thêm. Tìm kiếm mở rộng và Tải xuống được định giá riêng. Số dư ban đầu, số lần dùng thử, tín dụng thưởng, thuế và các mục đích sử dụng khác đều bị loại trừ. Giao dịch mua bắt đầu từ số dư bằng 0: FlashData nạp tiền có mức tối thiểu $10; ScrapeCreators số lần mua sẽ được tính thành toàn bộ gói đã chọn. Các khoản tín dụng đã mua chưa sử dụng có thể phục vụ các nhiệm vụ sau này. ScrapeCreators không gia hạn gói hàng tháng; gói hàng tháng FlashData đã chọn vẫn không tính phí khi yêu cầu.

### Hành vi bộ đệm

Với các endpoint siêu dữ liệu/bản chép lời được hỗ trợ, cache_max_age nhận 1d, 3d, 7d, 14d hoặc 30d. Khi trúng bộ nhớ đệm, yêu cầu không dùng tín dụng và trả về cached_at; nếu không trúng, áp dụng đơn giá thông thường. Không giả định có lượt tìm kiếm trúng bộ nhớ đệm. Hãy kiểm tra dữ liệu đã lưu có đủ mới cho tác vụ không. [Lưu và tái sử dụng kết quả](https://flashdata.dev/vi/docs/guides/save-results/reference.md).

### ưu đãi bắt đầu

ScrapeCreators bắt đầu với 100 tín dụng miễn phí. Những người đăng ký FlashData đã được xác minh đủ điều kiện có thể nhận được khoản trợ cấp ban đầu lên tới 4,000 tiêu chuẩn YouTube Yêu cầu dữ liệu. Những ưu đãi này không được đặt lại hàng tháng. Bản dùng thử tác nhân tạm thời riêng biệt xuất hiện bên dưới.

<a id="migration"></a>
## Di chuyển một video và dấu thời gian phụ đề của video đó

### 1. Thiết lập quyền truy cập và chọn bản nhạc

Tạo hoặc dùng lại khóa có quyền youtube_transcript và thêm youtube_metadata nếu cần gọi siêu dữ liệu. [Khóa API](https://flashdata.dev/app/api-keys) · [Tín dụng](https://flashdata.dev/app/billing). Lưu FLASHDATA_API_KEY trong biến môi trường hoặc nhập vào lời nhắc ẩn của tập lệnh; không bao giờ dán khóa vào cuộc trò chuyện.

Yêu cầu hiện tại, chỉ dành cho việc lập bản đồ:

```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 với X-API-Key và nội dung JSON này:

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

original_audio=true chọn ngôn ngữ nói. FlashData params.auto=true chọn chú thích do YouTube tạo. Chỉ định ngôn ngữ và nguồn gốc riêng biệt.

### 2. Lưu tập lệnh trước running nó

Yêu cầu Python 3.10+. Cài đặt thư viện bằng python -m pip install requests. Trong thư mục làm việc mới, lưu toàn bộ tập lệnh bên dưới thành creator-research.py trước khi chạy.

```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'))}")

```

Chạy từ thư mục đó bằng video có bản nhạc tiếng Anh hiện có. Siêu dữ liệu là một yêu cầu tùy chọn riêng biệt; trong thời gian dùng thử tạm thời, hãy để ít nhất một giây giữa các cuộc gọi.

```bash
python creator-research.py transcript FUfGcZ092b0 captions-001
# Optional metadata, run separately:
python creator-research.py metadata FUfGcZ092b0 metadata-001
```

Đối với phụ đề do người tải lên cung cấp, hãy thêm hướng dẫn sử dụng --origin. Mặc định là phụ đề tiếng Anh do YouTube tạo.

Ngoài ra, hãy sử dụng Bash, cURL 7.76+ và jq 1.6+. Lưu tập lệnh hoàn chỉnh bên dưới dưới dạng creator-research.sh trong thư mục làm việc mới.

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

Đối với phụ đề do người tải lên cung cấp, hãy thêm vào hướng dẫn sử dụng. Mỗi thư mục đầu ra mới gửi một yêu cầu. Các đối số và thư mục tương tự sẽ sử dụng lại kết quả đã lưu; sử dụng một thư mục mới để làm mới có chủ ý sau khi kiểm tra lần thử trước đó.

### 3. Đọc đầu ra được ánh xạ và mức sử dụng thực tế

chú thích-001/normalized.json là bộ điều hợp trường; response.json giữ lại phản hồi thô và cách sử dụng thực tế. Giây trở thành chuỗi mili giây. languageCode và isAutoGenerated giữ nguyên bản nhạc đã chọn. Đây không phải là phản hồi thả xuống hoàn chỉnh: không có số dư tín dụng được tạo ra, cờ bộ nhớ đệm, thuộc tính của người tải lên hoặc trường ngày. Siêu dữ liệu lưu giữ các số liệu bị thiếu dưới dạng null và ngày ban đầu của nó là 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 tích hợp | FlashData thay đổi |
| --- | --- |
| GET /v1/youtube/video?url=… | POST truy vấn API với nguồn: youtube_metadata và video_id. Đọc kết quả[0], không phải gốc phản hồi. |
| GET /v1/youtube/video/transcript?url=… | Nguồn sử dụng: youtube_transcript. Đặt params.language và params.auto một cách rõ ràng. |
| bảng điểm[].startMs / endMs | FlashData bắt đầu / kết thúc là giây. Nhân mỗi giá trị với 1,000 và tuần tự hóa dưới dạng chuỗi cho trình đọc mili giây hiện có. |
| original_audio=true | Chọn ngôn ngữ nói bằng ScrapeCreators, không phải phụ đề được tạo tự động. Giải quyết ngôn ngữ cần thiết trong ứng dụng của bạn; params.auto thay vào đó hãy chọn nguồn gốc của phụ đề. |
| ngôn ngữ và transcript_only_text | Bản đồ languageName và fullText. Giữ languageCode riêng biệt; tên ngôn ngữ và mã ngôn ngữ là các trường khác nhau. |
| viewCountInt, likeCountInt, commentCountInt | Bản đồ viewCount, likeCount, commentCount. Giữ nguyên null khi không có số liệu. |
| durationMs và publishDate | Chuyển đổi thời lượng giây thành mili giây. Giữ nguyên uploadDate dưới dạng trường thô cho đến khi ứng dụng của bạn xác thực định dạng ngày mà nó cần. |
| kênh / người tải lên / ownerByline | Kênh FlashData và channelId không tái tạo cả ba danh tính. Chỉ ánh xạ các trường mà người đọc của bạn cần; giữ một đường dẫn riêng cho việc ghi nhận tín dụng âm nhạc. |
| cached, cached_at, credits_charged | Giữ nguyên phản hồi và cách sử dụng FlashData. Ghi lại thời gian tìm nạp của riêng bạn; không tạo cờ bộ đệm của nhà cung cấp hoặc dịch số dư tín dụng giữa các nhà cung cấp. |

[Lược đồ bản chép lời](https://flashdata.dev/vi/docs/sources/youtube_transcript/reference.md) · [Lược đồ siêu dữ liệu](https://flashdata.dev/vi/docs/sources/youtube_metadata/reference.md)

### Nếu yêu cầu đầu tiên không thành công

- 401/403: kiểm tra khóa đã lưu và quyền nguồn; dừng lại nếu bị thu hồi.
- 402: bổ sung số dư của chủ sở hữu trước khi tiếp tục.
- 429: đọc tiêu đề Retry-After đã lưu; giảm tần suất yêu cầu. Thử nghiệm tạm thời cho phép một yêu cầu mỗi giây.
- Bản nhạc bị thiếu: xác minh ngôn ngữ và nguồn gốc có sẵn. ScrapeCreators có thể trả về phản hồi thành công với bản ghi null; đừng nhầm lẫn điều này với bản nhạc completed FlashData.
- Thư mục hết thời gian chờ hoặc chưa đầy đủ: kiểm tra Lịch sử và đầu ra trước khi thử lại. Tập lệnh duy trì nỗ lực mà không cần gửi lại tự động.

[Lỗi và mã trạng thái](https://flashdata.dev/vi/docs/errors/reference.md)

<a id="workflow"></a>
## Tìm → danh sách rút gọn → làm phong phú → trích dẫn

| Bước | làm việc | Số lượng yêu cầu |
| --- | --- | --- |
| Khám phá | Chạy P YouTube Yêu cầu tìm kiếm | P yêu cầu tìm kiếm tiêu chuẩn. Tính các yêu cầu thực tế chứ không phải mọi video được trả về dưới dạng tìm kiếm riêng biệt. |
| chọn | Loại bỏ trùng lặp và đưa vào danh sách rút gọn N video IDs | Lọc cục bộ; chưa có yêu cầu siêu dữ liệu hoặc phụ đề. |
| làm giàu | Tìm nạp siêu dữ liệu cho danh sách rút gọn IDs | N yêu cầu siêu dữ liệu; chỉ lặp lại khi số liệu cần được làm mới. |
| Trích dẫn | Tìm nạp một bản phụ đề hiện có cho mỗi ID | N yêu cầu bảng điểm khi có sẵn. Lưu trữ ngôn ngữ, nguồn gốc và thời gian gợi ý với nguồn URL. |
| Tái sử dụng | Đọc kết quả đã lưu cho nhiệm vụ tiếp theo | Không có nhà cung cấp nào yêu cầu ứng dụng của bạn có thể sử dụng lại tệp đã lưu của chính nó. |

10 yêu cầu tìm kiếm cộng với 50 video được đưa vào danh sách rút gọn có siêu dữ liệu và chú thích yêu cầu 110 yêu cầu tiêu chuẩn trước khi sử dụng lại cục bộ. Tách biệt chi phí khám phá khỏi việc làm giàu. Bản thân kết quả tìm kiếm không phải là một yêu cầu tìm kiếm riêng biệt.

### Tìm kiếm không phải là di chuyển con trỏ thả vào

ScrapeCreators có thể trả về một số loại kết quả với continuationToken. Tìm kiếm tiêu chuẩn của FlashData trả về kết quả video; Tìm kiếm mở rộng của nó có giới hạn và giá cả riêng biệt. Bắt đầu quá trình khám phá mới thay vì sử dụng lại con trỏ cũ.

[YouTube Tìm kiếm tham khảo](https://flashdata.dev/vi/docs/sources/youtube_search/reference.md)

### Giữ bằng chứng với câu trả lời

Lưu trữ video ID, URL, ngôn ngữ đã chọn, nguồn gốc chú thích và thời gian bắt đầu phân đoạn. Một liên kết trích dẫn có thể trỏ đến dấu thời gian đó. Không gắn nhãn phụ đề bị thiếu là bản ghi thành công trống.

[Ví dụ phụ đề có dấu thời gian](https://flashdata.dev/vi/docs/guides/timestamped-captions-recipe/reference.md)

### Scale danh sách ID riêng biệt

Sau khi một lần tra cứu hoạt động, hãy sử dụng batch yêu cầu cho danh sách hoặc xử lý hàng loạt cho một tệp. Theo dõi công việc IDs, lưu kết quả đầu ra completed và chỉ thử lại các mục failed. Giữ người chạy của bạn chịu trách nhiệm về lịch trình.

[Tài liệu tham chiếu xử lý Bulk](https://flashdata.dev/vi/docs/reference/bulk-processing/reference.md)

<a id="agents"></a>
## Chứng minh việc di chuyển trước khi lên lịch

Các tác nhân đủ điều kiện có thể bắt đầu với 1 credit (tối đa 100 tiêu chuẩn YouTube Yêu cầu dữ liệu) trong 72 giờ. Siêu dữ liệu, chú thích và tìm kiếm chia sẻ phụ cấp.

1. Kiểm tra các trường bắt buộc, mục đích và độ mới của phụ đề. Sử dụng lại quyền truy cập đã lưu; giữ các cuộc gọi dữ liệu xã hội không liên quan.
2. Chạy một video đã biết bằng cách sử dụng CLI, SDK hoặc MCP. Lưu đầu ra và kiểm tra thời gian, giá trị rỗng và mức sử dụng thực tế.
3. Chủ tài khoản đăng nhập hoặc đăng ký, xác minh email rồi chấp thuận liên kết, các quyền truy cập và việc dùng số dư chung. Tín dụng dùng thử chưa sử dụng không được chuyển sang tài khoản.
4. Duy trì thông tin xác thực của chủ sở hữu để sử dụng định kỳ. Tái sử dụng đầu ra và dừng khi thu hồi hoặc không đủ số dư.

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

[Dùng thử và liên kết tài khoản](https://flashdata.dev/vi/docs/guides/agent-onboarding/reference.md) · [CLI độc lập](https://flashdata.dev/vi/docs/guides/flashdata-cli/reference.md) · [Thiết lập MCP](https://flashdata.dev/vi/docs/integrations/mcp-clients/reference.md)

<a id="faq"></a>
## Trước khi bạn chuyển đổi

### Đây có phải là đăng ký hàng tháng?

ScrapeCreators Freelance và Business là gói trả trước, không phải gói đăng ký. Cả hai đều có phí hàng tháng $0. FlashData có các khoản tín dụng trả theo mức sử dụng cùng với các gói hàng tháng tùy chọn. So sánh riêng mức sử dụng đã tiêu thụ và số tiền mua cần thiết từ số dư hiện tại của bạn.

### Điều gì sẽ xảy ra nếu hầu hết các yêu cầu ScrapeCreators của tôi được lưu vào bộ nhớ đệm?

Các lần truy cập bộ đệm ẩn bản ghi và siêu dữ liệu được hỗ trợ không tốn tín dụng. Nhập những lượt truy cập được quan sát vào máy tính. Nếu ứng dụng của bạn chấp nhận độ tuổi của chúng, chúng có thể có giá thấp hơn FlashData yêu cầu mới. Bạn cũng có thể lưu cục bộ kết quả đầu ra của nhà cung cấp và tránh thực hiện yêu cầu tiếp theo.

### Các khoản tín dụng chưa sử dụng có hết hạn không?

ScrapeCreators cho biết các khoản tín dụng đã mua không hết hạn theo chính sách hiện tại. Ưu đãi bắt đầu tín dụng 100 miễn phí của nó không phải là nạp tiền hàng tháng. Thời gian dùng thử tác nhân tạm thời của FlashData hết hạn; các trang về giá và tài khoản của nó mô tả các điều khoản hiện hành về số dư chủ sở hữu.

### original_audio=true có hoạt động như params.auto=true không?

Không. Người đầu tiên chọn ngôn ngữ dựa trên âm thanh được nói; phần thứ hai chọn chú thích do YouTube tạo. Đặt ngôn ngữ và nguồn gốc một cách có chủ ý. Điểm cuối phụ đề gốc của cả hai dịch vụ đều không chuyển giọng nói thành văn bản khi không có bản nhạc phù hợp.

### Tôi có thể thay thế tất cả các cuộc gọi dữ liệu xã hội của mình không?

Quá trình di chuyển này bao gồm YouTube siêu dữ liệu video và phụ đề hiện có. Giữ nhận xét, bài đăng trong cộng đồng, hồ sơ xã hội và bất kỳ trường phản hồi không được hỗ trợ nào khác trên đường dẫn hiện có của chúng. FlashData cũng cung cấp Google Tìm kiếm và lưu trữ YouTube Tải xuống, với quyền và giá riêng.

### ScrapeCreators có hỗ trợ các tác nhân AI không?

Vâng. Nó cung cấp MCP, OAuth, CLI và các kỹ năng của tác nhân. Luồng tác nhân của FlashData bổ sung bản dùng thử tạm thời đủ điều kiện, chủ sở hữu xác nhận quyền sở hữu và lưu thông tin xác thực để tiếp tục sử dụng. Chọn API và quy trình làm việc mà nhiệm vụ của bạn cần; MCP Chỉ hỗ trợ thôi thì không có gì khác biệt.
