Skip to main content
Loss of provenance

A previous release had provenance metadata, but this release does not. View details.

Google Images CLI — FlashData

Build an image-reference inventory for manual review. This command calls the google_images API and returns JSON for your shell script, data pipeline or agent tool runner. It does not invoke a language model.

Does not download images or establish image reuse rights.

Install and run

Requires Python 3.10 or newer. uv installation provides uvx, which runs this package in an isolated environment.

  1. Create a FlashData account, obtain an API Key and fund Credits.
  2. Set FLASHDATA_API_KEY using your shell or secret manager. The CLI does not accept a key flag or persist credentials. Authentication and source documentation.
  3. Run this example after reviewing the input and cost:
uvx flashdata-google-images@0.2.0 --query 'rooftop solar installation' --options-json '{"num": 5}' --output result.json

--output creates a new file with owner-only permissions where supported and refuses existing files before making a paid request. Without it, the full JSON response goes to stdout. Errors go to stderr. Exit 0 means the response was exported, 2 means local input/configuration failure, and 1 means request or output failure. For downloads, exit 0 can describe an unfinished job.

For repeated use, install uv tool install flashdata-google-images==0.2.0; the command name is flashdata-google-images. Alternatively use python -m pip install flashdata-google-images==0.2.0 in your virtual environment.

Inputs and output

Use --query for the primary input. Additional options use --options-json as a JSON object, with strict field/type/range validation. Source is fixed by this package. Google count and locale options remain omitted unless supplied.

Option Meaning
num Requested result count. Default: null.
page Search result page. Default: null.
autocorrect Enable spelling autocorrection. Default: null.
gl Two-letter country code, for example us. Default: null.
hl Interface language code, for example en. Default: null.
location Optional geographic search location. Default: null.
tbs Optional Google time filter, for example qdr:w. Default: null.

Run uvx flashdata-google-images@0.2.0 --schema to inspect all fields, nested filters, allowed values and defaults without a Key or an API call. --help and --version are also local-only.

The JSON output preserves the API result envelope and optional fields: results[].images: image/source URLs and available dimensions; usage.credits. Missing fields remain missing; empty results remain empty. No article text, translated captions, model conclusions, rights grants or keyword volumes are invented. Exact source contracts are documented here.

Fees and failure handling

This MIT-licensed CLI is free to install. FlashData API requests consume paid Credits; current pricing applies. Extended YouTube Search has a separate rate. Media delivery is billed by delivered volume, and your cloud-storage costs are separate. There is no automatic pagination, retry, polling, scheduled execution or model call.

Each HTTP request has a 120-second network timeout (15-second connect timeout) and a 20-MiB response limit. A timeout or failure may occur after a paid request has been accepted. Check Jobs in the FlashData console before resubmitting. HTTP 401 means check the Key; 402 means insufficient Credits; 429 means rate/quota limit. A partial output file is retained on failure. Do not retry a paid query just because output handling failed.

Input values and your API Key are sent to FlashData to perform the request. A completed download-result read may fetch a signed JSON object from the result origin returned by FlashData; the API Key is never sent to that object URL. Only process data appropriate for your output destination. Privacy policy.

Source and MIT license are included in the source distribution.

Source documentation · Pricing · Sign up

Metadata

Release files for flashdata-google-images 0.2.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Loss of provenance

These files do not have provenance metadata, despite files in a prior release including this data.

We recommend further investigation before installing these files. View details.

Source distribution (sdist)

Source distribution for flashdata-google-images 0.2.0
File Size Uploaded Provenance Actions
flashdata_google_images-0.2.0.tar.gz 13.1 kB Without provenance Details for flashdata_google_images-0.2.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for flashdata-google-images 0.2.0
File Interpreter ABI Platform Actions
flashdata_google_images-0.2.0-py3-none-any.whl Python 3 none any Details for flashdata_google_images-0.2.0-py3-none-any.whl

Total release size: 28.9 kB

Release files / flashdata_google_images-0.2.0.tar.gz

Loss of provenance

This file belongs to a release without provenance metadata, despite a prior release including this data.

We recommend further investigation before installing this file. View details.

Download URL flashdata_google_images-0.2.0.tar.gz
Size 13.1 kB
Tags Source
SHA-256 checksum
How to use checksums
8f4b0877fd256d3ddbe7a96bcea5ebbbe6db1d1a1a70fbe4113c8acd489c0508
BLAKE2b-256 checksum
How to use checksums
3a459e381d8d9e355c9ecb48b91f5bf69e03617b5a909cd1a1898979419877fb
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.12.13

Release files / flashdata_google_images-0.2.0-py3-none-any.whl

Loss of provenance

This file belongs to a release without provenance metadata, despite a prior release including this data.

We recommend further investigation before installing this file. View details.

Download URL flashdata_google_images-0.2.0-py3-none-any.whl
Size 15.8 kB
Tags Python 3
SHA-256 checksum
How to use checksums
f6bca0e2d1fd5a1db2442ddf590265ca186d9bcf1807b77c3e03c125d02d08c6
BLAKE2b-256 checksum
How to use checksums
bca1928c3316b8b65367c08203935d6c956d8df6fa4a88800eb4a016ced0ff54
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.12.13

Security for flashdata-google-images 0.2.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Loss of provenance

A previous release of these files had provenance metadata, but this release does not.

While this could reflect a routine change by the project maintainers, it may also indicate that the release files have been compromised.

Release comparison

  • Removed 0.1.1 2 files With provenance
  • Added 0.2.0 2 files Without provenance

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page