Skip to content
DocumentationAPI Reference
API Reference

Spotted CLI

Spotted CLI

The unofficial CLI for the Spotify Web API.

It is generated with Stainless.

Installation

Installing with Homebrew

brew tap cjavdev/spotted-cli
brew install spotted

Installing with Go

go install 'github.com/cjavdev/spotted-cli/cmd/spotted@latest'

Running Locally

./scripts/run args...

Usage

The CLI follows a resource-based command structure:

spotted [resource] [command] [flags]
spotted albums retrieve \
  --id 4aawyAB9vmqN3uQ7FjRGTy \
  --market ES

For details about specific commands, use the --help flag.

Global Flags

  • --help - Show command line usage
  • --debug - Enable debug logging (includes HTTP request/response details)
  • --version, -v - Show the CLI version
  • --base-url - Use a custom API backend URL
  • --format - Change the output format (auto, explore, json, jsonl, pretty, raw, yaml)
  • --format-error - Change the output format for errors (auto, explore, json, jsonl, pretty, raw, yaml)
  • --transform - Transform the data output using GJSON syntax
  • --transform-error - Transform the error output using GJSON syntax