Browse documentation
Get started
Search Google, retrieve YouTube data and deliver media from your terminal or AI agent. One executable; no Node.js or Python required.
On this page
1. Install
Choose your platform. These native builds need no Node.js or Python. Run the commands in a writable folder; standalone downloads are checksum-verified.
With Homebrew installed:
brew install flashdatadev/tap/flashdata
flashdata --versionBash · Run uname -m first. Use this build for x86_64; ARM64 and package-manager options are below.
# Run in Bash, in a writable parent directory.
(
set -eu
mkdir "flashdata-cli-1.2.1"
cd "flashdata-cli-1.2.1"
curl --fail --show-error --location 'https://github.com/flashdatadev/flashdata-cli/releases/download/v1.2.1/flashdata_1.2.1_linux_amd64.tar.gz' -o 'flashdata_1.2.1_linux_amd64.tar.gz'
curl --fail --show-error --location 'https://github.com/flashdatadev/flashdata-cli/releases/download/v1.2.1/SHA256SUMS' -o SHA256SUMS
grep ' flashdata_1.2.1_linux_amd64.tar.gz$' SHA256SUMS | sha256sum -c -
tar -xzf 'flashdata_1.2.1_linux_amd64.tar.gz'
chmod +x flashdata
./flashdata --version
) &&
export PATH="$PWD/flashdata-cli-1.2.1:$PATH" &&
flashdata --version# Run in PowerShell, in a writable parent directory.
& {
$ErrorActionPreference = 'Stop'
$archive = 'flashdata_1.2.1_windows_amd64.zip'
$installDir = Join-Path (Get-Location) 'flashdata-cli-1.2.1'
if (Test-Path -LiteralPath $installDir) { throw 'Directory exists; choose a fresh parent directory.' }
New-Item -ItemType Directory -Path $installDir | Out-Null
Invoke-WebRequest 'https://github.com/flashdatadev/flashdata-cli/releases/download/v1.2.1/flashdata_1.2.1_windows_amd64.zip' -OutFile (Join-Path $installDir $archive)
Invoke-WebRequest 'https://github.com/flashdatadev/flashdata-cli/releases/download/v1.2.1/SHA256SUMS' -OutFile (Join-Path $installDir 'SHA256SUMS')
$entry = Get-Content (Join-Path $installDir 'SHA256SUMS') | Where-Object { $_.EndsWith(' ' + $archive) }
if (@($entry).Count -ne 1) { throw 'Archive checksum entry missing or ambiguous.' }
$expected = ($entry -split '\s+')[0]
$actual = (Get-FileHash (Join-Path $installDir $archive) -Algorithm SHA256).Hash
if ($actual -ne $expected) { throw 'Checksum mismatch; stop installation.' }
Expand-Archive -LiteralPath (Join-Path $installDir $archive) -DestinationPath $installDir
$env:PATH = $installDir + [IO.Path]::PathSeparator + $env:PATH
& (Join-Path $installDir 'flashdata.exe') --version
}Other installation options
Standalone commands set PATH for this terminal. Add the extracted directory to your user PATH for later sessions, or use the executable's absolute path.
# Run in Bash, in a writable parent directory.
(
set -eu
mkdir "flashdata-cli-1.2.1"
cd "flashdata-cli-1.2.1"
curl --fail --show-error --location 'https://github.com/flashdatadev/flashdata-cli/releases/download/v1.2.1/flashdata_1.2.1_linux_arm64.tar.gz' -o 'flashdata_1.2.1_linux_arm64.tar.gz'
curl --fail --show-error --location 'https://github.com/flashdatadev/flashdata-cli/releases/download/v1.2.1/SHA256SUMS' -o SHA256SUMS
grep ' flashdata_1.2.1_linux_arm64.tar.gz$' SHA256SUMS | sha256sum -c -
tar -xzf 'flashdata_1.2.1_linux_arm64.tar.gz'
chmod +x flashdata
./flashdata --version
) &&
export PATH="$PWD/flashdata-cli-1.2.1:$PATH" &&
flashdata --version# Run in Bash, in a writable parent directory.
(
set -eu
mkdir "flashdata-cli-1.2.1"
cd "flashdata-cli-1.2.1"
curl --fail --show-error --location 'https://github.com/flashdatadev/flashdata-cli/releases/download/v1.2.1/flashdata_1.2.1_darwin_amd64.tar.gz' -o 'flashdata_1.2.1_darwin_amd64.tar.gz'
curl --fail --show-error --location 'https://github.com/flashdatadev/flashdata-cli/releases/download/v1.2.1/SHA256SUMS' -o SHA256SUMS
grep ' flashdata_1.2.1_darwin_amd64.tar.gz$' SHA256SUMS | shasum -a 256 -c -
tar -xzf 'flashdata_1.2.1_darwin_amd64.tar.gz'
chmod +x flashdata
./flashdata --version
) &&
export PATH="$PWD/flashdata-cli-1.2.1:$PATH" &&
flashdata --version# Run in Bash, in a writable parent directory.
(
set -eu
mkdir "flashdata-cli-1.2.1"
cd "flashdata-cli-1.2.1"
curl --fail --show-error --location 'https://github.com/flashdatadev/flashdata-cli/releases/download/v1.2.1/flashdata_1.2.1_darwin_arm64.tar.gz' -o 'flashdata_1.2.1_darwin_arm64.tar.gz'
curl --fail --show-error --location 'https://github.com/flashdatadev/flashdata-cli/releases/download/v1.2.1/SHA256SUMS' -o SHA256SUMS
grep ' flashdata_1.2.1_darwin_arm64.tar.gz$' SHA256SUMS | shasum -a 256 -c -
tar -xzf 'flashdata_1.2.1_darwin_arm64.tar.gz'
chmod +x flashdata
./flashdata --version
) &&
export PATH="$PWD/flashdata-cli-1.2.1:$PATH" &&
flashdata --version2. Set up access
Choose one path. These commands use the default profile; keep using the same profile for your searches and claiming.
Create or reuse a key with Google Search permission. Paste it into the hidden login prompt.
flashdata auth login
flashdata auth statusRun from your project and choose Codex, Claude Code or Cursor. Setup installs 16 skills and reuses access or requests one eligible trial. It runs no paid query. An automated agent can use --agent codex --non-interactive (replace codex with the actual supported host).
flashdata setup
flashdata auth statusStart one eligible trial without installing agent skills. Google Search and YouTube Metadata are requested by default. Reuse valid saved access instead if you already have it.
flashdata init --name "My CLI"
flashdata auth status3. Run your first search
This command sends one Google search for up to five results and prints the response.
flashdata search "battery recycling research" --num 5What you should see
Look for ok: true and data.status: done. Read titles and URLs in data.results[].organic and the charge in data.usage.credits. Example (abbreviated):
{
"schemaVersion": 1,
"ok": true,
"cached": false,
"data": {
"status": "done",
"results": [
{
"organic": [
{
"title": "Battery recycling research",
"link": "https://example.org/recycling",
"snippet": "An example search excerpt."
}
]
}
],
"usage": {
"credits": 0.02
}
}
}More CLI tasks
Choose a task below. Queries use the connected key's source permissions and credits. Check the key’s permitted sources before switching tasks; downloads require owner access.
Find pages with a chosen result count, language and country context.
flashdata search "battery recycling research" --num 5 --hl en --gl us --jsonSearch for candidate videos, then use one returned video ID with metadata or transcript. Each command is a separate query; replace the sample ID with your chosen video.
flashdata youtube search "battery recycling" --max-results 5 --jsonflashdata youtube metadata FUfGcZ092b0 --jsonflashdata youtube transcript FUfGcZ092b0 --language en --jsonUse an owner key with youtube_download permission. Prepare a private storage.json with your destination storage settings using the storage setup link in this tab. Replace the video ID with one you are authorized to process. This command waits for the background job and saves a delivery record, not the media file.
flashdata youtube download FUfGcZ092b0 --format mp3 --storage-config storage.json --wait --output delivery.json --jsonCheck pricing, balance and permitted sources without submitting queries.
flashdata account balance
flashdata account pricing --source google_search --request-count 1
flashdata sources listPreview the cost before a query
These commands read your balance and estimate without running a search. Check data.estimateAvailable and compare the estimate with available credits.
flashdata account balance
flashdata search "battery recycling research" --num 5 --dry-run --jsonUse in scripts and agents
For another intended search, choose a new run ID and output filename. Existing files are not overwritten. After an interrupted run, inspect the existing record before submitting again.
| Option | Purpose |
|---|---|
| --json | Machine-readable execution receipt; with --output, data describes the saved file. |
| --non-interactive | Disable prompts and browser opening. |
| --output FILE | Save the source response to a new file. |
| --run-id ID | Identify one intended run and reuse its saved result. |
| --help | Show syntax and flags for any command. |
flashdata search "battery recycling research" --accept text/plain --respond-with markdown --json=falseTroubleshooting
| Problem | Try this |
|---|---|
| Command not found | Check the OS/CPU download and PATH inside the terminal or agent where you run it. |
| 401 / 403 | Run auth status. Check credentials, environment overrides and source permissions. |
| 402 / 429 | Check Billing or claim an exhausted trial. For rate limits, follow Retry-After. |
| Output exists / timeout | Inspect the original run and saved file. Use the recovery guide before submitting new paid work. |