Skip to content
EN
Get API key
Browse documentation

Get started

FlashData vs the official YouTube Data API

Choose by the task, compare one metadata response and check caption authorization and usage costs.

On this page

Choose by the task

FlashData is a separate service from Google's YouTube Data API. The credentials, response fields and billing models are different.

At a glance

TaskOfficial YouTube Data APIFlashData
Video metadatavideos.listyoutube_metadata
Search and discoveryYouTube resource queries and pagination.Standard / Extended Search, channels and suggestions.
Caption tracksAuthorized caption operations; downloads require edit permission for the video.Retrieve existing tracks for the requested language and caption source.
Account changesDocumented uploads and other authorized writes.Retrieval and delivery; no YouTube account mutations.
Media filesA video-resource response is metadata.Background downloads to your storage.

Compare one metadata request

Use Bash, cURL and jq. For Google, enable YouTube Data API v3 in your project and set GOOGLE_API_KEY. For FlashData, set FLASHDATA_API_KEY with youtube_metadata permission. Each tab makes one request and saves its response; run the provider you want to evaluate.

Bash · flashdata-metadata.json
(
set -euC
: "${FLASHDATA_API_KEY:?Set FLASHDATA_API_KEY first}"
curl --fail-with-body --silent --show-error --max-time 120 \
  'https://data.flashdata.dev/v1/queries/realtime' \
  --header "X-API-Key: $FLASHDATA_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "source": "youtube_metadata",
  "video_id": "jNQXAC9IVRw",
  "params": {
    "include_formats": false,
    "include_chapters": false
  }
}' > flashdata-metadata.json
jq -e '.status == "done"' flashdata-metadata.json >/dev/null
jq '.results | map({video_id: .videoId, title, channel, duration_seconds: .duration})' \
  flashdata-metadata.json
)

Map the result fields

A successful response contains the requested video. An empty items/results array means no matching record was returned. Keep the original response and map fields explicitly in your application.

ValueOfficial responseFlashData response
Video IDitems[0].idresults[0].videoId
Titleitems[0].snippet.titleresults[0].title
Channel nameitems[0].snippet.channelTitleresults[0].channel
DurationcontentDetails.duration · ISO 8601duration · seconds

Check caption access separately

Google's captions.download requires OAuth authorization and permission to edit the video. FlashData retrieves existing tracks: Transcript defaults to automatic captions; Captions defaults to uploader-provided tracks. Specify language and auto explicitly when comparing outputs.

FlashData does not generate a transcription or translation. Its license-label source reports Creative Commons metadata; it does not grant training rights or read a creator's separate training-permission setting.

Move from one video to a collection

Choose the FlashData workflow that matches your input. Standard Search accepts up to 20 requested results; Extended Search accepts up to 700 at a separate rate.

InputWorkflow
A topic or search queryStandard or Extended Search → save video IDs → metadata.
A small list of requestsRegular batch submission with per-job results.
A file of video IDsBulk metadata, transcript, captions, license labels or downloads.

Compare quota and Credits

Google applies project quota and method-specific costs. FlashData uses shared account Credits and source-specific rates; download usage is based on delivered media bytes. Check the methods, plan fee and workload you will actually use.