Browse documentation
API reference
Request parameters, response schemas and working examples for every source.
On this page
Request basics
Set source to the product you need and authenticate with X-API-Key. Source pages below contain exact fields, response examples and an interactive request builder.
Data API https://data.flashdata.dev
Management API https://api.flashdata.dev
Header X-API-Key: YOUR_API_KEY| Workflow | Request | Returns |
|---|---|---|
| Realtime · Data API | POST /v1/queries/realtime | Source results in the response |
| Async · Data API | POST /v1/queries | A job ID for status and results |
| Batch · Data API | POST /v1/queries/batch | A separate receipt per query |
| Bulk · Management API | POST /v2/bulk-jobs | A Bulk ID and signed input-file upload URL |
| Job · Management API | GET /v2/jobs/{id} | Status of an existing job |
API basics
- Realtime and async
Get results in the response, or submit a job and retrieve them later. Choose how your application or agent waits for work.
- Batch and bulk
Choose Batch for independent queries with different inputs. Choose Bulk for a file of video IDs that all need the same operation.
- Response formats
Choose structured JSON for your application or Markdown content for an AI agent. Control the response with two headers.
- Errors and status codes
Read an error response and decide whether to fix, retry or stop.
Google Search
- Search
google_searchRetrieve organic results, related questions and rich results from Google Search as structured JSON. Filter by country, language and location.
- Images
google_imagesSearch Google Images and retrieve original image URLs, thumbnails, dimensions and source pages as JSON.
- News
google_newsRetrieve Google News articles with headlines, source publications, links and publication dates. Filter by country, language and date range.
- Shopping
google_shoppingSearch Google Shopping for products and retrieve prices, merchants, ratings and product links in structured JSON.
- Videos
google_videosFind videos across websites with Google Videos. Retrieve titles, video links, thumbnails, durations and source information.
- Places
google_placesSearch for local businesses and places. Retrieve names, addresses, coordinates, ratings and contact details when available.
YouTube Data
- Search
youtube_searchSearch YouTube videos by keyword and retrieve titles, channels, durations, view counts and thumbnails as JSON.
- Extended Search
youtube_search_extendedRetrieve up to 700 YouTube search results per request, with video details, thumbnails and search filters.
- Video Metadata
youtube_metadataRetrieve video metadata by YouTube video ID, including channel details, engagement counts, thumbnails, available formats and chapters.
- Transcript
youtube_transcriptRetrieve YouTube transcript text with timestamps and a full transcript. Automatic captions are selected by default.
- Captions
youtube_captionsRetrieve YouTube captions as timestamped text and a full transcript. Uploader-provided captions are selected by default.
- Channel
youtube_channelRetrieve a YouTube channel profile and its recent videos by handle, including subscriber counts, channel images and video details.
- Suggestions
youtube_suggestionsRetrieve YouTube autocomplete suggestions for a keyword or phrase, with language and region controls.
- License labels
youtube_trainabilityCheck a YouTube video's license metadata for a Creative Commons label and retrieve the result as JSON.