Skip to main content
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

GET /v1/user/reports
Returns all saved reports for your account, ordered most recently created first. Query Parameters:
NameTypeDefaultDescription
appIdnumberFilter by a specific App Store ID
typestringFilter by report type (e.g. aso_audit, competitor, metadata_suggestions)
limitnumber20Max number of results to return (max 100)
offsetnumber0Pagination 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:
NameTypeDescription
reportIdstringUUID 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:
NameTypeDescription
reportIdstringUUID 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

StatusCodeWhen
403FORBIDDENKey scope does not allow this operation
404USER_NOT_FOUNDNo appeeky.com account linked to this key
404NOT_FOUNDReport not found or doesn’t belong to your account