The List Apps endpoint (GET /api/v1/apps) supports 30+ filter parameters. This page provides a comprehensive reference for every filter, how it works internally, and practical tips for combining them.
Filter Summary
| Parameter | Type | Description |
|---|
search | string | Full-text search across title, developer, description |
categories | string | Comma-separated category names to include |
excludedCategories | string | Comma-separated category names to exclude |
priceType | enum | all, free, paid |
minPrice / maxPrice | number | Price range in USD (paid apps only) |
minRating / maxRating | number | Star rating range (0–5) |
minReviews / maxReviews | number | Total review count range |
minDownloads / maxDownloads | number | Estimated monthly downloads |
minRevenue / maxRevenue | number | Estimated monthly revenue (USD, last 30 days) |
minLifetimeDownloads / maxLifetimeDownloads | number | Estimated lifetime downloads |
minLifetimeRevenue / maxLifetimeRevenue | number | Estimated lifetime revenue (USD) |
growthPeriod | enum | Growth time window: 7d, 14d, 30d, 60d, 90d |
growthType | enum | all, positive, negative |
minGrowth / maxGrowth | number | Growth percentage range |
contentRating | enum | all, 4+, 9+, 12+, 17+ |
languages | string | Comma-separated ISO language codes |
developer | string | Exact developer name |
releasedAfter | number | Unix timestamp — apps released after this date |
updatedAfter | number | Unix timestamp — apps updated after this date |
hasWebsite | boolean | Has a developer website |
hasCreators | boolean | Has influencer/creator partnerships |
hasMetaAds | boolean | Running Meta (Facebook/Instagram) ads |
hasAppleAds | boolean | Running Apple Search Ads |
hasEmails | boolean | Has known contact emails |
Detailed Filter Guide
Full-Text Search
Searches across the app’s title, developer name, and description. The search is fuzzy and supports partial matches.
Combine search with category or revenue filters to narrow results. For example, searching “fitness” across all 2M+ apps is broad — adding categories=Health & Fitness and minRevenue=1000 targets high-revenue fitness apps specifically.
Category Filters
categories=Health+%26+Fitness,Lifestyle
excludedCategories=Games
categories — Comma-separated list of primary genre names to include. Uses IN matching.excludedCategories — Comma-separated list to exclude. Uses NOT IN matching.
Common category values include: Games, Business, Education, Entertainment, Finance, Food & Drink, Health & Fitness, Lifestyle, Medical, Music, Navigation, News, Photo & Video, Productivity, Reference, Shopping, Social Networking, Sports, Travel, Utilities, Weather.
Price Filters
priceType=paid&minPrice=0.99&maxPrice=9.99
| Parameter | Behavior |
|---|
priceType=all | No price filtering (default) |
priceType=free | Only free = true apps |
priceType=paid | Only free = false apps, optionally bounded by minPrice/maxPrice |
Rating & Review Filters
minRating=4.0&maxRating=5.0&minReviews=1000
minRating / maxRating — Filter on score (average star rating, 0–5). Use minRating=4 to find highly-rated apps.minReviews / maxReviews — Filter on total review count. Use minReviews=100 to exclude apps with too few reviews to be meaningful.
Download & Revenue Filters
minDownloads=5000&minRevenue=10000
minDownloads / maxDownloads — Estimated monthly download countminRevenue / maxRevenue — Estimated monthly revenue in USD
Lifetime metrics:
minLifetimeDownloads / maxLifetimeDownloads — Total estimated downloadsminLifetimeRevenue / maxLifetimeRevenue — Total estimated revenue in USD
Revenue and download estimates are modeled from public App Store signals including review velocity, pricing, and category benchmarks. They are directionally accurate but not exact.
Growth Filters
growthPeriod=30d&growthType=positive&minGrowth=50&sortBy=growth
| Parameter | Values | Default |
|---|
growthPeriod | 7d, 14d, 30d, 60d, 90d | 7d |
growthType | all, positive, negative | all |
minGrowth | Any number (percentage) | — |
maxGrowth | Any number (percentage) | — |
growthPeriod=30d&growthType=positive&minGrowth=100 finds apps that doubled their review count in the last 30 days.
When sortBy=growth, results are sorted by the growth field matching your growthPeriod.
Content Rating Filter
Filters by App Store age rating: all (default), 4+, 9+, 12+, 17+.
Language Filter
Comma-separated ISO language codes. Returns apps that support any of the listed languages (OR logic within this filter).
Developer Filter
Exact match on the developer name. Useful for finding all apps by a specific company.
Date Filters
releasedAfter=1704067200
updatedAfter=1704067200
releasedAfter — Only apps originally released on or after this dateupdatedAfter — Only apps last updated on the App Store on or after this date
To find apps released in 2024: releasedAfter=1704067200 (Jan 1 2024 UTC). Use an epoch converter to get the timestamp.
Feature / Boolean Filters
hasMetaAds=true&hasEmails=true
| Parameter | true | false |
|---|
hasWebsite | Has a developer website | No developer website |
hasCreators | Has influencer/creator partnerships (TopYappers data) | No known creators |
hasMetaAds | Running Meta (Facebook/Instagram) ad campaigns | No known Meta ads |
hasAppleAds | Running Apple Search Ads | No known Apple ads |
hasEmails | Has known contact email addresses | No known emails |
Combining Filters — Examples
High-revenue free apps with strong growth
priceType=free&minRevenue=50000&growthPeriod=30d&growthType=positive&sortBy=revenue&sortOrder=desc
Recently released apps in Education
categories=Education&releasedAfter=1704067200&sortBy=released&sortOrder=desc
hasMetaAds=true&hasAppleAds=true&sortBy=downloads&sortOrder=desc
Paid productivity apps with high ratings
categories=Productivity&priceType=paid&minRating=4.5&minReviews=500&sortBy=revenue&sortOrder=desc
