{"_id":"@apiverve/cli","name":"@apiverve/cli","dist-tags":{"latest":"1.0.0"},"versions":{"1.0.0":{"name":"@apiverve/cli","version":"1.0.0","description":"APIVerve CLI — call 368+ APIs from one command.","bin":{"apiverve":"bin/apiverve.js"},"engines":{"node":">=18"},"keywords":["apiverve","api","apis","cli","command-line","weather","geocoding","validation","developer-tools","http"],"author":{"name":"APIVerve"},"license":"MIT","homepage":"https://apiverve.com","repository":{"type":"git","url":"git+https://github.com/apiverve/cli.git"},"bugs":{"url":"https://github.com/apiverve/cli/issues"},"gitHead":"9678b58a9241912f5751b2e6849b6259faa7d921","_id":"@apiverve/cli@1.0.0","_nodeVersion":"24.15.0","_npmVersion":"11.13.0","dist":{"integrity":"sha512-jENLZAjatVEonzVfqGquVDftAK8rLxcSsgJ0cFAnCB6ZebYLfdoQxjvJgkLVdL71gsaRMqJso7ed++I7oGxsxw==","shasum":"59431b49c5ced6deb4c53376c38335b0c7d0596e","tarball":"https://registry.npmjs.org/@apiverve/cli/-/cli-1.0.0.tgz","fileCount":10,"unpackedSize":325114,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIHM7xkHhTMlCsClxAN81YzSe7KEz9UxQqQP2KoUIvOuPAiAuvp6nPeRlMkgmIAZokbOpX5tXtOv8M+nkuPboaCjsDw=="}]},"_npmUser":{"name":"apivervehq","email":"hello@apiverve.com"},"directories":{},"maintainers":[{"name":"charifield","email":"charifield@gmail.com"},{"name":"apivervehq","email":"hello@apiverve.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/cli_1.0.0_1784559373962_0.6557664824743268"},"_hasShrinkwrap":false}},"time":{"created":"2026-07-20T14:56:13.736Z","1.0.0":"2026-07-20T14:56:14.110Z","modified":"2026-07-20T14:56:14.368Z"},"maintainers":[{"name":"charifield","email":"charifield@gmail.com"},{"name":"apivervehq","email":"hello@apiverve.com"}],"description":"APIVerve CLI — call 368+ APIs from one command.","homepage":"https://apiverve.com","keywords":["apiverve","api","apis","cli","command-line","weather","geocoding","validation","developer-tools","http"],"repository":{"type":"git","url":"git+https://github.com/apiverve/cli.git"},"author":{"name":"APIVerve"},"bugs":{"url":"https://github.com/apiverve/cli/issues"},"license":"MIT","readme":"# APIVerve CLI\n\n**Call 368+ APIs from a single command** — weather, geocoding, validation, financial data, DNS, and more. One tool, every APIVerve API, runs anywhere.\n\n```bash\napiverve marineweather --lat 29.48 --lon -37.62\n```\n\nThe full API catalog is baked into the CLI, so `list`, `--help`, and input validation all work **offline** — the only network call is the API request itself.\n\n---\n\n## Install\n\nPick whichever fits your environment. It's the same `apiverve` command everywhere.\n\n### npm (Node 18+)\n\n```bash\nnpm install -g @apiverve/cli\napiverve --version\n```\n\n### npx (no install)\n\n```bash\nnpx @apiverve/cli marineweather --lat 29.48 --lon -37.62\n```\n\n### Docker (zero install)\n\n```bash\ndocker run --rm -e APIVERVE_API_KEY=$APIVERVE_API_KEY apiverve/cli marineweather --lat 29.48 --lon -37.62\n```\n\nAlias it for convenience:\n\n```bash\nalias apiverve='docker run --rm -e APIVERVE_API_KEY=$APIVERVE_API_KEY apiverve/cli'\n```\n\n---\n\n## Authentication\n\nGet a free API key at **[https://apiverve.com](https://apiverve.com)**, then either export it or pass it per call:\n\n```bash\nexport APIVERVE_API_KEY=your_key_here # recommended\napiverve emailvalidator --email support@myspace.com\n\napiverve emailvalidator --email support@myspace.com --api-key your_key_here\n```\n\nThe key is read from `--api-key`, then `APIVERVE_API_KEY`, then `APIVERVE_KEY`.\n\n---\n\n## Usage\n\n```\napiverve [--param value ...] Call an API\napiverve list [--category ] [--search ] [--json]\napiverve categories List categories with counts\napiverve --help Show an API's parameters and example\napiverve --version\n```\n\n### Discover APIs\n\n```bash\napiverve list # all 368 APIs\napiverve list --category Weather # filter by category\napiverve list --search email # search id / title / description\napiverve categories # every category with a count\n```\n\n### Inspect an API before calling it\n\n```bash\napiverve marineweather --help\n```\n\n```\nMarine Weather (marineweather)\nWeather\n\nGet the marine weather data for a location using latitude and longitude coordinates\n\nParameters:\n --lat (required)\n The latitude coordinate of the location\n --lon (required)\n The longitude coordinate of the location\n\nExample:\n apiverve marineweather --lat 29.48003 --lon -37.62424\n```\n\n---\n\n## Output & scripting\n\n- The response **`data`** is printed as JSON to **stdout** (`--raw` prints the full `{ status, error, data }` envelope).\n- Output is **pretty** in a terminal and **compact** when piped, so it drops straight into `jq`.\n- Errors go to **stderr**. Exit codes: **`0`** ok · **`1`** API error · **`2`** usage/validation error.\n\n```bash\n# Pipe into jq\napiverve emailvalidator --email support@myspace.com | jq '.valid'\n\n# Use in a script with proper error handling\nif temp=$(apiverve marineweather --lat 29.48 --lon -37.62 | jq -r '.temperature'); then\n echo \"Water temp: $temp\"\nelse\n echo \"Lookup failed\" >&2\nfi\n```\n\n### In CI/CD (GitHub Actions)\n\n```yaml\n- name: Check SSL expiry\n run: |\n docker run --rm -e APIVERVE_API_KEY=$ secrets.APIVERVE_API_KEY \\\n apiverve/cli sslcertificatechecker --domain example.com | jq '.daysRemaining'\n```\n\n---\n\n## Validation\n\nRequired and mistyped parameters are caught **before** a request is sent (and before any credit is spent):\n\n```bash\n$ apiverve marineweather --lat abc\nInvalid input for 'marineweather':\n - --lat must be a number\n - --lon is required (number)\n\nRun 'apiverve marineweather --help' for the parameters.\n```\n\n---\n\n## Links\n\n- Website: [https://apiverve.com](https://apiverve.com)\n- Docs: [https://docs.apiverve.com](https://docs.apiverve.com)\n- Source: [github.com/apiverve/cli](https://github.com/apiverve/cli)\n- Docker image: [`apiverve/cli`](https://hub.docker.com/r/apiverve/cli)\n\n## License\n\nMIT © APIVerve\n","readmeFilename":"README.md","_rev":"1-c28441cb8e8cd309928370a60eced316"}