# ScrapeCreators YouTube 데이터의 대안

YouTube 메타데이터 및 캡션 비용, 선불 팩 및 캐시 조회수를 비교하세요. 앱 및 에이전트용 실행 가능한 Python 및 Bash 필드 어댑터를 사용하여 FlashData로 마이그레이션하세요.

신선한 비디오 데이터. 시작 비용이 더 적습니다. 나머지 소셜 데이터 통합을 유지하면서 YouTube 메타데이터 및 캡션 호출을 이동하세요.

ScrapeCreators 실제로 검토 2026-11-10. FlashData 가격 및 체험 수당은 현재 공개 카탈로그에서 제공됩니다.

- [특징](#features)
- [가격 및 캐시](#costs)
- [요청 마이그레이션](#migration)
- [연구 작업흐름](#workflow)
- [AI 에이전트의 경우](#agents)
- [FAQ](#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는 밀리 초 문자열로 |
| 한 번의 요청으로 여러 캡션 언어 | 최대 10 언어 — 기존 트랙과 언어별 오류 | 선택한 언어 1개 — 언어 또는 성적 통화당 original_audio 선택 |
| 캡션 출처를 명시적으로 선택하세요. | 업로더 또는 YouTube 생성 — params.auto 하나의 출발지를 선택합니다. | 언어 및 음성 오디오 선택 — original_audio은 캡션 출처 스위치가 아닙니다. |
| 누락된 캡션 처리 | 기존 트랙 및 명시적 오류 — 언어 배열은 성공적인 트랙을 보존하고 누락된 선택 항목을 보고합니다. | Null 성적 기록 필드 — 요청한 트랙이 누락되면 크레딧 비용이 0이 됩니다. 아니요 YouTube AI 전사 |
| 재사용된 데이터의 유효 기간을 선택하세요. | 애플리케이션의 캐시 정책 — 검색 시간을 절약하고 언제 다시 가져올지 결정하세요. | cache_max_age — 1–30일 옵션; 캐시 적중 시 크레딧 비용이 0이 되고 노출됩니다 cached_at |

### 반복 가능한 데이터 워크플로우 실행

| 특징 | FlashData | ScrapeCreators |
| --- | --- | --- |
| 저장된 동영상 파일 처리 IDs | 관리형 대량 작업 — 파일 제출, 작업 추적 및 출력 검색 | 비디오별 엔드포인트 호출 — 통합에서 파일 루프 및 결과 저장을 관리하세요. |
| 긴 컬렉션을 백그라운드 작업으로 이동 | 비동기, 배치 및 대량 API — 작업 IDs 유지, 상태 추적 및 결과 검색 | 동기식 YouTube 호출 — 작업자의 화상 통화별 대기열 및 체크포인트 |
| 구조화되고 읽기 쉬운 출력 | JSON, 일반 텍스트 또는 Markdown — API 응답 헤더를 통해 선택 | JSON API 및 CLI 형식 — CLI는 CSV, 테이블 및 Markdown도 내보냅니다. |
| 터미널 설치 | 독립 실행형 실행 파일 — Linux, macOS 및 Windows; Node/Python 런타임 없음 | npm CLI — @scrapecreators/cli |
| MCP 및 상담원 기술 | 예 | 예 |
| 데이터에서 호스팅된 미디어 전달까지 계속 | 예 — YouTube 저장공간에 다운로드하세요. 별도의 권한 및 GB 기반 가격 | 별도의 다운로더 작업 흐름 — YouTube 메타데이터 및 스크립트 API는 미디어 파일을 제공하지 않습니다. |

둘 다 선불 액세스, MCP, CLI 및 상담원 기술을 제공합니다. ScrapeCreators에는 다른 소셜 플랫폼과 YouTube 댓글도 포함됩니다. 지원되는 캐시 적중은 무료입니다.

### 관심 있는 동영상을 새로 고치세요.

변화하는 지표를 새로 고치거나 새 비디오에 대한 캡션을 수집할 때 요청당 사용률을 낮추는 것이 중요합니다. 저장된 스크립트를 보관하고 업데이트가 필요할 때만 메타데이터를 요청하세요.

### 소액 구매부터 시작하세요

FlashData 크레딧 충전은 $10부터 시작됩니다. 기존 통합에서 댓글과 기타 소셜 플랫폼을 계속 처리하는 동안 하나의 YouTube 워크로드를 먼저 이동하세요.

### 정확한 캡션 트랙을 선택하세요.

업로더 제공 또는 YouTube 생성 캡션을 명시적으로 선택하세요. 한 번의 자막 텍스트 요청으로 최대 10 기존 언어를 요청하고 각 언어의 결과를 별도로 처리합니다.

<a id="costs"></a>
## 새로운 요청, 캐시 적중 및 선불 구매 비교

| ScrapeCreators 제안 | 일회성 구매 | 크레딧 | 1,000 신규 1크레딧 통화당 | 월 요금 |
| --- | --- | --- | --- | --- |
| 초기 무료 제공 | $0 | 100 한 번 | 무료 시작 수당 | $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/ko/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, 한 달 간의 요청입니다. 새로운 메타데이터 조회, 기본 캡션 결과 또는 표준 검색 요청 1회에는 ScrapeCreators 크레딧 1개가 사용됩니다. 메타데이터와 캡션은 양쪽에서 두 개의 요청을 사용합니다. 위에서 입력한 메타데이터/transcript 캐시 적중만 차감됩니다. 검색 캐싱은 가정되지 않습니다. 이 모델은 누락된 트랙 시도가 아닌 반환된 캡션을 계산하고 AI 생성을 제외합니다. FlashData 현재 표준을 사용합니다. YouTube 데이터 가격은 추가 사용 전에 선택한 요금제 전체 할당량을 할당합니다. 확장 검색 및 다운로드 가격은 별도로 책정됩니다. 시작 잔액, 평가판, 보너스 크레딧, 세금 및 기타 사용량은 제외됩니다. 구매는 잔액이 없는 상태에서 시작됩니다. FlashData 충전 최소 금액은 $10입니다. ScrapeCreators 구매는 선택한 팩 전체로 합산됩니다. 사용하지 않은 구매 크레딧은 이후 작업에 사용될 수 있습니다. ScrapeCreators 월별 팩 갱신이 없습니다. 선택한 FlashData 월간 요금제에는 여전히 요청이 없으며 수수료가 없습니다.

### 캐시 동작

지원되는 메타데이터/transcript 엔드포인트에서 cache_max_age는 1d, 3d, 7d, 14d 또는 30d를 허용합니다. 조회수는 0 크레딧을 사용하고 보고합니다 cached_at; 놓치면 정상 속도를 사용합니다. 검색 캐시 적중은 가정되지 않습니다. 저장된 데이터가 작업에 적합한 최신 데이터인지 결정합니다. [결과 저장 및 재사용](https://flashdata.dev/ko/docs/guides/save-results/reference.md).

### 제안 시작

ScrapeCreators는 100 무료 크레딧으로 시작합니다. FlashData signups는 4,000 표준 YouTube 자료 요구에 최대의 초기 허용을 받을 수 있습니다. 이 제안은 매월 재설정되지 않습니다. 별도의 임시 대리인 예심은 아래에 나타납니다.

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

업로더가 제공한 캡션의 경우 설명서를 추가하세요. 각각의 새 출력 폴더는 하나의 요청을 제출합니다. 동일한 인수와 폴더는 저장된 출력을 재사용합니다. 이전 시도를 검사한 후 의도적인 새로 고침을 위해 새 폴더를 사용합니다.

### 3. 매핑된 출력 및 실제 사용량 읽기

captions-001/normalized.json는 분야 접합기입니다; response.json에는 익지않는 응답 및 실제적인 사용법을 유지합니다. 두 번째는 문자열 밀리 초가된다. languageCode 및 isAutoGenerated 선택된 트랙을 보존합니다. 이것은 완전한 하락에서 응답이 아닙니다: 제조한 신용 균형, 캐시 깃발, 올려주기자 attribution 또는 날짜 분야 없음. Metadata는 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/ko/docs/sources/youtube_transcript/reference.md) · [메타데이터 스키마](https://flashdata.dev/ko/docs/sources/youtube_metadata/reference.md)

### 첫 번째 요청이 실패하는 경우

- 401/403 : 저장된 키와 소스 권한을 확인; revoked 경우 중지.
- 402: 재개하기 전에 소유자 잔액을 보충하세요.
- 429: 저장된 Retry-After 헤더를 읽습니다. 요청 빈도를 줄입니다. 임시 평가판에서는 초당 하나의 요청을 허용합니다.
- 누락된 트랙: 사용 가능한 언어와 출처를 확인하세요. ScrapeCreators는 null 자막 텍스트와 함께 성공적인 응답을 반환할 수 있습니다. completed FlashData 트랙과 혼동하지 마세요.
- 시간 초과 또는 불완전한 폴더: 다시 시도하기 전에 기록 및 출력을 검사하세요. 스크립트는 자동 재제출 없이 시도를 보존합니다.

[오류 및 상태 코드](https://flashdata.dev/ko/docs/errors/reference.md)

<a id="workflow"></a>
## 찾기 → 후보자 목록 → 보강 → 인용

| 단계 | 일 | 요청 횟수 |
| --- | --- | --- |
| 발견하다 | P YouTube 검색 요청 실행 | P 표준 검색 요청. 반환된 모든 동영상을 별도의 검색으로 계산하는 것이 아니라 실제 요청을 계산합니다. |
| 선택 | N 동영상 중복 제거 및 최종 후보 목록 IDs | 로컬 필터링; 아직 메타데이터나 캡션 요청이 없습니다. |
| 풍요롭게 하다 | 최종 후보에 오른 IDs에 대한 메타데이터를 가져옵니다. | N개의 메타데이터 요청; 측정항목을 새로 고쳐야 할 때만 반복하세요. |
| 인용 | ID당 하나의 기존 캡션 트랙을 가져옵니다. | 가능한 경우 N개의 자막 텍스트 요청. 소스 URL로 언어, 원산지 및 큐 타이밍을 저장합니다. |
| 재사용 | 다음 작업을 위해 저장된 결과 읽기 | 앱이 자체 저장된 파일을 재사용할 수 있는 경우 공급자가 요청하지 않습니다. |

10 검색 요청과 50 메타데이터 및 캡션이 포함된 최종 후보 동영상은 로컬 재사용 전에 110 표준 요청이 필요합니다. 농축과 발견 비용을 분리하세요. 검색 결과 자체는 별도의 검색 요청이 아닙니다.

### 검색은 드롭인 커서 마이그레이션이 아닙니다.

ScrapeCreators는 continuationToken를 사용하여 여러 결과 유형을 반환할 수 있습니다. FlashData의 표준 검색은 동영상 결과를 반환합니다. 확장 검색에는 별도의 한도와 가격이 있습니다. 이전 커서를 재사용하는 대신 새로운 검색 실행을 시작하십시오.

[YouTube 검색 참고자료](https://flashdata.dev/ko/docs/sources/youtube_search/reference.md)

### 답변과 함께 증거를 확보하세요

비디오 ID, URL, 선택한 언어, 캡션 출처 및 세그먼트 시작 시간을 저장합니다. 인용 링크는 해당 타임스탬프를 가리킬 수 있습니다. 누락된 캡션 트랙을 비어 있는 성공적인 스크립트로 라벨을 지정하지 마세요.

[타임스탬프 캡션 레시피](https://flashdata.dev/ko/docs/guides/timestamped-captions-recipe/reference.md)

### Scale ID 목록을 별도로

한 번의 조회가 완료되면 목록에 대한 batch 요청을 사용하거나 파일에 대한 대량 처리를 사용하세요. 작업 IDs을 추적하고 completed 출력을 저장한 후 failed 항목만 다시 시도하세요. 러너가 일정을 책임지게 하세요.

[대량 처리 참조](https://flashdata.dev/ko/docs/reference/bulk-processing/reference.md)

<a id="agents"></a>
## 마이그레이션을 예약하기 전에 마이그레이션을 증명하세요.

비할 수 있는 대리인은 1 credit (100 표준 YouTube 자료 요구까지)를 72 시간 동안 시작될 수 있습니다. Metadata, captions 및 검색은 수당을 공유합니다.

1. 필수 필드, 캡션 의도 및 최신성을 검사합니다. 저장된 액세스를 재사용합니다. 관련 없는 소셜 데이터 통화를 유지하세요.
2. CLI, SDK 또는 MCP를 사용하여 알려진 비디오 하나를 실행합니다. 출력을 저장하고 타이밍, Null 및 실제 사용량을 확인합니다.
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/ko/docs/guides/agent-onboarding/reference.md) · [독립형 CLI](https://flashdata.dev/ko/docs/guides/flashdata-cli/reference.md) · [MCP 설정](https://flashdata.dev/ko/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 지원만으로는 차이가 없습니다.
