add_app
ChatGPTUse this when the user wants to add an app to ASOScan by its App Store or Google Play link, or its package or bundle id, for example "add my app to ASOScan". Call it only when the user explicitly asks to add an app. Never call it just to get data on an app that is not tracked: tell the user it is not in their account and offer to add it. Ask which country to track if the user did not say. The ASO score and recommendations are ready in about a minute, and keyword opportunities start to appear a few minutes later. Uses 2 API credits and one app slot on the user's plan.
add_competitor
ChatGPTUse this when the user wants to track a competitor app by its App Store or Google Play link. Uses 2 API credits.
draft_localized_metadata
ChatGPTUse this when the user wants to get listing text for another language or country, for example "app store localization": title, subtitle, keywords and description written for that market. ASOScan saves a draft and sends nothing to the store. Uses 2 API credits and 1 AI credit, so tell the user the cost first. If the answer says ASOScan is preparing, ask again in a minute.
draft_review_reply
ChatGPTUse this when the user wants to get a reply written for one of their reviews, for example "reply to app store reviews". ASOScan writes a draft with AI and sends nothing to the store. Uses 2 API credits and 1 AI credit, so tell the user the cost first. Works only for reviews from an app connected to App Store Connect or Google Play Console.
find_keyword_opportunities
ChatGPTUse this when the user wants to find keyword ideas they could rank for, for example "new app keywords to target" or "which keywords should I target". Returns keyword ideas sorted by opportunity score, with volume and difficulty, for many terms in one call. Prefer this over calling research_keyword once per term. Uses 2 API credits.
get_app_details
ChatGPTUse this when the user wants to see the basic facts about one of their apps: name, developer, store, rating, version and category. Free: uses 0 API credits.
get_aso_recommendations
ChatGPTUse this when the user wants to know what to change to rank higher, for example "how can I improve my app store ranking". Returns ASOScan's recommendations in priority order: each has a title (what to do) and why; AI-written ones also give how and the expected impact. Good ASO helps an app rank better, but never promise a rank. Free: uses 0 API credits.
get_aso_score
ChatGPTUse this when the user wants to check how good their app store listing is, for example "aso audit", "app store optimization checklist" or "what is my ASO score". Returns a score out of 100 with three parts (metadata, ratings, conversion) and what to fix. The parts check that fields are filled and the right length, not how good the words are. Free: uses 0 API credits.
get_category_rank
ChatGPTUse this when the user wants to see their app's chart position in its store category over time, for example "app store category ranking". Free: uses 0 API credits.
get_competitors
ChatGPTUse this when the user wants to see the competitor apps they track for an app, for example "who are my app's competitors". Free: uses 0 API credits.
get_keyword_metrics_history
ChatGPTUse this when the user wants to see how the search volume and difficulty of one tracked keyword changed week by week. Free: uses 0 API credits.
get_keyword_rank_history
ChatGPTUse this when the user wants to see how the rank of one tracked keyword moved day by day. Free: uses 0 API credits.
get_listing_metadata
ChatGPTUse this when the user wants to see their current app store listing text: title, subtitle, description, keywords and what's new. Free: uses 0 API credits.
get_metadata_changelog
ChatGPTUse this when the user wants to see what changed in their listing over time, field by field, for example "what changed in my app listing". Free: uses 0 API credits.
get_rating_history
ChatGPTUse this when the user wants to see how their app's average rating and number of ratings changed over time. Free: uses 0 API credits.
get_review_insights
ChatGPTUse this when the user wants to know what people say in their reviews, for example "app review analysis": sentiment, top topics, feature requests and bugs. Free: uses 0 API credits.
get_reviews
ChatGPTUse this when the user wants to read their app's reviews, newest first, with an optional star filter. Free: uses 0 API credits.
get_tracked_keywords
ChatGPTUse this when the user wants to see the keywords they track, with rank, rank change, search volume and difficulty, or asks "app store rank tracker", "app store rank tracking", "why is my app not showing in search" or "where does my app rank". Free: uses 0 API credits.
get_usage
ChatGPTUse this when the user wants to know how many API credits they have used or have left this month. Free: uses 0 API credits.
list_localized_drafts
ChatGPTUse this when the user wants to see the listing drafts they saved for other languages and countries. Free: uses 0 API credits.
list_my_apps
ChatGPTUse this when the user wants to see the apps in their ASOScan account, for example "what apps do I have in ASOScan", or when you need an app id for another tool. Returns each app's id, store, name and rating. Free: uses 0 API credits, so call it freely to check setup or resolve an app id.
list_reply_templates
ChatGPTUse this when the user wants to see their saved review reply templates for an app. Free: uses 0 API credits.
post_review_reply
ChatGPTUse this when the user wants to publish a reply to one of their reviews on the App Store or Google Play. First show the user the exact reply text and wait for a clear yes. The app must be connected to the user's App Store Connect or Google Play Console account. If the review already has a reply from the developer, this replaces it. Uses 2 API credits.
research_keyword
ChatGPTUse this when the user wants to do a deep dive on ONE specific word or phrase they already have in mind, for example "app store keyword research" or "app store keyword search volume": search volume, difficulty and the top apps for it. Uses 8 API credits, so tell the user the cost before you call it. For several keyword ideas at once, use find_keyword_opportunities instead (2 credits, covers many terms in one call). Do not call this again for a term already researched in this conversation, reuse that result.
spy_competitor_keywords
ChatGPTUse this when the user wants to see every keyword one of their tracked apps ranks for, such as a competitor, for example "which keywords do my competitors rank for". Returns rank, volume and difficulty for each keyword. Uses 2 API credits.
track_keywords
ChatGPTUse this when the user wants to start tracking keywords for an app, up to 500 at once, for example "track these keywords for my app". Without a country it uses the app's main country; say which country was used. Uses 2 API credits.
