ASO Suite CLI

Use asosuite to run ASO workflows across iPhone, iPad, Mac, Apple TV, Apple Watch, and VisionOS apps: discover keywords with popularity and difficulty data, track keyword position over time, annotate tracked keywords with notes and global color-coded tags, and monitor ratings, editorial features, and chart appearances with machine-readable output.

Setup

Install:

npm install -g asosuite
asosuite help

Authenticate:

asosuite login

JSON-first rule

For easier parsing, always pass --json on every command that supports it.

Commands that do not take --json: login, logout.

Defaults

• region=US
• platform=iphone
• period=30 for charts and ratings
• Supported platforms: iPhone (iphone), iPad (ipad), Mac (mac), Apple TV (appletv), Apple Watch (watch), VisionOS (vision)

Command reference (all commands)

• asosuite login
• asosuite logout
• asosuite subscription [--json]
• asosuite search-apps [--json] [--region ] [--platform ]
• asosuite list-apps [--json]
• asosuite keywords [--json] [--region ] [--platform ] [--app ]
• asosuite track-app [--json] [--region ] [--platform ] --app
• asosuite untrack-app [--json] [--region ] [--platform ] --app
• asosuite plan-app [--json] --name [--id ] [--region ] [--platform ]
• asosuite unplan-app [--json] --id [--region ] [--platform ]
• asosuite tracked-keywords list [--json] [--region ] [--platform ] [--page ] [--sort ] [--order ] [--tag | --tags ] --app
• asosuite tracked-keywords add [--json] [--region ] [--platform ] --app
• asosuite tracked-keywords remove [--json] [--region ] [--platform ] --app
• asosuite tracked-keywords note set [--json] [--region ] [--platform ] --app --keyword --text
• asosuite tracked-keywords note clear [--json] [--region ] [--platform ] --app --keyword
• asosuite tracked-keywords tags set [--json] [--region ] [--platform ] --app --keyword [--tag | --tags ]
• asosuite tags list [--json]
• asosuite tags create [--json] --name --color
• asosuite tags edit [--json] --id [--name ] [--color ]
• asosuite tags delete [--json] --id
• asosuite related-apps list [--json] --app [--platform ]
• asosuite related-apps add [--json] --app --related [--platform ] [--region ]
• asosuite related-apps remove [--json] --app --related [--platform ]
• asosuite events list [--json] [--app ]
• asosuite events add [--json] --text [--date ] [--app ]
• asosuite events delete [--json]
• asosuite charts [--json] [--period <7|30|90>] [--region | --regions ] [--platform ] --app
• asosuite features [--json] [--platform ] --app
• asosuite ratings [--json] [--period <7|30|90>] [--platform ] --app

Common ASO commands (JSON)

# Account info
asosuite subscription --json

# Discover apps
asosuite search-apps --json --region US --platform iphone "chat gpt"

# Tracked/planned apps
asosuite list-apps --json
asosuite track-app --json --app 6448311069 --platform iphone --region US
asosuite untrack-app --json --app 6448311069 --platform iphone --region US
asosuite plan-app --json --name "My Next App" --platform iphone --region US
asosuite unplan-app --json --id my-next-app --platform iphone --region US

# Keyword research + tracking
asosuite keywords --json --region US --platform iphone --app 6448311069 "step counter" "water tracker"
asosuite tracked-keywords list --json --app 6448311069 --platform iphone --region US --page 1 --sort relevance --order desc
asosuite tracked-keywords add --json --app 6448311069 --platform iphone --region US "step counter" "water tracker"
asosuite tracked-keywords remove --json --app 6448311069 --platform iphone --region US "step counter" "water tracker"

# Keyword notes and tags
asosuite tags list --json
asosuite tags create --json --name important --color "#ef4444"
asosuite tags edit --json --id 1 --name "high intent" --color "#f97316"
asosuite tracked-keywords note set --json --app 6448311069 --platform iphone --region US --keyword "step counter" --text "1: 26.7k,12.9k"
asosuite tracked-keywords note clear --json --app 6448311069 --platform iphone --region US --keyword "step counter"
asosuite tracked-keywords tags set --json --app 6448311069 --platform iphone --region US --keyword "step counter" --tag 1
asosuite tracked-keywords list --json --app 6448311069 --platform iphone --region US --tag 1 --sort tags --order asc

# Related apps / competitors
asosuite related-apps list --json --app 6448311069 --platform iphone
asosuite related-apps add --json --app 6448311069 --related 333903271 --platform iphone --region US
asosuite related-apps remove --json --app 6448311069 --related 333903271 --platform iphone

# Charts, featuring, ratings
asosuite charts --json --app 6448311069 --platform iphone --period 30
asosuite features --json --app 6448311069 --platform iphone
asosuite ratings --json --app 6448311069 --platform iphone --period 30

# Events
asosuite events list --json --app 6448311069
asosuite events add --json --app 6448311069 --text "Started ASO for 'keyword x'" --date 2026-02-25
asosuite events delete --json 123

Notes

• tracked-keywords list returns up to 50 keywords per page.
• Sort fields for tracked-keywords list: keyword, relevance, notes, tags, popularity, difficulty, position, lastUpdate.
• tracked-keywords list --tag or --tags filters to keywords that have any selected tag.
• Tag sorting is by tag label/name. Tagged rows sort before untagged rows for both ascending and descending order.
• Tags are global for the user's tracking scope and can be applied to tracked app keywords or planned app keywords. Use tag IDs for edits, deletes, filters, and keyword assignment; labels can be renamed.
• Keyword notes are free-text annotations on individual tracked keywords. Use note clear to remove a note.
• Server limits:
• keywords: up to 50 keywords per request
• tracked-keywords add/tracked-keywords remove: up to 200 keywords per request