rankem

Official CLI for the Rankem API — create and manage ranking sets, items, and images from your terminal.

Install

npm install -g rankem

Quick Start

# Authenticate with your API key
rankem login

# See who you are
rankem whoami

# List public sets
rankem sets list

# Search everything
rankem search "best movies"

Commands

Authentication

rankem auth                      # Interactive auth
rankem auth --key rk_live_...    # Auth with key directly (CI)
rankem auth --status             # Show current auth
rankem auth --logout             # Remove credentials
rankem whoami                    # Show auth + API health

Sets

rankem sets list                         # List public sets
rankem sets list --sort popular --limit 10
rankem sets get <set-id>                 # Get set with items
rankem sets create                       # Interactive set creation

Items

rankem items list                        # List public items
rankem items list --search "pizza"
rankem items get <item-id>               # Get item details
rankem items create "Margherita Pizza"   # Create an item
rankem items create "Pepperoni" --image-url https://example.com/pepperoni.jpg

Search

rankem search "best movies"              # Global search
rankem search "taylor swift" --limit 5

Images

rankem images upload photo.jpg --entity-type item --entity-id <uuid>

Configuration

Config is stored in ~/.rankem/config.json:

{
  "apiKey": "rk_live_..."
}

API Keys

Get your API key at rankem.com/settings/api.

Keys start with rk_live_.

License

MIT