API Reference
Everything you need to integrate ASO Maniac into your workflow.
Base URL: https://api.asomaniac.comAuthentication
All API requests require authentication via an API key. Include your key in the Authorization header of every request.
Header Format
Authorization: Bearer <api_key>
Your API key starts with asm_live_ (production) or asm_test_ (sandbox). Get your key from the Dashboard Settings.
Rate Limits
Rate limit headers are included in every response: X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset.
| Plan | Requests | Burst |
|---|---|---|
| Free | 100/hour | 10/min |
| Pro | 1,000/hour | 100/min |
| Agency | 5,000/hour | 500/min |
| Enterprise | Unlimited | 1,000/min |
Example Request
curl -X POST https://api.asomaniac.com/v1/keywords/analyze \ -H "Authorization: Bearer asm_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \ -H "Content-Type: application/json" \ -d '{"keyword": "fitness tracker"}'Keywords
POST/api/v1/keywords/analyze
Analyze keyword popularity and competition for a given storefront.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| keyword | string | Required | The keyword to analyze |
| storefront | string | Optional | Two-letter country code (default: "us") |
| device | string | Optional | "iphone" or "ipad" (default: "iphone") |
Request Body
{ "keyword": "fitness tracker", "storefront": "us", "device": "iphone"}Request Example
curl -X POST https://api.asomaniac.com/v1/keywords/analyze \ -H "Authorization: Bearer asm_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \ -H "Content-Type: application/json" \ -d '{"keyword": "fitness tracker", "storefront": "us"}'Response
{ "keyword": "fitness tracker", "popularity": 62, "difficulty": 45, "competitorCount": 185, "topApps": [ { "name": "Fitbit", "rank": 1 } ]}POST/api/v1/keywords/batch
Analyze multiple keywords in a single request.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| keywords | string[] | Required | Array of keywords to analyze (max 50) |
| storefront | string | Optional | Two-letter country code (default: "us") |
Request Body
{ "keywords": ["fitness tracker", "step counter", "workout log"], "storefront": "us"}Request Example
curl -X POST https://api.asomaniac.com/v1/keywords/batch \ -H "Authorization: Bearer asm_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \ -H "Content-Type: application/json" \ -d '{"keywords": ["fitness tracker", "step counter"], "storefront": "us"}'Response
{ "results": [ { "keyword": "fitness tracker", "popularity": 62, "difficulty": 45 }, { "keyword": "step counter", "popularity": 48, "difficulty": 32 }, { "keyword": "workout log", "popularity": 35, "difficulty": 28 } ], "creditsUsed": 3}GET/api/v1/keywords/recommendations
Get AI-powered keyword recommendations based on your tracked app metadata.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| appId | string | Required | The tracked app ID |
| limit | number | Optional | Number of recommendations (default: 20, max: 100) |
Request Example
curl "https://api.asomaniac.com/v1/keywords/recommendations?appId=com.example.app&limit=20" \ -H "Authorization: Bearer asm_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"Response
{ "recommendations": [ { "keyword": "health monitor", "popularity": 55, "difficulty": 30, "relevance": 0.89, "reason": "Related to your tracked keywords" } ]}Apps
POST/api/v1/apps/track
Start tracking an app by its App Store or Play Store ID.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| appId | string | Required | The app bundle ID or package name |
| store | string | Required | "apple" or "google" |
| keywords | string[] | Optional | Initial keywords to track |
Request Body
{ "appId": "com.example.fitness", "store": "apple", "keywords": ["fitness tracker", "workout"]}Request Example
curl -X POST https://api.asomaniac.com/v1/apps/track \ -H "Authorization: Bearer asm_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \ -H "Content-Type: application/json" \ -d '{"appId": "com.example.fitness", "store": "apple"}'Response
{ "id": "app_abc123", "appId": "com.example.fitness", "name": "FitTracker Pro", "store": "apple", "trackedKeywords": ["fitness tracker", "workout"], "createdAt": "2026-03-21T10:00:00Z"}GET/api/v1/apps
List all tracked apps for your account.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| store | string | Optional | Filter by store: "apple" or "google" |
Request Example
curl "https://api.asomaniac.com/v1/apps?store=apple" \ -H "Authorization: Bearer asm_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"Response
{ "apps": [ { "id": "app_abc123", "appId": "com.example.fitness", "name": "FitTracker Pro", "store": "apple", "trackedKeywords": 12, "lastUpdated": "2026-03-21T10:00:00Z" } ], "total": 1}DELETE/api/v1/apps/:id
Remove a tracked app.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| id | string | Required | The tracked app ID |
Request Example
curl -X DELETE https://api.asomaniac.com/v1/apps/app_abc123 \ -H "Authorization: Bearer asm_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"Response
{ "deleted": true, "id": "app_abc123"}