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

So sánh FlashData với Apify YouTube tác nhân: giá dành riêng cho tác nhân, ngân sách sử dụng hàng tháng, siêu dữ liệu và quy trình làm việc phụ đề cũng như các ví dụ di chuyển Python và Bash có thể chạy được.

Từ diễn viên chạy đến tra cứu video trực tiếp. Bắt đầu với IDs đã biết, bảo toàn các trường ứng dụng của bạn và di chuyển một nhà sản xuất trước khi thay đổi phần còn lại của quy trình.

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

- [Tính năng](#features)
- [Giá diễn viên](#actors)
- [So sánh chi phí](#costs)
- [Di chuyển tra cứu](#migration)
- [Bộ dữ liệu & lịch trình](#production)
- [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ữ cho việc tra cứu được nhắm mục tiêu tiết kiệm

| tính năng | FlashData | Apify YouTube diễn viên |
| --- | --- | --- |
| Sử dụng trả phí mà không cần đăng ký hàng tháng | Có — Tín dụng thanh toán khi bạn di chuyển; nạp tiền từ $10 | Ngân sách miễn phí, sau đó là gói trả phí — $5/tháng miễn phí; Starter $19/tháng với mức sử dụng $19 |
| Siêu dữ liệu cho 1,000 video đã biết IDs | $0.50 — Tỷ lệ sử dụng trả theo mức sử dụng | $3.00 — người truyền phát/youtube-scraper · tỷ lệ Starter, được khấu trừ vào ngân sách của kế hoạch |
| Tra cứu một video | Có — Một video_id rõ ràng | Phụ thuộc vào diễn viên — Các bộ truyền phát hỗ trợ nó; API Dojo hiện không bao gồm một video URLs |

### Tìm và làm phong phú các video mà ứng dụng của bạn cần

| tính năng | FlashData | Apify YouTube diễn viên |
| --- | --- | --- |
| Khám phá từ khóa với các bộ lọc tìm kiếm | Có — Bộ lọc ngày, thời lượng, loại và sắp xếp | Có — searchQueries cộng với các bộ lọc sắp xếp, ngày tháng và video |
| Tiêu đề, kênh và dữ liệu tương tác | Có — Tra cứu siêu dữ liệu chuyên dụng bằng video ID | Có — Bản ghi video trong bộ dữ liệu Diễn viên |
| Làm mới siêu dữ liệu riêng biệt với chú thích | Có — Chỉ yêu cầu youtube_metadata để làm mới | Có — Chạy với transcriptionAndSubtitle=NONE |

### Chuẩn bị bằng chứng chú thích cho đơn đăng ký của bạn

| tính năng | FlashData | Apify YouTube diễn viên |
| --- | --- | --- |
| Chọn một số ngôn ngữ phụ đề hiện có | Lên tới 10 ngôn ngữ rõ ràng — Các bản nhạc cộng với lỗi theo từng ngôn ngữ trong một yêu cầu chép lời | Diễn viên chính: một ngôn ngữ hoặc bất kỳ — Các tác nhân khác nhau có thể đưa ra những đầu vào khác nhau |
| Chọn nguồn gốc phụ đề nghiêm ngặt | Người tải lên hoặc do YouTube tạo — params.auto chọn một điểm gốc; không có dự phòng nhiều nguồn gốc | Diễn viên chính: ưu tiên xuất xứ — preferAutoGeneratedSubtitles là ưu tiên, không phải hợp đồng giống nhau |
| Văn bản được đánh dấu thời gian cho các trích dẫn nguồn | Phân đoạn JSON được chuẩn hóa — Nhắn tin với start/end lần tính bằng giây | Phụ đề SRT, VTT hoặc XML — Phân tích định dạng phụ đề đã chọn cho thời gian trích dẫn |
| Văn bản đơn giản để tóm tắt | fullText cùng với các phân đoạn | định dạng phụ đề văn bản gốc — Hoặc phân tích và nối đầu ra phụ đề theo thời gian |
| Video không có bản ghi hiện có | Báo cáo bài hát bị thiếu — Không tạo ra lời nói thành văn bản | Phiên âm AI tùy chọn — Chế độ dự phòng hoặc luôn phiên âm; phí sử dụng riêng |

### Chạy quy trình làm việc với ít mã tích hợp hơn

| tính năng | FlashData | Apify YouTube diễn viên |
| --- | --- | --- |
| Kết quả trực tiếp mà không cần quản lý tài nguyên Diễn viên | Kết quả thời gian thực[] + cách sử dụng — Không có diễn viên ID, cài đặt bản dựng hoặc bộ nhớ | Chạy diễn viên + lược đồ đầu vào — Điểm cuối đồng bộ hóa cũng có thể trả về kết quả sau một cuộc gọi HTTP |
| Xử lý danh sách đã lưu trong bảng điều khiển trình duyệt | Bulk Jobs với tệp video-ID — Theo dõi tiến trình và truy xuất các phần kê khai và kết quả | Bảng điều khiển dành cho diễn viên với đầu vào URL — Hỗ trợ nhập trang tính CSV hoặc Google |
| Kết quả nền sau khi máy khách ngắt kết nối | Đã lưu async hoặc Công việc hàng loạt ID — Tiếp tục kiểm tra trạng thái và truy xuất đầu ra completed | Đã lưu diễn viên và tập dữ liệu IDs — Kiểm tra quá trình chạy và truy xuất các mục dữ liệu của nó |
| Các định dạng đầu ra của ứng dụng và tác nhân | JSON, văn bản thuần túy hoặc Markdown | Xuất tập dữ liệu — JSON, CSV, Excel và các định dạng khác |
| Bộ sưu tập định kỳ | Người lập lịch trình hoặc máy chủ tác nhân của bạn — Sử dụng lại thông tin xác thực của chủ sở hữu và trạng thái công việc đã lưu | Lịch diễn viên được dẫn chương trình — Cron, cài đặt múi giờ và webhook tùy chọn |
| Siêu dữ liệu, chú thích và Google Tìm kiếm trong một hợp đồng API | Một truy vấn API, quyền dành riêng cho nguồn — Số dư tài khoản chung; giá theo nguồn cụ thể | Nền tảng chia sẻ; Lược đồ dành riêng cho tác nhân — Chọn và duy trì các đầu vào và đầu ra của Actor có liên quan |
| CLI, SDK và MCP để tự động hóa | Có — Độc lập CLI; Python, TypeScript và Go SDK; MCP | Có — Apify CLI, Python/JavaScript khách hàng và MCP |

Các hàng dành riêng cho diễn viên đề cập đến người truyền phát/youtube-scraper trừ khi một Diễn viên khác được nêu tên. Cả hai dịch vụ đều cung cấp SDK, CLI và MCP. Apify cũng chạy mã tùy chỉnh, lịch trình được lưu trữ và trình thu thập dữ liệu của các trang web khác.

### Giữ cho việc tra cứu một video ở quy mô nhỏ

Truyền video ID và nhận siêu dữ liệu trực tiếp. Sử dụng quyền truy cập trả tiền khi bạn thực hiện khi công việc không cần đăng ký nền tảng hoặc thu thập dữ liệu kênh.

### Giữ mô hình dữ liệu của ứng dụng của bạn

Ánh xạ các trường mà ứng dụng của bạn thực sự đọc. Giữ nguyên số lượng null, giữ ngày xuất bản rõ ràng và lưu mảng JSON cho người tiêu dùng trước đây đã đọc các mục tập dữ liệu.

### Giữ việc khám phá tách biệt với việc làm giàu

Tiếp tục quy trình khám phá hữu ích, loại bỏ trùng lặp video IDs, sau đó chỉ làm phong phú các video mà sản phẩm của bạn cần với FlashData.

<a id="actors"></a>
## Không có giá duy nhất Apify YouTube

Tác giả tác nhân chọn đầu vào, đầu ra và mô hình định giá. Ba tác nhân này sử dụng các sự kiện theo kết quả nhưng có các khả năng khác nhau. Giá bên dưới là USD cho mỗi 1,000 video được trả lại.

| diễn viên | Miễn phí / 1,000 video | Starter | Scale | Business | Chọn nó cho |
| --- | --- | --- | --- | --- | --- |
| streamers/youtube-scraper | $4.00 | $3.00 | $2.60 | $2.40 | Video URLs, khám phá và phụ đề hiện có tùy chọn. Đây là diễn viên của máy tính. |
| streamers/youtube-channel-scraper | $1.30 | $1.00 | $0.80 | $0.50 | Khám phá kênh với dữ liệu video cơ bản. Đây không phải là bản tra cứu siêu dữ liệu đầy đủ cho một ID tùy ý. |
| apidojo/youtube-scraper | $0.50 | $0.50 | $0.50 | $0.50 | Đầu vào khám phá. README hiện tại của nó không bao gồm URLs video đơn và yêu cầu ít nhất 10 video cho mỗi đầu vào. Bản demo miễn phí: 5 chạy/tháng, nhiều nhất là 10 mục/run. |

Các gói tự phục vụ hàng tháng: Starter ánh xạ tới Bronze, Scale đến Silver và Business đến Gold. Các tác nhân khám phá rẻ hơn không được thay thế bằng máy tính video đã biết.

### Kiểm tra sự kiện có thể lập hoá đơn

Apify hỗ trợ các mô hình trả tiền cho mỗi sự kiện, trả tiền cho mỗi lần sử dụng và kết hợp. Đối với người truyền phát/youtube-scraper, hãy đếm các sự kiện kết quả và các tiện ích bổ sung đã chọn; không tự động thêm phí điện toán chung. Kiểm tra phân tích sự kiện của lần chạy Diễn viên của riêng bạn.

### Tách phụ đề hiện có khỏi phiên âm AI

Diễn viên chính có thể bao gồm phụ đề hiện có trong kết quả của nó. Phiên âm AI của nó được tính phí theo phút bắt đầu trên mỗi video: vào Starter, video 10 phút sẽ thêm $0.41 trước sự kiện kết quả $0.003. Tóm tắt, mô tả và lọc ngày của kênh AI cũng có giá sự kiện riêng. FlashData truy xuất các bản nhạc hiện có; nó không tạo ra chú thích bị thiếu.

### Giữ việc khám phá tách biệt với việc làm giàu

Sử dụng video đã biết IDs khi đó là những gì ứng dụng của bạn đã có. Quá trình thu thập dữ liệu khám phá có thể trả về những video bạn không bao giờ sử dụng. Khám phá ngân sách và bất kỳ hoạt động làm giàu tiếp theo nào một cách riêng biệt.

<a id="costs"></a>
## So sánh đơn giá và phí hàng tháng

USD, kế hoạch danh sách hàng tháng. Mô hình này sử dụng sự kiện kết quả của các bộ truyền phát/youtube-scraper, một video được trả về cho mỗi đầu vào ID, tắt tính năng lọc ngày và các tiện ích bổ sung AI. Phụ đề hiện có sử dụng cài đặt ALWAYS_SUBTITLES của nó; siêu dữ liệu cộng với chú thích là một kết quả Diễn viên nhưng có hai yêu cầu FlashData. Giá FlashData được lấy từ danh mục dữ liệu YouTube hiện tại của nó. Toàn bộ số dư đi kèm của mỗi gói sẽ được phân bổ cho quy trình công việc này trước khi thêm mức sử dụng bổ sung. Apify Điểm dừng miễn phí ở mức ngân sách $5; gói trả phí bổ sung mức sử dụng vượt quá ngân sách bao gồm. FlashData các giao dịch mua từ số dư bằng 0 bao gồm số tiền nạp tối thiểu $10 khi cần thêm tín dụng. Không bao gồm thuế, chiết khấu hàng năm, các Tác nhân khác, phí lưu trữ/export riêng biệt và failed lần thử. Ở mức không có video, gói trả phí đã chọn vẫn có phí hàng tháng; chi phí hiệu quả cho mỗi video là không xác định.

### Apify kế hoạch nền tảng

| kế hoạch Apify | Phí hằng tháng | Đã bao gồm mức sử dụng/tháng | Diễn viên chính / 1,000 video | Video trong phạm vi ngân sách này |
| --- | --- | --- | --- | --- |
| Miễn phí | $0.00 | $5.00 | $4.00 | 1,250 |
| Starter | $19.00 | $19.00 | $3.00 | 6,333 |
| Scale | $199.00 | $199.00 | $2.60 | 76,538 |
| Business | $999.00 | $999.00 | $2.40 | 416,250 |

Số lượng này phân bổ toàn bộ ngân sách cho các sự kiện kết quả mà không cần sử dụng tiện ích bổ sung hoặc nền tảng khác. Nếu bạn giữ Apify cho các Diễn viên khác, đăng ký của nó vẫn còn; so sánh mức sử dụng gia tăng với ngân sách còn lại của bạn.

### FlashData YouTube Gói dữ liệu

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

Đây là đơn giá YouTube Data tiêu chuẩn. Extended Search và Download có giá riêng. [Bảng giá đầy đủ](https://flashdata.dev/vi/pricing/youtube-data).

### Ví dụ đã làm việc

FlashData thanh toán theo mức sử dụng so với Apify Starter và người truyền phát/youtube-scraper. Siêu dữ liệu cộng với phụ đề hiện có là một sự kiện kết quả Diễn viên nhưng có hai yêu cầu FlashData. Đây là ước tính mức sử dụng và chi phí hàng tháng, không phải là yêu cầu về các trường phản hồi giống hệt nhau.

| Video | Quy trình làm việc | FlashData yêu cầu | FlashData cách sử dụng được mô hình hóa | Cách sử dụng sự kiện của diễn viên | Apify chi phí hàng tháng bao gồm phí |
| --- | --- | --- | --- | --- | --- |
| 1,000 | Siêu dữ liệu cho video đã biết IDs | 1,000 | $0.50 | $3.00 | $19.00 |
| 1,000 | Siêu dữ liệu + chú thích hiện có | 2,000 | $1.00 | $3.00 | $19.00 |
| 10,000 | Siêu dữ liệu cho video đã biết IDs | 10,000 | $5.00 | $30.00 | $30.00 |
| 10,000 | Siêu dữ liệu + chú thích hiện có | 20,000 | $10.00 | $30.00 | $30.00 |
| 100,000 | Siêu dữ liệu cho video đã biết IDs | 100,000 | $50.00 | $300.00 | $300.00 |
| 100,000 | Siêu dữ liệu + chú thích hiện có | 200,000 | $100.00 | $300.00 | $300.00 |

FlashData giao dịch mua từ số dư bằng 0 có số tiền nạp tối thiểu $10. Phí của Apify đã bao gồm phí sử dụng; không thêm cách sử dụng đó hai lần. Máy tính HTML cho phép bạn chọn cả hai gói một cách độc lập.

### Truy cập miễn phí

Apify Miễn phí có ngân sách chia sẻ hàng tháng là $5; các hạn chế về bản demo Diễn viên riêng lẻ cũng có thể được áp dụng. API Dojo Actor được hiển thị ở trên giới hạn Miễn phí cho năm lần chạy demo mỗi tháng và mười vật phẩm mỗi lần chạy.

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. Điều này không được thiết lập lại hàng tháng.

<a id="migration"></a>
## Giữ trình đọc dữ liệu; thay thế một tra cứu

Bắt đầu với một video công khai đã biết ID. Ví dụ này ghi các trường Diễn viên quen thuộc đã chọn dưới dạng mảng JSON và lưu riêng phản hồi FlashData hoàn chỉnh.

### 1. Thiết lập quyền truy cập và ánh xạ yêu cầu

Tạo hoặc dùng lại khóa có quyền youtube_metadata trong [Khóa API](https://flashdata.dev/app/api-keys), rồi kiểm tra [Số dư tín dụng khả dụng](https://flashdata.dev/app/billing). Tác nhân nên dùng lại quyền truy cập trước, hoặc dùng thử nếu đủ điều kiện. Không đưa khóa vào cuộc trò chuyện.

Cuộc gọi Diễn viên hiện tại, để tham khảo di chuyển:

```bash
# The existing Actor call, shown for migration reference.
curl --fail-with-body --silent --show-error --max-time 310 \
  --request POST \
  'https://api.apify.com/v2/acts/streamers~youtube-scraper/run-sync-get-dataset-items' \
  --header "Authorization: Bearer $APIFY_TOKEN" \
  --header 'Content-Type: application/json' \
  --data '{"startUrls":[{"url":"https://www.youtube.com/watch?v=FUfGcZ092b0"}],
    "maxResults":1,"maxResultsShorts":0,"maxResultStreams":0,
    "transcriptionAndSubtitle":"NONE","aiVideoDescription":false,"aiVideoSummary":false}'
```

FlashData JSON phần thân cho POST /v1/queries/realtime:

```json
{
  "source": "youtube_metadata",
  "video_id": "FUfGcZ092b0",
  "params": {
    "include_formats": false,
    "include_chapters": true
  }
}
```

Điểm cuối đồng bộ hóa diễn viên đã có thể trả về các mục trong một phản hồi HTTP. Di chuyển yêu cầu, phong bì và các trường; không thêm bỏ phiếu không cần thiết.

### 2. Lưu tập lệnh, sau đó chạy nó

Chọn Python hoặc Bash. Mỗi thư mục đầu ra mới gửi một yêu cầu. Việc sử dụng lại thư mục sẽ đọc kết quả đã lưu; bị gián đoạn hoặc failed cố gắng dừng lại để kiểm tra. Cả hai phiên bản đều sử dụng cùng một tập tin.

#### Python

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 video-lookup.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("video_id")
parser.add_argument("folder", type=Path)
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")
body = {"source": "youtube_metadata", "video_id": args.video_id,
        "params": {"include_formats": False, "include_chapters": True}}
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 = 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 != 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") != body["source"]:
    raise SystemExit("Request did not complete successfully; inspect response.json")
items = data.get("results")
if not isinstance(items, list) or len(items) != 1 or not isinstance(items[0], dict):
    raise SystemExit("Expected one metadata result")
item = items[0]
if item.get("videoId") != args.video_id:
    raise SystemExit("Returned video does not match the request")
seconds = item.get("duration")
duration = None
if seconds is not None:
    if type(seconds) not in (int, float) or not math.isfinite(seconds) or seconds < 0:
        raise SystemExit("Invalid duration")
    whole = int(seconds)
    duration = f"{whole // 3600:02d}:{whole % 3600 // 60:02d}:{whole % 60:02d}"
mapped = [{
    "id": item["videoId"],
    "url": "https://www.youtube.com/watch?v=" + item["videoId"],
    "title": item.get("title"), "text": item.get("description"),
    "channelName": item.get("channel"), "channelId": item.get("channelId"),
    "viewCount": item.get("viewCount"), "likes": item.get("likeCount"),
    "commentsCount": item.get("commentCount"), "duration": duration,
    "uploadDateRaw": item.get("uploadDate"),
    "captionLanguages": item.get("transcriptLanguages"),
}]
(out / "dataset-items.json").write_text(
    json.dumps(mapped, ensure_ascii=False, indent=2) + "\n", encoding="utf-8"
)
print(f"Saved {out}/dataset-items.json; actual usage: {json.dumps(data.get('usage'))}")

```

Chạy từ thư mục đó, thay thế ID bằng video công khai từ tập dữ liệu của bạn:

```bash
python video-lookup.py FUfGcZ092b0 video-001
```

#### Bash

Yêu cầu 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 video-lookup.sh trong thư mục làm việc của bạn:

```bash
#!/usr/bin/env bash
set -euo pipefail
video_id="${1:?Use: VIDEO_ID OUTPUT_FOLDER}"
out="${2:?Set OUTPUT_FOLDER}"
[[ "$video_id" =~ ^[A-Za-z0-9_-]{11}$ ]] || { echo 'Invalid video ID' >&2; exit 1; }
body=$(jq -n --arg id "$video_id" '{source: "youtube_metadata", video_id: $id,
  params: {include_formats: false, include_chapters: true}}')
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 this 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 status, response and Retry-After header.\n' >&2; exit 1;
}
mapped=$(jq -e --arg id "$video_id" '
  def pad: tostring | if length < 2 then "0" + . else . end;
  def hms:
    if . == null then null
    elif type != "number" then error("Invalid duration")
    elif (isfinite | not) or . < 0 then error("Invalid duration")
    else floor | [(./3600 | floor | pad), ((.%3600)/60 | floor | pad), (.%60 | pad)] | join(":") end;
  if .source != "youtube_metadata" 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 != $id then error("Wrong video") else . end
  | [{id: .videoId, url: ("https://www.youtube.com/watch?v=" + .videoId),
      title, text: .description, channelName: .channel, channelId,
      viewCount, likes: .likeCount, commentsCount: .commentCount,
      duration: (.duration | hms), uploadDateRaw: .uploadDate,
      captionLanguages: .transcriptLanguages}]' "$out/response.json")
printf '%s\n' "$mapped" > "$out/dataset-items.json"
printf 'Saved %s/dataset-items.json; actual usage: ' "$out"
jq -c '.usage' "$out/response.json"

```

Chạy từ thư mục đó:

```bash
bash video-lookup.sh FUfGcZ092b0 video-001
```

### 3. Đọc đầu ra đã lưu

video-001/dataset-items.json là một mảng dành cho trình đọc ứng dụng của bạn. response.json giữ nguyên kết quả và cách sử dụng ban đầu. Đây là bộ chuyển đổi trường, không phải Bộ dữ liệu Apify API. Nó không tạo tập dữ liệu ID, điền các số liệu không xác định hoặc tạo ra các nhận xét hoặc trường kiếm tiền.

Minh họa dataset-items.json:

```json
[
  {
    "id": "FUfGcZ092b0",
    "url": "https://www.youtube.com/watch?v=FUfGcZ092b0",
    "title": "Example video",
    "text": "Example description",
    "channelName": "Example channel",
    "channelId": "UC_EXAMPLE",
    "viewCount": 1200,
    "likes": null,
    "commentsCount": null,
    "duration": "00:03:17",
    "uploadDateRaw": "2025-01-15",
    "captionLanguages": [
      "en",
      "es"
    ]
  }
]
```

| Trường diễn viên hiện có | FlashData siêu dữ liệu | Hành động di chuyển |
| --- | --- | --- |
| id/url | videoId | Giữ id và xây dựng đồng hồ YouTube chuẩn URL. |
| tiêu đề/văn bản | tiêu đề/mô tả | Ánh xạ mô tả thành văn bản nếu người đọc của bạn mong đợi tên trường của Diễn viên. |
| channelName / channelId | kênh / channelId | Giữ nguyên tên và ID. Không suy ra bộ điều khiển kênh từ tên hiển thị của nó. |
| lượt thích / commentsCount / viewCount | likeCount / commentCount / viewCount | Giữ các giá trị còn thiếu là null. Số liệu bị thiếu không phải là số 0. |
| thời lượng, thường là HH:MM:SS | thời lượng tính bằng giây | Ví dụ chuyển đổi giây thành chuỗi HH:MM:SS, giữ lại null. |
| ngày, có thể là tuyệt đối hoặc tương đối | uploadDate | Ví dụ giữ uploadDateRaw. Thêm trình phân tích ngày tháng của riêng bạn trước khi điền ngày chuẩn hóa. |
| phụ đề[] / transcriptionUrl | Một yêu cầu youtube_transcript hoặc youtube_captions riêng biệt | Các bản nhạc hiện có và tính năng chuyển giọng nói thành văn bản được tạo là các đầu vào khác nhau cho ứng dụng của bạn. |
| Các lĩnh vực làm giàu chỉ dành cho diễn viên | Không có tương đương tự động | Giữ một bước bổ sung riêng cho nhận xét, mở rộng kênh và phân tích do AI tạo. |

[Lược đồ siêu dữ liệu](https://flashdata.dev/vi/docs/sources/youtube_metadata/reference.md).

### Mang ý định phụ đề

| Đầu vào của diễn viên chính | FlashData di chuyển |
| --- | --- |
| ALWAYS_SUBTITLES | Thêm yêu cầu youtube_transcript hoặc youtube_captions riêng cho các bản nhạc hiện có. |
| subtitlesLanguage | Sử dụng params.language. Một mảng lên tới 10 ngôn ngữ trả về các bản nhạc cộng với lỗi trên mỗi ngôn ngữ. |
| preferAutoGeneratedSubtitles | Đây là một ưu tiên. FlashData params.auto lựa chọn nghiêm ngặt các chú thích do YouTube tạo hoặc do người tải lên cung cấp mà không có dự phòng từ nhiều nguồn gốc. |
| TRANSCRIPTION_AS_FALLBACK / ALWAYS_TRANSCRIBE | Tách biệt lời nói thành văn bản; FlashData không tạo ra bản nhạc bị thiếu. |
| phụ đề[].srt / transcriptionUrl | Ánh xạ các phân đoạn được đánh dấu thời gian hoặc định dạng tệp một cách rõ ràng. Văn bản thuần túy URL được tạo không phải là mảng phân đoạn được đánh dấu thời gian. |

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

<a id="production"></a>
## Bộ dữ liệu, công việc và lịch trình dài running

Nếu công cụ của bạn phụ thuộc vào Apify tập dữ liệu IDs và lịch trình, hãy giữ một Diễn viên tùy chỉnh làm người điều phối: gọi FlashData bên trong nó và ghi các mục được ánh xạ vào tập dữ liệu của nó. Lập ngân sách cho thời gian chạy và bộ nhớ của Actor cùng với mức sử dụng FlashData. Máy tính ở trên mô hình gọi trực tiếp FlashData.

| Mối quan tâm | Apify | FlashData |
| --- | --- | --- |
| Yêu cầu | Tùy chọn diễn viên ID + build/input; Nhiệm vụ đã lưu tùy chọn | nguồn + video_id + thông số; không có tùy chọn xây dựng diễn viên hoặc bộ nhớ |
| Kết quả đồng bộ | run-sync-get-dataset-items trả về một mảng mục; giới hạn được ghi trong tài liệu là HTTP là 300 giây | Phản hồi theo thời gian thực có trạng thái, kết quả[] và cách sử dụng; trích xuất kết quả trước khi ánh xạ các trường |
| Công việc dài-running | Bắt đầu chạy, lưu lần chạy ID, đợi trạng thái đầu cuối, đọc defaultDatasetId | Gửi công việc async hoặc batch, lưu ID của nó, thăm dò trạng thái của nó và truy xuất kết quả của nó |
| Lưu trữ đầu ra | Các mục tập dữ liệu cộng với các bản ghi khóa-giá trị tùy chọn được tham chiếu bởi URL | Lưu phản hồi hoặc xuất vào bộ lưu trữ lâu dài của riêng bạn; tập dữ liệu Apify ID không phải là công việc FlashData ID |
| Công việc định kỳ | Apify Lịch trình bắt đầu Diễn viên/Tasks; webhooks thông báo cho người tiêu dùng ở hạ nguồn | Sử dụng ứng dụng, cron, CI hoặc máy chủ lưu trữ tác nhân của bạn để gọi FlashData; di chuyển lịch trình và người tiêu dùng cùng nhau |

### Di chuyển tập dữ liệu hiện có

Export every page of the existing dataset before switching producers. Persist referenced subtitle files you still need. Không chạy lại một Actor chỉ để tải xuống kết quả đã được thu thập.

[Lưu và tái sử dụng kết quả](https://flashdata.dev/vi/docs/guides/save-results/reference.md)

### Làm mới thư viện video

Loại bỏ video trùng lặp IDs, kiểm tra từng kết quả và giữ nguyên đầu vào đến đầu ra IDs. Sử dụng xử lý hàng loạt hoặc hàng loạt cho danh sách lớn hơn; thử lại failed các mục sau khi kiểm tra lỗi của chúng.

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

### Giữ công việc theo lịch trình có thể dự đoán được

Chuyển tiếp múi giờ, nhịp độ, thông tin xác thực và đích đầu ra của bạn. Ghi lại một cửa sổ lịch trình completed trước khi nhà sản xuất cũ nghỉ hưu, để các lịch trình chồng chéo không tạo ra công việc trùng lặp.

[Chạy các tác vụ định kỳ](https://flashdata.dev/vi/docs/guides/recurring-tasks/reference.md)

### Danh sách kiểm tra cắt giảm

1. Ghi lại chính xác Diễn viên, bản dựng, Đầu vào nhiệm vụ, sự kiện phải thanh toán, trường đầu ra và người tiêu dùng xuôi dòng.
2. Thoát các lần chạy hiện có và xuất tất cả các trang dữ liệu. clean=true có thể bỏ qua các bản ghi, vì vậy chỉ một trang ngắn không phải là bằng chứng cho thấy quá trình xuất đã hoàn tất; kiểm tra siêu dữ liệu phân trang.
3. Xác minh bộ chuyển đổi dựa trên IDs đã lưu, bao gồm null số liệu, ngày tháng và nguồn gốc của chú thích.
4. Di chuyển nhịp, múi giờ và điểm đến vào người chạy của bạn. Giữ các điểm kiểm tra. maxTotalChargeUsd không phải là giới hạn chi tiêu FlashData API-key; thêm kiểm soát chi tiêu cấp ứng dụng.
5. Chuyển đổi nhà sản xuất cho cửa sổ lịch trình tiếp theo mà không chạy trùng lặp. Bảo quản xuất khẩu. Dừng công việc định kỳ đối với thông tin xác thực bị thu hồi hoặc số dư không đủ.

<a id="agents"></a>
## Mã hóa và tác nhân cá nhân

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 và chú thích chia sẻ phụ cấp.

1. Trước tiên, hãy xác định tích hợp Diễn viên và sử dụng lại thông tin xác thực FlashData hiện có.
2. Chứng minh một lần tra cứu video và lưu cả đầu ra thô và đầu ra được ánh xạ với 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ỳ. Dừng việc thu hồi; không tạo ra các thử nghiệm mới.

```text
Replace this project's Apify YouTube metadata lookup with FlashData.
Read https://flashdata.dev/auth.md and https://flashdata.dev/docs/sources/youtube_metadata/reference.md.
Identify the exact Actor ID, build, input, output fields, schedule and storage consumer first.
Reuse a saved FlashData credential or start one eligible trial with youtube_metadata permission.
Run one known video ID. Save the raw response, actual usage and a mapped JSON item array.
Keep null metrics and preserve the raw publication date. Do not invent Actor-only fields.
Keep channel discovery, comments, AI transcription and hosted scheduling separate unless explicitly migrated.
Reuse saved results after restart. Ask the owner to claim before recurring use and store keys outside chat.
Stop after revocation or insufficient balance; never create more trials to continue.
```

[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à sự thay thế cho nền tảng Apify không?

Nó thay thế các cuộc gọi dữ liệu YouTube cụ thể trong quy trình làm việc của bạn. Apify cũng cung cấp thị trường Diễn viên, thời gian chạy tùy chỉnh, lịch trình lưu trữ và bộ lưu trữ. Giữ những phần đó ở nơi bạn sử dụng hoặc chuyển trách nhiệm của chúng vào ứng dụng của riêng bạn.

### Tại sao không so sánh mọi diễn viên ở một mức giá?

Các nhà phát triển diễn viên chọn các mô hình định giá, các hạn chế đầu ra và đầu vào khác nhau. Máy tính sử dụng bộ truyền phát/youtube-scraper. Bảng diễn viên cũng bao gồm một diễn viên khám phá rẻ hơn; các hạn chế về một video của nó rất quan trọng khi thay thế việc tra cứu theo yêu cầu.

### Đăng ký Apify có tính phí hai lần cho mức sử dụng đi kèm không?

Không. Phí gói bao gồm ngân sách sử dụng trả trước. Máy tính sẽ trừ ngân sách đó trước khi bổ sung thêm mức sử dụng Actor. Nó giả định toàn bộ ngân sách có sẵn cho quy trình làm việc này. Nếu các Diễn viên khác tiêu thụ nó, số tiền còn lại sẽ ít hơn với giá YouTube.

### Tôi có thể giữ người tiêu dùng tập dữ liệu Apify không?

Ví dụ viết một mảng JSON với các tên trường quen thuộc được chọn. Nó không tạo tập dữ liệu Apify hoặc chạy ID. Đọc trực tiếp tệp mới, xuất bản tệp qua bộ lưu trữ của riêng bạn hoặc giữ một Diễn viên tùy chỉnh ghi các mục được ánh xạ này vào tập dữ liệu của nó cho người tiêu dùng hiện tại của bạn.

### Điều gì xảy ra với phụ đề và phiên âm AI?

Diễn viên chính của Apify cung cấp phụ đề hiện có và phiên âm AI tùy chọn. FlashData truy xuất các bản nhạc YouTube hiện có. Yêu cầu siêu dữ liệu và chú thích riêng biệt, kiểm tra ngôn ngữ và nguồn gốc được trả về, đồng thời giữ riêng mọi bước tóm tắt giọng nói thành văn bản hoặc AI.

### Lịch trình hiện tại của tôi hoặc giới hạn chi tiêu đang chạy có được chuyển không?

Không. Tạo lại lịch trình trong chương trình chạy bạn đã chọn và thêm kiểm tra ngân sách cấp ứng dụng. Cài đặt Apify maxTotalChargeUsd không phải là giới hạn chi tiêu chính FlashData API. Chìa khóa chủ sở hữu sử dụng số dư tài khoản dùng chung.
