appshovel

CLI for the AppShovel keyword API — fetch App Store keyword popularity scores and recommendations from the command line.

Install

npm install -g appshovel

Or run directly with npx:

npx appshovel popularities "weather,fitness"

Authentication

Set your API key as an environment variable (recommended):

export APPSHOVEL_API_KEY="your_api_key"

Or pass it per-command:

appshovel popularities "weather" --api-key your_api_key

Create API keys at appshovel.com/settings.

Commands

popularities

Fetch popularity and difficulty scores for up to 100 keywords.

appshovel popularities "weather,fitness,tracker" --country us --platform iphone

Country: United States | Platform: iPhone

| Term    | Popularity | Difficulty |
| ------- | ---------- | ---------- |
| weather | 82         | 95         |
| fitness | 55         | 61         |
| tracker | 38         | 42         |

recommendations

Get keyword recommendations for a single term.

appshovel recommendations "weather" --country de --platform ipad

Term: weather | Country: Germany | Platform: iPad

| Recommendation   | Popularity |
| ---------------- | ---------- |
| weather forecast | 70         |
| weather radar    | 65         |
| weather app      | 58         |

countries

List all supported country codes.

appshovel countries

platforms

List all supported platforms.

appshovel platforms

Options

| Option | Short | Default | Description | | ------------------- | ----- | --------------------------- | ------------------------------------- | | --api-key <key> | -k | APPSHOVEL_API_KEY env var | API key | | --country <code> | -c | us | Country code (case-insensitive) | | --platform <code> | -p | iphone | iphone or ipad (case-insensitive) | | --format <format> | -f | md | Output format: md, json, csv |

Output Formats

• md (default) — Markdown tables with human-readable country/platform names
• json — Raw JSON matching the API response shape
• csv — CSV with headers

# Markdown table (default)
appshovel popularities "weather"

# JSON for scripting
appshovel popularities "weather" --format json

# CSV for spreadsheets
appshovel popularities "weather" --format csv

License

MIT