Skip to main content
GET
/
api
/
v1
/
apps
List Apps
curl --request GET \
  --url https://api.example.com/api/v1/apps
{
  "data": [
    {
      "app_slug": "<string>",
      "icon": "<string>",
      "title": "<string>",
      "developer": "<string>",
      "primary_genre": "<string>",
      "score": 123,
      "reviews": 123,
      "url": "<string>",
      "downloads": 123,
      "historical_counts.revenue_last_30d": 123,
      "historical_counts.reviews_growth_7d": 123,
      "app_released_date_timestamp": 123,
      "app_updated_date_timestamp": 123
    }
  ],
  "pagination": {
    "nextCursor": {},
    "totalCount": 123
  }
}
Search and filter across 2M+ iOS apps with powerful query parameters. Returns paginated results with estimated downloads, revenue, growth metrics, and more. Credits: 1 per app returned in the response.

​
Query Parameters

​
Pagination

​
limit
number
default:"50"
Number of apps to return. Min: 1, Max: 100.
​
cursor
number
Offset for pagination. Use the nextCursor value from the previous response.
​
search
string
Full-text search query. Matches against app title, developer, and description.

​
Categories

​
categories
string
Comma-separated list of category names to include. Example: Health & Fitness,Lifestyle.
​
excludedCategories
string
Comma-separated list of category names to exclude. Example: Games,Entertainment.

​
Sorting

​
sortBy
string
default:"growth"
Field to sort by. One of: growth, rating, reviews, updated, released, app_updated, downloads, revenue, trending, newest.See Enums → SortBy for details.
​
sortOrder
string
default:"desc"
Sort direction. asc or desc.

​
Price Filters

​
priceType
string
default:"all"
Filter by pricing model. all, free, or paid.
​
minPrice
number
Minimum price in USD (only applies when priceType=paid).
​
maxPrice
number
Maximum price in USD (only applies when priceType=paid).

​
Rating Filters

​
minRating
number
Minimum star rating. Range: 0 to 5.
​
maxRating
number
Maximum star rating. Range: 0 to 5.

​
Reviews Filters

​
minReviews
number
Minimum total review count.
​
maxReviews
number
Maximum total review count.

​
Downloads Filters

​
minDownloads
number
Minimum estimated monthly downloads.
​
maxDownloads
number
Maximum estimated monthly downloads.
​
minLifetimeDownloads
number
Minimum estimated lifetime downloads.
​
maxLifetimeDownloads
number
Maximum estimated lifetime downloads.

​
Revenue Filters

​
minRevenue
number
Minimum estimated monthly revenue (USD).
​
maxRevenue
number
Maximum estimated monthly revenue (USD).
​
minLifetimeRevenue
number
Minimum estimated lifetime revenue (USD).
​
maxLifetimeRevenue
number
Maximum estimated lifetime revenue (USD).

​
Growth Filters

​
growthPeriod
string
default:"7d"
Time window for growth calculation. One of: 7d, 14d, 30d, 60d, 90d.
​
growthType
string
default:"all"
Filter by growth direction. all, positive, or negative.
​
minGrowth
number
Minimum growth percentage for the selected period.
​
maxGrowth
number
Maximum growth percentage for the selected period.

​
Content & Language

​
contentRating
string
default:"all"
Content rating filter. One of: all, 4+, 9+, 12+, 17+.
​
languages
string
Comma-separated ISO language codes. Example: EN,DE,FR.

​
Developer

​
developer
string
Exact developer name to filter by.

​
Date Filters

​
releasedAfter
number
Unix timestamp (seconds). Only return apps released after this date.
​
updatedAfter
number
Unix timestamp (seconds). Only return apps updated after this date.

​
Feature Filters

​
hasWebsite
boolean
Filter apps that have (or don’t have) a developer website. true or false.
​
hasCreators
boolean
Filter apps with known influencer/creator partnerships.
​
hasMetaAds
boolean
Filter apps running Meta (Facebook/Instagram) ads.
​
hasAppleAds
boolean
Filter apps running Apple Search Ads.
​
hasEmails
boolean
Filter apps with known contact email addresses.

​
Response

​
data
array
Array of app objects.
​
pagination
object

​
Examples

​
Search for fitness apps with high revenue

curl -X GET "https://appkittie.com/api/v1/apps?search=fitness&categories=Health+%26+Fitness&minRevenue=10000&sortBy=revenue&sortOrder=desc&limit=10" \
  -H "Authorization: Bearer YOUR_API_KEY"

​
Find free apps with strong 30-day growth

curl -X GET "https://appkittie.com/api/v1/apps?priceType=free&growthPeriod=30d&growthType=positive&minGrowth=50&sortBy=growth&limit=20" \
  -H "Authorization: Bearer YOUR_API_KEY"

​
Find apps running Meta ads with creator partnerships

curl -X GET "https://appkittie.com/api/v1/apps?hasMetaAds=true&hasCreators=true&sortBy=downloads&sortOrder=desc&limit=25" \
  -H "Authorization: Bearer YOUR_API_KEY"

​
Paginate through results

# Page 1
curl -X GET "https://appkittie.com/api/v1/apps?categories=Games&limit=50" \
  -H "Authorization: Bearer YOUR_API_KEY"

# Page 2 (use nextCursor from previous response)
curl -X GET "https://appkittie.com/api/v1/apps?categories=Games&limit=50&cursor=50" \
  -H "Authorization: Bearer YOUR_API_KEY"