ASO Skill

Use when the user wants up to ten current App Store keyword ideas that complete a seed term. One successful call costs one ASO Skill credit, including a cache hit. Results are cached for 30 days independently by storefront and platform. Defaults to US iPhone. Do not use for ranked app results or popularity.

autocomplete_app_store_keywords

Use before a multi-call research plan, when the user asks about balance or usage, or after an insufficient-credits error. Returns paid, promotional, daily-free, total available, and used credits. This call is free, does not charge credits, and only updates internal connection telemetry.

get_credit_balance

Use when the user wants the current 1–100 Apple App Store popularity of a keyword in one storefront. One successful call costs one credit. Report the source: autocomplete means a conservative 6–10 estimate for an Apple-censored low-volume term, while fallback means no stronger signal was available. If resolution is pending, honor retryAfterSeconds because background autocomplete evidence can still improve the score. Defaults to US. Popularity is not platform-specific and is distinct from difficulty.

get_keyword_popularity

Use when the user has one to ten numeric Apple App Store IDs and wants current app metadata, ratings, categories, versions, screenshots, or descriptions. Batch all known IDs because one successful batch costs one credit. Report missingAppIds. Do not use this to search by keyword.

lookup_app_store_apps

Use when the user wants current ranked Apple App Store search results, competitors, or a 0–100 keyword difficulty score for a specific term. One successful call costs one ASO Skill credit, including a cache hit. Defaults to US iPhone when omitted. Do not use for Android, historical rankings, downloads, revenue, or ranking predictions.

search_app_store