Access the ASO analysis reports saved in your appeeky.com account. Reports are generated by tools such as ASO Audit, Competitor Report, and Metadata Suggestions and stored so you can retrieve them later.
All Report endpoints cost 0 credits and require the apps:read scope for reads and apps:write for deletes.
List Reports
Returns all saved reports for your account, ordered most recently created first.
Query Parameters:
| Name | Type | Default | Description |
|---|
appId | number | — | Filter by a specific App Store ID |
type | string | — | Filter by report type (e.g. aso_audit, competitor, metadata_suggestions) |
limit | number | 20 | Max number of results to return (max 100) |
offset | number | 0 | Pagination offset |
curl "https://api.appeeky.com/v1/user/reports?appId=6443843426&limit=10" \
-H "X-API-Key: YOUR_API_KEY"
Response (200 OK):
{
"data": [
{
"id": "d9f3a122-...",
"app_id": 6443843426,
"report_type": "aso_audit",
"title": "ASO Audit — Appeeky",
"summary": "Overall score: 82/100. Title length optimal. Keyword density low.",
"created_at": "2026-03-19T15:47:06.270736+00:00"
}
]
}
Get a Report
GET /v1/user/reports/:reportId
Retrieve the full content of a single saved report.
Path Parameters:
| Name | Type | Description |
|---|
reportId | string | UUID of the report |
curl "https://api.appeeky.com/v1/user/reports/d9f3a122-..." \
-H "X-API-Key: YOUR_API_KEY"
Response (200 OK):
{
"data": {
"id": "d9f3a122-...",
"app_id": 6443843426,
"report_type": "aso_audit",
"title": "ASO Audit — Appeeky",
"summary": "Overall score: 82/100. Title length optimal. Keyword density low.",
"content": {
"score": 82,
"sections": [
{ "name": "Title", "score": 95, "feedback": "Title is within the 30-character limit." },
{ "name": "Keywords", "score": 68, "feedback": "Keyword field is underutilized." }
]
},
"created_at": "2026-03-19T15:47:06.270736+00:00"
}
}
Delete a Report
DELETE /v1/user/reports/:reportId
Permanently delete a saved report from your account.
Path Parameters:
| Name | Type | Description |
|---|
reportId | string | UUID of the report to delete |
curl -X DELETE "https://api.appeeky.com/v1/user/reports/d9f3a122-..." \
-H "X-API-Key: YOUR_API_KEY"
Response (200 OK):
{ "data": { "success": true } }
Errors
| Status | Code | When |
|---|
| 403 | FORBIDDEN | Key scope does not allow this operation |
| 404 | USER_NOT_FOUND | No appeeky.com account linked to this key |
| 404 | NOT_FOUND | Report not found or doesn’t belong to your account |