Skip to main content

​
Overview

Company-scoped; requires Authorization: Bearer nv_sk_…. Pay-per-use via our data provider. Most App Data endpoints are Standard (async): POST the search/info/reviews request to enqueue a task, poll …/tasks-ready, then fetch …/:task_id (some also offer …/:task_id/html). The app-listings route is Live (instant). Agents can also use naive_app_data_discover + naive_app_data_execute(_async) over MCP. Common params: keyword: string (search), app_id: string (info/reviews — package name for Google Play, numeric ID for App Store), optional location_code, language_code, depth, and sort_by (reviews).

​
Google Play

MethodPathDescription
POST/v1/app-data/google/app-searchesSubmit app search task
GET/v1/app-data/google/app-searches/tasks-readyCheck ready search tasks
GET/v1/app-data/google/app-searches/:task_idGet search results
GET/v1/app-data/google/app-searches/:task_id/htmlGet search results (HTML)
POST/v1/app-data/google/app-listSubmit top charts task
GET/v1/app-data/google/app-list/tasks-readyCheck ready list tasks
GET/v1/app-data/google/app-list/:task_idGet list results
GET/v1/app-data/google/app-list/:task_id/htmlGet list results (HTML)
POST/v1/app-data/google/app-infoSubmit app info task
GET/v1/app-data/google/app-info/tasks-readyCheck ready info tasks
GET/v1/app-data/google/app-info/:task_idGet app info results
GET/v1/app-data/google/app-info/:task_id/htmlGet app info results (HTML)
POST/v1/app-data/google/app-reviewsSubmit app reviews task
GET/v1/app-data/google/app-reviews/tasks-readyCheck ready review tasks
GET/v1/app-data/google/app-reviews/:task_idGet review results
GET/v1/app-data/google/app-reviews/:task_id/htmlGet review results (HTML)
POST/v1/app-data/google/app-listingsSearch app listings (Live)
GET/v1/app-data/google/locationsAvailable locations
GET/v1/app-data/google/languagesAvailable languages
GET/v1/app-data/google/categoriesAvailable categories

​
App Store

MethodPathDescription
POST/v1/app-data/apple/app-searchesSubmit app search task
GET/v1/app-data/apple/app-searches/tasks-readyCheck ready search tasks
GET/v1/app-data/apple/app-searches/:task_idGet search results
POST/v1/app-data/apple/app-listSubmit top charts task
GET/v1/app-data/apple/app-list/tasks-readyCheck ready list tasks
GET/v1/app-data/apple/app-list/:task_idGet list results
POST/v1/app-data/apple/app-infoSubmit app info task
GET/v1/app-data/apple/app-info/tasks-readyCheck ready info tasks
GET/v1/app-data/apple/app-info/:task_idGet app info results
POST/v1/app-data/apple/app-reviewsSubmit app reviews task
GET/v1/app-data/apple/app-reviews/tasks-readyCheck ready review tasks
GET/v1/app-data/apple/app-reviews/:task_idGet review results
POST/v1/app-data/apple/app-listingsSearch app listings (Live)
GET/v1/app-data/apple/locationsAvailable locations
GET/v1/app-data/apple/languagesAvailable languages
GET/v1/app-data/apple/categoriesAvailable categories

​
Utility

MethodPathDescription
POST/v1/app-data/id-listList task IDs

​
Example (async flow)

# 1. Enqueue a Google Play search task
curl -X POST https://api.usenaive.ai/v1/app-data/google/app-searches \
  -H "Authorization: Bearer nv_sk_your_key" \
  -H "Content-Type: application/json" \
  -d '{ "keyword": "fitness tracker", "location_code": 2840, "language_code": "en" }'

# 2. Poll for ready tasks
curl https://api.usenaive.ai/v1/app-data/google/app-searches/tasks-ready \
  -H "Authorization: Bearer nv_sk_your_key"

# 3. Fetch results by task id
curl https://api.usenaive.ai/v1/app-data/google/app-searches/TASK_ID \
  -H "Authorization: Bearer nv_sk_your_key"