{"name":"App Store Intelligence API","version":"1.0","docs":"/v1","links":{"MCP":"https://docs.appeeky.com/docs/mcp","ASO agent skills":"https://github.com/Eronred/aso-skills"},"auth":{"dashboard":"https://dashboard.appeeky.com","usage":"GET /v1/auth/usage (requires API key)"},"endpoints":{"health":"GET /v1/health","version":"GET /v1/version","app":"GET /v1/apps/:id?country=us&device=iphone","appIntelligence":"GET /v1/apps/:id/intelligence?country=us","countryRankings":"GET /v1/apps/:id/country-rankings?chart=top-free","appKeywords":"GET /v1/apps/:id/keywords?country=us","appReviews":"GET /v1/apps/:id/reviews?country=us&page=1&sortBy=mostRecent","search":"GET /v1/search?q=...&country=us&limit=20","keywordRanks":"GET /v1/keywords/ranks?keyword=...&country=us&date=YYYY-MM-DD","trackKeyword":"POST /v1/keywords/track { keyword }","categories":"GET /v1/categories","categoryTop":"GET /v1/categories/:genreId/top?country=us&chart=top-free&limit=25","asoAudit":"GET /v1/aso/audit/:appId?country=us","asoValidateMetadata":"POST /v1/aso/metadata/validate { platform, title, subtitle, keywords }","asoSuggestMetadata":"POST /v1/aso/metadata/suggest { appId, keywords[], country }","asoOpportunities":"GET /v1/aso/opportunities/:appId?country=us","asoCompetitorReport":"GET /v1/aso/competitor/:appId/:competitorId?country=us","marketMovers":"GET /v1/market/movers?country=us&chart=top-free&genre=all&limit=10","marketActivity":"GET /v1/market/activity?country=us&chart=top-free&genre=all&limit=25","appScreenshots":"GET /v1/apps/:id/screenshots?country=us&device=all","competitorScreenshots":"GET /v1/apps/:id/screenshots/competitors?country=us&limit=5","categoryScreenshots":"GET /v1/categories/:genreId/top/screenshots?country=us&chart=top-free&limit=10","aiVisibilityOverview":"GET /v1/ai-visibility/:appId/overview?country=us&model=chatgpt","aiVisibilityIntents":"GET /v1/ai-visibility/:appId/intents?country=us&model=chatgpt","aiVisibilityIntentDetail":"GET /v1/ai-visibility/:appId/intents/:intentId?country=us&model=chatgpt","aiVisibilityCompetitors":"GET /v1/ai-visibility/:appId/competitors?country=us&model=chatgpt&windowDays=14","aiVisibilityAnswerDetail":"GET /v1/ai-visibility/:appId/answers/:answerId","aiVisibilityBootstrap":"POST /v1/ai-visibility/:appId/bootstrap { country, language }","aiVisibilityScan":"POST /v1/ai-visibility/:appId/scan","aiVisibilitySettings":"GET|PUT /v1/ai-visibility/:appId/settings","aiVisibilityIntentCrud":"POST|PATCH|DELETE /v1/ai-visibility/:appId/intents[/:intentId]","aiVisibilityPromptCrud":"POST|PATCH|DELETE /v1/ai-visibility/:appId/{intents/:intentId/prompts|prompts/:promptId}","growthChannels":"GET /v1/growth/channels","growthProjects":"GET|POST /v1/growth/projects","growthProjectBootstrap":"POST /v1/growth/projects/bootstrap { channel, appId? }","growthProjectScan":"POST /v1/growth/projects/:id/scan","growthProjectStats":"GET /v1/growth/projects/:id/stats?days=30","growthOpportunities":"GET /v1/growth/opportunities?status=pending&urgency=must_reply","growthOpportunityReview":"PATCH /v1/growth/opportunities/:id/review { decision }","growthOpportunityMarkReplied":"POST /v1/growth/opportunities/:id/mark-replied { replyUrl }","rankChangeEvents":"GET /v1/internal/rank-changes?since=ISO[&app_ids=a,b][&country=us][&device=iphone][&change_types=moved,entered_top,fell_out][&limit=500]","sendEmailInternal":"POST /v1/internal/send-email { to, subject, html?, text?, replyTo?, fromName? }","alertsTelegramPairing":"POST /v1/internal/alerts/telegram/start-link { email } | GET /v1/internal/alerts/telegram/paired?email=… | DELETE /v1/internal/alerts/telegram/pairings { email, chatId }","alertsTelegramWebhook":"POST /v1/webhooks/alerts/telegram  (public — Telegram only; verified by X-Telegram-Bot-Api-Secret-Token)"},"note":"All endpoints except /health require an API key via X-API-Key header. Get your key at https://dashboard.appeeky.com"}