Skip to main content

​
Overview

CommandDescriptionMethod
naive app-data google <endpoint>Google Play app dataStandard (async)
naive app-data apple <endpoint>App Store app dataStandard (async)
naive app-data google app-listingsGoogle Play listingsLive
naive app-data apple app-listingsApp Store listingsLive

​
Google Play

naive app-data google app-searches --keyword "fitness tracker" --location-code 2840
naive app-data google app-info --app-id com.example.fitness
naive app-data google app-reviews --app-id com.example.fitness --limit 50
naive app-data google app-list --category "HEALTH_AND_FITNESS"
naive app-data google app-listings --title "fitness"

​
Endpoints

EndpointDescriptionMethod
app-searchesSearch apps by keywordStandard
app-listTop charts by categoryStandard
app-infoDetailed app metadataStandard
app-reviewsUser reviews and ratingsStandard
app-listingsSearch listingsLive

​
Options

FlagRequiredDescription
--keyword <text>VariesSearch keyword
--app-id <id>VariesApp package name (e.g. com.example.app)
--category <cat>NoApp category
--location-code <code>NoLocation code
--language-code <code>NoLanguage code
--depth <n>NoNumber of results (default: 100)
--limit <n>NoMax results for reviews

​
App Store

naive app-data apple app-searches --keyword "meditation" --location-code 2840
naive app-data apple app-info --app-id "1234567890"
naive app-data apple app-reviews --app-id "1234567890"
naive app-data apple app-listings --title "meditation" --categories "6013"

​
Endpoints

EndpointDescriptionMethod
app-searchesSearch apps by keywordStandard
app-listTop charts by categoryStandard
app-infoDetailed app metadataStandard
app-reviewsUser reviews and ratingsStandard
app-listingsSearch listingsLive

​
Options

FlagRequiredDescription
--keyword <text>VariesSearch keyword
--app-id <id>VariesApp Store numeric ID
--title <text>NoApp title filter (for listings)
--categories <list>NoComma-separated category IDs
--location-code <code>NoLocation code
--language-code <code>NoLanguage code

​
Task Management

Async endpoints return a task ID. Check and retrieve results: 
# Submit task
naive app-data google app-searches --keyword "fitness"
# → task_id: abc-123

# Check ready tasks
naive app-data tasks-ready --platform google --endpoint app-searches

# Get results
naive app-data task-get abc-123 --platform google --endpoint app-searches
FlagDescription
naive app-data tasks-ready --platform <p> --endpoint <e>List tasks with ready results
naive app-data task-get <task_id> --platform <p> --endpoint <e>Retrieve results for a task
--htmlGet HTML format (Google Play only)