Reports

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:

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"

const res = await fetch(
  "https://api.appeeky.com/v1/user/reports?appId=6443843426&limit=10",
  { headers: { "X-API-Key": "YOUR_API_KEY" } }
);
const { data } = await res.json();

import requests

res = requests.get(
    "https://api.appeeky.com/v1/user/reports",
    params={"appId": 6443843426, "limit": 10},
    headers={"X-API-Key": "YOUR_API_KEY"},
)
data = res.json()["data"]

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"

const res = await fetch(
  "https://api.appeeky.com/v1/user/reports/d9f3a122-...",
  { headers: { "X-API-Key": "YOUR_API_KEY" } }
);
const { data } = await res.json();

import requests

res = requests.get(
    "https://api.appeeky.com/v1/user/reports/d9f3a122-...",
    headers={"X-API-Key": "YOUR_API_KEY"},
)
data = res.json()["data"]

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"

const res = await fetch(
  "https://api.appeeky.com/v1/user/reports/d9f3a122-...",
  { method: "DELETE", headers: { "X-API-Key": "YOUR_API_KEY" } }
);

import requests

requests.delete(
    "https://api.appeeky.com/v1/user/reports/d9f3a122-...",
    headers={"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

Getting Started

Apps

My Data - Appeeky Web

Keywords

ASO Tools

AI Visibility

Search & Discovery

Market Intelligence

RevenueCat

App Store Connect

Google Play Console

Apple Search Ads

Growth Channels

Reference

List Reports

Get a Report

Delete a Report

Errors

​List Reports

​Get a Report

​Delete a Report

​Errors

List Reports

Get a Report

Delete a Report

Errors