POST /v1/aso/metadata/suggest
Request Body
| Field | Type | Required | Default | Description |
|---|
| appId | string | Yes | — | Apple App ID (numeric) |
| keywords | string[] | Yes | — | Target keywords to optimize for (2-10 recommended) |
| country | string | No | us | ISO country code |
Code Examples
curl -X POST "https://api.appeeky.com/v1/aso/metadata/suggest" \
-H "X-API-Key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"appId": "913335252",
"keywords": ["learn math", "science education", "puzzle solving", "brain training"],
"country": "us"
}'
Response
{
"data": {
"apple": {
"title": {
"text": "Brilliant: Learn Math",
"charCount": 21,
"maxChars": 30
},
"subtitle": {
"text": "Science Education & Puzzles",
"charCount": 27,
"maxChars": 30
},
"keywords": {
"text": "training,brain,solving,puzzle,education,science,interactive,quiz,study",
"charCount": 69,
"maxChars": 100,
"keywordCount": 9
}
},
"google": {
"title": {
"text": "Brilliant - Learn Math & Science Education",
"charCount": 43,
"maxChars": 50
},
"shortDescription": {
"text": "Brilliant helps you with learn math and science education. Download now!",
"charCount": 71,
"maxChars": 80
}
},
"targetKeywords": [
{ "keyword": "learn math", "volumeScore": 62, "difficulty": 45 },
{ "keyword": "brain training", "volumeScore": 55, "difficulty": 52 },
{ "keyword": "science education", "volumeScore": 38, "difficulty": 30 },
{ "keyword": "puzzle solving", "volumeScore": 28, "difficulty": 35 }
]
}
}
Response Fields
| Field | Type | Description |
|---|
| apple.title.text | string | Suggested title (max 30 chars) |
| apple.title.charCount | number | Character count |
| apple.subtitle.text | string | Suggested subtitle (max 30 chars) |
| apple.keywords.text | string | Comma-separated keyword field (max 100 chars) |
| apple.keywords.keywordCount | number | Number of keywords in the field |
| Field | Type | Description |
|---|
| google.title.text | string | Suggested title (max 50 chars) |
| google.shortDescription.text | string | Suggested short description (max 80 chars) |
Target Keywords
| Field | Type | Description |
|---|
| keyword | string | The target keyword |
| volumeScore | number | Search volume score (0-100) |
| difficulty | number | Ranking difficulty score (0-100) |
How suggestions are generated:
- Keywords are sorted by volume score (highest first) for prioritization
- The top keyword goes into the title with the brand name
- The 2nd-3rd keywords form the subtitle
- The keyword field excludes words already in the title (Apple’s guideline: don’t repeat title words in keywords)
- All suggestions are character-validated before being returned
These are algorithmic suggestions based on keyword data. Always review and refine them for natural language and brand voice before submitting to the store. The best metadata reads naturally to humans while incorporating high-value keywords.
Errors
| Status | Code | When |
|---|
| 400 | INVALID_APP_ID | Non-numeric or missing appId |
| 400 | INVALID_KEYWORDS | keywords is missing or empty |
| 401 | MISSING_API_KEY | No API key in the request |
| 404 | APP_NOT_FOUND | App not found or unavailable |
