apiverve/cli repository overview

⁠APIVerve CLI

Call 350+ production APIs from a single command — weather, geocoding, finance, DNS, validation, text, AI, images, and more. One API key. No SDKs.

APIVerve⁠ is a marketplace of 350+ ready-to-use REST APIs behind one key. This image wraps the official @apiverve/cli⁠ so you can call any of them straight from your shell, a script, or a CI job — no client library, no boilerplate, no per-API setup.

The entire API catalog is baked into the image, so list, search, --help, and input validation all work offline. Only the actual API call touches the network.

docker run --rm -e APIVERVE_API_KEY=your_key apiverve/cli emailvalidator --email [email protected]

⁠Why the APIVerve CLI

• 🔑 One key, 350+ APIs — stop signing up for a different service per task.
• 📦 Zero dependencies, tiny image — pure Node, nothing to install into your app.
• ✈️ Offline-aware — browse and validate without a network; auto-refreshes its catalog only when it sees something new.
• 🧪 Typed pre-flight validation — catches missing/invalid parameters before a request is spent.
• 🧰 Pipe-friendly — clean JSON to stdout (compact when piped), so | jq just works.
• 🏗️ Multi-arch — native linux/amd64 and linux/arm64.

⁠Quick start

# 1. Grab a FREE key (no card) at https://dashboard.apiverve.com/signup
export APIVERVE_API_KEY=your_key

# 2. Call anything
docker run --rm -e APIVERVE_API_KEY apiverve/cli iplookup --ip 1.1.1.1
docker run --rm -e APIVERVE_API_KEY apiverve/cli currencyconverter --value 100 --from USD --to EUR

# 3. Explore the catalog (works offline)
docker run --rm apiverve/cli list
docker run --rm apiverve/cli list --category Finance
docker run --rm apiverve/cli search weather
docker run --rm apiverve/cli weatherforecast --help

⁠A taste of what's inside

350+ APIs across 25+ categories — weather, finance & markets, DNS & networking, validation, geolocation, text & language, AI & vision, and a deep bench of developer utilities. All on one key.

Browse the full catalog at apiverve.com/marketplace⁠, or list it right in your shell: apiverve list · apiverve search <term> · apiverve categories.

⁠Real-world usage

Pipe into jq:

docker run --rm -e APIVERVE_API_KEY apiverve/cli iplookup --ip 1.1.1.1 | jq '.country'

Loop over inputs in a shell script:

for d in google.com github.com apiverve.com; do
  docker run --rm -e APIVERVE_API_KEY apiverve/cli sslchecker --domain "$d" | jq "{d:\"$d\", valid:.isValid}"
done

In GitHub Actions:

- name: Validate an email
  run: |
    docker run --rm -e APIVERVE_API_KEY=${{ secrets.APIVERVE_API_KEY }} \
      apiverve/cli emailvalidator --email "${{ github.event.inputs.email }}"

As a docker-compose one-off:

services:
  apiverve:
    image: apiverve/cli
    environment: [ APIVERVE_API_KEY ]
    entrypoint: ["apiverve"]

docker compose run --rm apiverve weatherforecast --city "New York"

Handy shell alias:

alias apiverve='docker run --rm -e APIVERVE_API_KEY apiverve/cli'
apiverve dnslookup --domain apiverve.com

⁠Commands

⁠Configuration

Per-command flags: --raw (full {status,error,data} envelope), --json (for list), --no-refresh (skip a catalog refresh), --api-key <key>.

⁠Output & exit codes

• Prints the response data as JSON to stdout — pretty in a terminal, compact when piped. --raw gives the full envelope.
• Warnings and errors go to stderr.
• Exit 0 = success · 1 = API error · 2 = usage/validation error.

⁠Prefer npm or npx?

Same tool, three ways to run it:

npm install -g @apiverve/cli   &&   apiverve weatherforecast --city "New York"   # global
npx @apiverve/cli list                                                            # no install
docker run --rm apiverve/cli list                                                 # this image

⁠Supported tags

• apiverve/cli:latest — newest release
• apiverve/cli:1.0.0 — pinned version

Architectures: linux/amd64, linux/arm64.

⁠Links

• 🌐 Website: https://apiverve.com?utm_source=dockerhub&utm_medium=readme&utm_campaign=cli_image⁠
• 🛒 Browse 350+ APIs: https://apiverve.com/marketplace?utm_source=dockerhub&utm_medium=readme&utm_campaign=cli_image⁠
• 🔑 Get a free API key: https://dashboard.apiverve.com/signup?utm_source=dockerhub&utm_medium=readme&utm_campaign=cli_image⁠
• ⌨️ CLI landing page: https://apiverve.com/cli?utm_source=dockerhub&utm_medium=readme&utm_campaign=cli_image⁠
• 📚 Documentation: https://docs.apiverve.com?utm_source=dockerhub&utm_medium=readme&utm_campaign=cli_image⁠
• 📦 npm package: https://www.npmjs.com/package/@apiverve/cli⁠
• 💻 Source (MIT, open source): https://github.com/apiverve/cli⁠
• 🐞 Issues: https://github.com/apiverve/cli/issues⁠

Made by APIVerve⁠ — 350+ APIs, one key, one bill.