itunes-cli

CLI for searching and exploring iOS/macOS apps via the iTunes Search API.

Install

npm install -g @onmyway133/itunes-cli
# or
bun install -g @onmyway133/itunes-cli

Commands

search

Search apps by keyword.

itunes-cli search --term "todo list"
itunes-cli search --term "weather" --country gb --limit 20
itunes-cli search --term "photo" --json

Options:

• --term — search query (required)
• --limit — number of results, 1–200 (default: 10)
• --country — country code, e.g. us, gb, de (default: us)

lookup

Get full details for an app by its App Store ID.

itunes-cli lookup --id 310633997
itunes-cli lookup --id 310633997 --country gb
itunes-cli lookup --id 310633997 --json

Options:

• --id — App Store app ID (required)

developer

List all apps published by a developer, by their artist ID.

itunes-cli developer --id 284417353
itunes-cli developer --id 284417353 --country gb
itunes-cli developer --id 284417353 --json

Options:

• --id — developer/artist ID (required)

rss

Get top chart apps from iTunes RSS feeds.

itunes-cli rss
itunes-cli rss --feed paid --limit 25
itunes-cli rss --feed mac-grossing
itunes-cli rss --feed free --genre 6014 --limit 10

Options:

• --feed — feed type (default: free)
  • iPhone: free paid grossing new new-free new-paid
  • iPad: ipad-free ipad-paid ipad-grossing
  • Mac: mac-free mac-paid mac-grossing
• --limit — number of results, 1–200 (default: 10)
• --genre — genre/category ID (e.g. 6014 for Games)

reviews

Get customer reviews for an app.

itunes-cli reviews --id 310633997
itunes-cli reviews --id 310633997 --page 2
itunes-cli reviews --id 310633997 --sort mostRecent
itunes-cli reviews --id 310633997 --json

Options:

• --id — App Store app ID (required)
• --page — page number (default: 1)
• --sort — mostHelpful or mostRecent (default: mostHelpful)

Global options

All commands accept:

• --country <cc> — country code (default: us)
• --json — output raw JSON instead of formatted table
• -h, --help — show help
• -v, --version — show version

Build

bun run build

License

MIT © Khoa Pham 2026