Browse documentation
Get started
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
| Task | Official YouTube Data API | FlashData |
|---|---|---|
| Video metadata | videos.list | youtube_metadata |
| Search and discovery | YouTube resource queries and pagination. | Standard / Extended Search, channels and suggestions. |
| Caption tracks | Authorized caption operations; downloads require edit permission for the video. | Retrieve existing tracks for the requested language and caption source. |
| Account changes | Documented uploads and other authorized writes. | Retrieval and delivery; no YouTube account mutations. |
| Media files | A 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.
(
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
)(
set -euC
: "${GOOGLE_API_KEY:?Set GOOGLE_API_KEY first}"
curl --fail-with-body --silent --show-error --max-time 30 --get \
'https://www.googleapis.com/youtube/v3/videos' \
--data-urlencode "key=$GOOGLE_API_KEY" \
--data-urlencode 'part=snippet,contentDetails' \
--data-urlencode 'id=jNQXAC9IVRw' > official-metadata.json
jq '.items | map({video_id: .id, title: .snippet.title,
channel: .snippet.channelTitle, duration_iso8601: .contentDetails.duration})' \
official-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.
| Value | Official response | FlashData response |
|---|---|---|
| Video ID | items[0].id | results[0].videoId |
| Title | items[0].snippet.title | results[0].title |
| Channel name | items[0].snippet.channelTitle | results[0].channel |
| Duration | contentDetails.duration · ISO 8601 | duration · 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.
| Input | Workflow |
|---|---|
| A topic or search query | Standard or Extended Search → save video IDs → metadata. |
| A small list of requests | Regular batch submission with per-job results. |
| A file of video IDs | Bulk 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.