Skip to main content
This page documents every enum and constant value accepted by the API.

​
SortBy

Controls the sort field on the List Apps endpoint.
ValueDescription
growthSort by review growth percentage for the selected growthPeriod. Default.
ratingSort by average star rating (score).
reviewsSort by total review count.
downloadsSort by estimated monthly downloads.
revenueSort by estimated monthly revenue (last 30 days).
updatedSort by the date the record was last updated in our database.
app_updatedSort by the app’s last App Store update date.
releasedSort by original App Store release date.
trendingSort by trending score (composite of recent growth metrics).
newestSort by newest additions to the database.

​
SortOrder

ValueDescription
ascAscending (smallest/oldest first).
descDescending (largest/newest first). Default.

​
GrowthPeriod

Controls the time window for growth calculations. Used with the growthPeriod parameter.
ValueDescription
7d7-day growth window. Default.
14d14-day growth window.
30d30-day growth window.
60d60-day growth window.
90d90-day growth window.
Growth is calculated as a percentage change in the review count over the specified period. For example, a growth_7d value of 25 means the app gained 25% more reviews in the last 7 days compared to the prior 7 days.

​
GrowthType

Filters apps by the direction of their growth.
ValueDescription
allInclude all apps regardless of growth direction. Default.
positiveOnly apps with positive growth (gaining momentum).
negativeOnly apps with negative growth (declining).

​
PriceType

ValueDescription
allInclude both free and paid apps. Default.
freeOnly free apps.
paidOnly paid apps. Can combine with minPrice / maxPrice.

​
ContentRating

App Store age rating classification.
ValueDescription
allInclude all content ratings. Default.
4+Suitable for ages 4 and up. No objectionable content.
9+Suitable for ages 9 and up. May contain mild or infrequent cartoon violence.
12+Suitable for ages 12 and up. May contain infrequent mild language, simulated gambling.
17+Restricted to ages 17 and up. May contain frequent mature/suggestive themes.

​
GrowthMetric

The metric used for growth tracking on the dashboard (used internally, included for completeness).
ValueDescription
reviewsTrack review count growth. Default.
downloadsTrack download growth.
revenueTrack revenue growth.

​
Meta Ad Type

Type of creative asset in a Meta (Facebook/Instagram) ad.
ValueDescription
imageStatic image creative.
videoVideo creative (includes poster URL for thumbnail).

​
Apple Ad Placement

Placement types for Apple Search Ads.
ValueDescription
SEARCH_RESULTSAd shown in App Store search results.
SEARCH_TABAd shown on the App Store Search tab.
TODAY_TABAd shown on the App Store Today tab.
PRODUCT_PAGEAd shown on another app’s product page.

​
API Credit Costs

ConstantValueDescription
APPS_LIST_PER_HIT1Credits per app returned by GET /api/v1/apps.
APP_DETAIL1Credits per GET /api/v1/apps/:appId call.
KEYWORD_DIFFICULTY10Credits per GET /api/v1/keywords/difficulty call.
KEYWORD_DIFFICULTY_BATCH_PER_KEYWORD10Credits per keyword in POST /api/v1/keywords/difficulty.