Core concepts
Understand the main objects OpenASO works with.
Tracked app
A tracked app is an App Store app that OpenASO monitors. It is keyed by App Store ID and stores metadata such as bundle ID, app name, subtitle, seller name, and default platform.
Storefront
A storefront represents an App Store country or region. OpenASO seeds storefront definitions locally and uses two-letter storefront codes such as us.
Keyword track
A keyword track is a single keyword, storefront, and platform combination for one tracked app. For example, fitness tracker in the United States on iPhone is distinct from the same keyword in the United Kingdom.
Ranking snapshot
A ranking snapshot records the app's position for a keyword search at a point in time. It also stores the top ranked apps returned by the search provider.
Search observation
A search observation stores a normalized keyword search result independent of one tracked app. OpenASO uses observations to derive competitive stats and ranking history.
Keyword metrics
Keyword metrics enrich tracks with popularity and difficulty fields. The current implementation fetches popularity from Apple Ads when a valid web session and linked app context are available.
Ratings and reviews
OpenASO stores latest storefront rating values, rating snapshots, and reviews for tracked apps. The ratings workspace lets you filter and export that data.