ASO — Public store data

Search apps, fetch metadata, browse top charts.

Updated 2026-05-24
2 min read

Read-only access to public App Store / Play Store data. These endpoints don't read your project — useful for competitive research and lookup.

Search apps

bash
GET /api/v1/apps/search?store_type=appstore&q=focus+timer&country=US&language=en&limit=10

# Scope: aso:read

Get app metadata

bash
GET /api/v1/apps/:storeType/:appId/metadata?country=US&language=en

# storeType = appstore | playstore
# appId = App Store numeric ID OR Play Store package name
# Scope: aso:read

Top charts

bash
GET /api/v1/charts?store_type=appstore&chart_type=top_free&category=games&country=US&limit=50

# chart_type = top_free | top_paid | top_grossing
# category is optional; discover via /charts/categories
# Scope: aso:read

Chart categories

bash
GET /api/v1/charts/categories?store_type=appstore

# Scope: aso:read