Skip to main content
GET /v1/aso/audit/:appId
Run a comprehensive ASO (App Store Optimization) health audit on any iOS app. Returns an overall ASO score (0-100), a 9-factor breakdown, prioritized recommendations, and keyword coverage stats. Think of it as a full SEO audit but for the App Store.

Path Parameters

NameTypeRequiredDescription
appIdstringYesApple App ID (numeric, e.g. 913335252)

Query Parameters

NameTypeDefaultDescription
countrystringusISO country code (e.g. us, gb, de)

Code Examples

curl -X GET "https://api.appeeky.com/v1/aso/audit/913335252?country=us" \
  -H "X-API-Key: YOUR_API_KEY"

Response

{
  "data": {
    "appId": "913335252",
    "country": "us",
    "app": {
      "title": "Brilliant: Learn by doing",
      "developer": "Brilliant.org",
      "icon": "https://is1-ssl.mzstatic.com/.../512x512bb.jpg",
      "rating": 4.74,
      "reviews": 27315,
      "category": "Education",
      "price": 0,
      "lastUpdated": "2026-01-26T12:19:36Z",
      "description": "Master concepts in math, data science, and computer science through fun...",
      "screenshotCount": 6,
      "languageCount": 1
    },
    "asoScore": 72,
    "gradeLabel": "Average",
    "scoreBreakdown": {
      "titleScore": 85,
      "subtitleScore": 70,
      "descriptionScore": 75,
      "ratingScore": 90,
      "reviewsScore": 60,
      "keywordCoverageScore": 55,
      "visualAssetsScore": 75,
      "localizationScore": 20,
      "updateFrequencyScore": 80
    },
    "recommendations": [
      {
        "priority": "high",
        "category": "Keywords",
        "issue": "Only ranking for 8 keywords with limited top-10 positions",
        "suggestion": "Research and target 15-25 keywords mixing high-volume (competitive) and long-tail (easier to rank) terms. Update keyword field regularly."
      },
      {
        "priority": "medium",
        "category": "Reviews",
        "issue": "Only 27,315 reviews - need more social proof",
        "suggestion": "Use Apple's SKStoreReviewController to prompt reviews at strategic moments. Respond to existing reviews to boost engagement."
      },
      {
        "priority": "low",
        "category": "Localization",
        "issue": "Only 1 languages supported",
        "suggestion": "Localize metadata (title, subtitle, keywords, description) for top markets: Spanish, German, French, Japanese, Chinese, Portuguese, Korean."
      }
    ],
    "keywords": {
      "tracked": 8,
      "top10Count": 2,
      "top30Count": 5,
      "avgRank": 18,
      "bestKeyword": { "keyword": "learn math", "rank": 3 }
    },
    "metadata": {
      "titleLength": 25,
      "titleMaxChars": 30,
      "titleHasKeyword": true,
      "descriptionLength": 1250,
      "descriptionWordCount": 210
    }
  }
}

ASO Score Breakdown

The overall score is a weighted average of 9 factors:
FactorWeightWhat it measures
titleScore15%Title length, keyword inclusion, formatting
subtitleScore5%Subtitle presence and keyword usage
descriptionScore10%Length, formatting (bullets/paragraphs), readability
ratingScore15%Star rating vs competitive thresholds
reviewsScore15%Review count relative to category benchmarks
keywordCoverageScore20%Keywords tracked, top-10 and top-30 positions
visualAssetsScore8%Screenshot count (target: 8+)
localizationScore5%Number of supported languages
updateFrequencyScore7%Days since last update

Grade Labels

Score RangeGrade
90-100Excellent
75-89Good
60-74Average
40-59Needs Work
0-39Poor

Recommendation Fields

FieldTypeDescription
prioritystring"high", "medium", or "low"
categorystringArea of improvement (Title, Description, Rating, etc.)
issuestringWhat’s wrong — specific to the app
suggestionstringActionable fix with best practices

Use the ASO audit as a starting point, then drill deeper with:

Errors

StatusCodeWhen
400INVALID_APP_IDNon-numeric or missing app ID
401MISSING_API_KEYNo API key in the request
404APP_NOT_FOUNDApp not found or unavailable