Skip to content
EN
Get API key
Browse documentation

Get started

FlashData CLI

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:

Homebrew
brew install flashdatadev/tap/flashdata
flashdata --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.

Linux ARM64
# 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

2. 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.

Save and check access
flashdata auth login
flashdata auth status

3. Run your first search

This command sends one Google search for up to five results and prints the response.

Search
flashdata search "battery recycling research" --num 5

What 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):

Terminal output
{
  "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.

Google Search
flashdata search "battery recycling research" --num 5 --hl en --gl us --json

Preview 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.

Preview
flashdata account balance
flashdata search "battery recycling research" --num 5 --dry-run --json

Use 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.

OptionPurpose
--jsonMachine-readable execution receipt; with --output, data describes the saved file.
--non-interactiveDisable prompts and browser opening.
--output FILESave the source response to a new file.
--run-id IDIdentify one intended run and reuse its saved result.
--helpShow syntax and flags for any command.
Ask for Markdown
flashdata search "battery recycling research" --accept text/plain --respond-with markdown --json=false

Troubleshooting

ProblemTry this
Command not foundCheck the OS/CPU download and PATH inside the terminal or agent where you run it.
401 / 403Run auth status. Check credentials, environment overrides and source permissions.
402 / 429Check Billing or claim an exhausted trial. For rate limits, follow Retry-After.
Output exists / timeoutInspect the original run and saved file. Use the recovery guide before submitting new paid work.

Go further