# ScrapeCreators YouTube データの代替

YouTube メタデータとキャプションのコスト、プリペイド パック、キャッシュ ヒットを比較します。アプリとエージェント用の実行可能な Python および Bash フィールド アダプターを備えた FlashData に移行します。

新鮮なビデオデータ。初期費用が少なくなります。残りのソーシャル データ統合を維持しながら、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 クレジット コール |
| 記載されている最低単価 / 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 |
| --- | --- | --- |
| 同じ応答からのテキストとタイムスタンプ | 全文 + 時間指定セグメント — Start/end 秒単位で | 全文 + 時間指定セグメント — startMs/endMsをミリ秒文字列として |
| 1 つのリクエストで複数のキャプション言語を使用 | 最大 10 言語 — 既存のトラックと言語ごとのエラー | 選択した 1 つの言語 — 通話トランスクリプトごとに言語または original_audio の選択 |
| キャプションの発信元を明示的に選択する | アップローダーまたは YouTube で生成された — params.auto は 1 つの原点を選択します | 言語と音声の選択 — original_audio はキャプション元のスイッチではありません |
| 欠落キャプションの処理 | 既存のトラックと明示的なエラー — 言語配列は成功したトラックを保存し、欠落した選択を報告します | 空のトランスクリプトフィールド — リクエストされたトラックが見つからない場合、クレジットはゼロになります。いいえ YouTube AI 文字起こし |
| 再利用されるデータの古さを選択します | アプリケーションのキャッシュ ポリシー — 取得時間を保存し、いつ再度取得するかを決定します | cache_max_age — 1–30 日オプション。キャッシュ ヒットのクレジットはゼロになり、cached_at が公開されます |

### 反復可能なデータ ワークフローを実行する

| 特徴 | FlashData | ScrapeCreators |
| --- | --- | --- |
| 保存されたビデオファイルIDsを処理します | 管理された一括ジョブ — ファイルを送信し、そのジョブを追跡し、出力を取得します | ビデオごとのエンドポイント コール — 統合内のファイルループと結果ストレージを管理する |
| 長いコレクションをバックグラウンド ジョブに移動する | 非同期、バッチ、バルク API — ジョブ IDs を永続化し、ステータスを追跡し、結果を取得します | 同期 YouTube 呼び出し — ワーカー内のビデオ通話ごとのキューとチェックポイント |
| 構造化された読みやすい出力 | JSON、プレーンテキストまたはMarkdown — API 応答ヘッダーによって選択 | JSON API および CLI 形式 — CLI は、CSV、テーブル、および Markdown もエクスポートします |
| 端末の設置 | スタンドアロンの実行可能ファイル — Linux、macOS、Windows;ノード/Python ランタイムがありません | npm CLI — @scrapecreators/cli |
| MCP とエージェントのスキル | はい | はい |
| データ配信からホスト型メディア配信への継続 | はい — YouTube ストレージにダウンロードします。個別の権限と GB ベースの価格設定 | 個別のダウンローダーのワークフロー — YouTube メタデータおよびトランスクリプト API はメディア ファイルを配信しません |

どちらもプリペイド アクセス、MCP、CLI、およびエージェント スキルを提供します。 ScrapeCreators では、他のソーシャル プラットフォームや YouTube のコメントもカバーしています。サポートされているキャッシュ ヒットは無料です。

### 気になる動画を更新してください

変化するメトリクスを更新したり、新しいビデオのキャプションを収集したりする場合、リクエストごとの使用率が低いことが重要になります。保存されたトランスクリプトを保持し、更新が必要な場合にのみメタデータをリクエストします。

### まずは少額の購入から始めましょう

FlashData クレジットのチャージは $10 から始まります。まず 1 つの YouTube ワークロードを移動します。その間、既存の統合は引き続きコメントやその他のソーシャル プラットフォームを処理します。

### 正確なキャプション トラックを選択する

アップローダーが提供するキャプションまたはYouTube が生成したキャプションを明示的に選択します。 1 つのトランスクリプト リクエストで最大 10 の既存の言語をリクエストし、各言語の結果を個別に処理します。

<a id="costs"></a>
## 新しいリクエスト、キャッシュヒット、前払い購入を比較します

| ScrapeCreatorsオファー | 1回限りの購入 | クレジット | 新たな 1 クレジット コール 1,000 ごとに | 月額料金 |
| --- | --- | --- | --- | --- |
| 初回無料特典 | $0 | 100 1回 | 無料の入社手当 | $0 |
| Freelance | $47.00 | 25,000 | $1.88 | $0 |
| Business | $497.00 | 500,000 | $0.994 | $0 |
| エンタープライズ | カスタム | 1,000,000+ | カスタム | $0 プリペイド クレジット |

これらは月々の更新のないプリペイドパックです。 Business は、1,000 1 クレジット コールあたり正確に $0.994 です。 $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/ja/pricing/youtube-data)。

### 例: 1,000 動画のメタデータとキャプション

2,000 リクエスト、ディスカバリー検索なし。 FlashData 従量課金制 vs 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、1 か月分のリクエスト。 1 つの新しいメタデータ ルックアップ、ネイティブ キャプションの結果、または標準の検索リクエストで 1 つの ScrapeCreators クレジットが使用されます。メタデータとキャプションでは、両側で 2 つのリクエストが使用されます。上記で入力したメタデータ/transcript キャッシュ ヒットのみが差し引かれます。検索キャッシュは想定されていません。このモデルは、失われたトラックの試行ではなく、返されたキャプションをカウントし、AI 生成を除外します。 FlashData は現在の標準である YouTube データ料金を使用し、追加使用の前に選択したプランの許容量全体を割り当てます。拡張検索とダウンロードは別途料金がかかります。開始残高、トライアル、ボーナスクレジット、税金、その他の使用は除外されます。購入は残高ゼロから始まります: FlashData チャージの最小額は $10 です。 ScrapeCreators の購入は、選択したパック全体に切り上げられます。未使用の購入クレジットは、後のタスクに使用できます。 ScrapeCreators には月額パックの更新はありません。選択した FlashData 月額プランでは、リクエストがゼロの場合でも料金が発生します。

### キャッシュ動作

サポートされているメタデータ/transcript エンドポイントでは、cache_max_age は 1d、3d、7d、14d、または 30d を受け入れます。ヒットはゼロクレジットを使用し、cached_at をレポートします。ミスの場合は通常のレートが使用されます。検索キャッシュのヒットは想定されていません。保存されたデータがタスクに十分な最新のものであるかどうかを判断します。 [結果を保存して再利用する](https://flashdata.dev/ja/docs/guides/save-results/reference.md)。

### 開始オファー

ScrapeCreatorsは、100の無料クレジットから始まります。 4,000標準YouTubeデータ要求までの初期の許容値を受け取ることができる適格な検証済みFlashDataサインアップ。 これらは毎月リセットされません。 別々の一時的なエージェント試用は以下のとおりです。

<a id="migration"></a>
## 1 つのビデオとそのキャプションのタイムスタンプを移行する

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

```

既存の英語トラックを含むビデオを使用して、そのフォルダーから実行します。メタデータは別個のオプションのリクエストです。一時的なトライアルでは、通話の間に少なくとも 1 秒の間隔をあけてください。

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

アップローダーが提供するキャプションについては、マニュアルを追加してください。新しい出力フォルダーごとに 1 つのリクエストが送信されます。同じ引数とフォルダーは保存された出力を再利用します。前回の試行を検査した後、意図的な更新に新しいフォルダーを使用します。

### 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 は、3 つの ID をすべて再現するわけではありません。読者が必要とするフィールドのみをマップします。音楽クレジットの帰属については別のパスを保持します。 |
| cached, cached_at, credits_charged | FlashData の生の応答と使用法を保持します。自分のフェッチ時間を記録します。プロバイダー キャッシュ フラグを作成したり、プロバイダー間のクレジット残高を変換したりしないでください。 |

[転写スキーマ](https://flashdata.dev/ja/docs/sources/youtube_transcript/reference.md) · [メタデータスキーマ](https://flashdata.dev/ja/docs/sources/youtube_metadata/reference.md)

### 最初のリクエストが失敗した場合

- 401/403:保存されたキーとソースの権限をチェックし、再発した場合は停止します。
- 402: 再開する前にオーナー残高を補充してください。
- 429: 保存された Retry-After ヘッダーを読み取ります。リクエストの頻度を減らします。一時的なトライアルでは、1 秒あたり 1 つのリクエストが許可されます。
- トラックがありません: 利用可能な言語と生成元を確認してください。 ScrapeCreators は、成功した応答を null トランスクリプトとともに返すことができます。これを completed FlashData トラックと混同しないでください。
- タイムアウトまたは不完全なフォルダー: 再試行する前に履歴と出力を調べてください。スクリプトは、自動再送信せずに試行を保存します。

[エラーとステータスコード](https://flashdata.dev/ja/docs/errors/reference.md)

<a id="workflow"></a>
## 検索 → 候補リスト → 充実 → 引用

| ステップ | 仕事 | リクエスト数 |
| --- | --- | --- |
| 発見する | P YouTube 検索リクエストを実行します | P 標準検索リクエスト。返されたすべてのビデオを個別の検索としてカウントするのではなく、実際のリクエストをカウントします。 |
| 選択 | N ビデオ IDs を重複排除して候補リストに登録 | ローカルフィルタリング。メタデータまたはキャプションのリクエストはまだありません。 |
| 豊かにする | 最終候補者リストに残った IDs のメタデータを取得します | N 個のメタデータ リクエスト。メトリクスを更新する必要がある場合にのみ繰り返します。 |
| 引用 | ID ごとに既存のキャプション トラックを 1 つ取得します | 利用可能な場合、N 個のトランスクリプト リクエスト。言語、原点、キューのタイミングをソース URL に保存します。 |
| 再利用 | 保存された結果を次のタスクのために読み取る | アプリが独自に保存したファイルを再利用できる場合、プロバイダー要求はありません。 |

10 の検索リクエストに加え、メタデータとキャプションを含む50 の最終候補リストに残った動画には、ローカルで再利用する前に 110 の標準リクエストが必要です。ディスカバリーコストをエンリッチメントから分離します。検索結果自体は別の検索リクエストではありません。

### 検索はドロップイン カーソルの移行ではありません

ScrapeCreators は、continuationToken とともに複数の結果タイプを返すことができます。 FlashData の標準検索ではビデオ結果が返されます。拡張検索には別の制限と価格設定があります。古いカーソルを再利用する代わりに、新しい検出の実行を開始します。

[YouTube 検索リファレンス](https://flashdata.dev/ja/docs/sources/youtube_search/reference.md)

### 答えとともに証拠を保管する

ビデオ ID、URL、選択した言語、キャプションの起点、セグメントの開始時間を保存します。引用リンクはそのタイムスタンプを指すことができます。欠落しているキャプション トラックを空の成功したトランスクリプトとしてラベル付けしないでください。

[タイムスタンプ付きキャプションのレシピ](https://flashdata.dev/ja/docs/guides/timestamped-captions-recipe/reference.md)

### Scale ID を個別にリストします

1 回の検索が機能したら、リストの batch リクエストを使用するか、ファイルの一括処理を行います。ジョブ IDs を追跡し、completed 出力を保存し、failed 項目のみを再試行します。ランナーはスケジュールに責任を持ってください。

[一括処理リファレンス](https://flashdata.dev/ja/docs/reference/bulk-processing/reference.md)

<a id="agents"></a>
## 移行をスケジュールする前に移行を証明する

1 credit(100規格YouTubeデータリクエストまで)を72時間で開始できます。 メタデータ、キャプションおよび検索共有の許容値。

1. 必須フィールド、キャプションの意図、新鮮さを検査します。保存されたアクセスを再利用します。無関係なソーシャルデータ通話を維持します。
2. CLI、SDK、または MCP を使用して既知のビデオを 1 つ実行します。出力を保存し、タイミング、ヌル、実際の使用状況を確認します。
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/ja/docs/guides/agent-onboarding/reference.md) · [スタンドアロン CLI](https://flashdata.dev/ja/docs/guides/flashdata-cli/reference.md) · [MCP セットアップ](https://flashdata.dev/ja/docs/integrations/mcp-clients/reference.md)

<a id="faq"></a>
## 切り替える前に

### これらは月額制のサブスクリプションですか?

ScrapeCreators Freelance および Business は、サブスクリプションではなく、プリペイド パックです。どちらも $0 月額料金がかかります。 FlashData には、従量課金制クレジットとオプションの月額プランがあります。消費された使用量と、現在の残高から必要な購入を個別に比較します。

### 私の ScrapeCreators リクエストのほとんどがキャッシュされている場合はどうなりますか?

サポートされているメタデータとトランスクリプトのキャッシュ ヒットには、クレジットのコストはゼロです。観察されたヒットを計算機に入力します。アプリがその年齢を受け入れる場合、新しい FlashData リクエストよりも費用が安くなる可能性があります。いずれかのプロバイダーの出力をローカルに保存して、次のリクエストをまったく行わないようにすることもできます。

### 未使用のクレジットは期限切れになりますか?

ScrapeCreators は、現在のポリシーでは購入したクレジットに有効期限がないと述べています。無料の 100 クレジットの開始オファーは、毎月の補充ではありません。 FlashData の臨時AI エージェントのトライアルが終了します。その価格設定とアカウントのページには、該当する所有者残高条件が記載されています。

### original_audio=true は params.auto=true として機能しますか?

いいえ。最初の言語は、話された音声に基づいて言語を選択します。 2 番目は、YouTube で生成されたキャプションを選択します。言語と出身地を意図的に設定します。どちらのサービスのネイティブ キャプション エンドポイントも、一致するトラックが存在しない場合は音声テキスト変換を作成しません。

### すべてのソーシャルデータ通話を置き換えることはできますか?

この移行では、YouTube ビデオのメタデータと既存のキャプションが対象になります。コメント、コミュニティ投稿、ソーシャル プロフィール、およびその他のサポートされていない応答フィールドは、既存のパスに保持します。 FlashData は、独自の権限と価格で、Google 検索とホストされた YouTube ダウンロードも提供します。

### ScrapeCreators は AI エージェントもサポートしていますか?

はい。 MCP、OAuth、CLI およびエージェント スキルを提供します。 FlashData のエージェント フローは、適格な一時トライアルを追加し、所有者が継続的に使用できるように認証情報を要求し、保存します。タスクに必要な API とワークフローを選択します。 MCP サポートだけが違いではありません。
