API reference · Runs

App teardown

The full read of one app: its reviews over a window read by a model (complaints, praise, requests, each with the fix it implies), ratings, versions and chart history. A teardown read in the last six hours is answered from it and costs nothing.

POST/api/v1/teardowns

Costs: 25 credits
MCP tool: start_teardown
Answers: A job, at once (202)

curl "https://appleak.app/api/v1/teardowns" \
  -H "Authorization: Bearer $APPLEAK_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "store": "apple",
    "appId": "1234567890",
    "days": 30
  }'

Response202 Accepted

{
  "id": "6f1c2b9e-1d0a-4c55-9a51-2b7f0c3e8d41",
  "object": "job",
  "kind": "teardown",
  "status": "queued",
  "credits": 25,
  "refunded": false,
  "progress": null,
  "createdAt": "2026-10-19T12:00:00.000Z",
  "startedAt": null,
  "finishedAt": null,
  "error": null,
  "result": null,
  "links": {
    "self": "/api/v1/jobs/6f1c2b9e-1d0a-4c55-9a51-2b7f0c3e8d41"
  }
}

#Parameters

Body parameters

store"apple" | "play"required
apple (App Store) or play (Google Play).
appIdstringrequired
The store id: digits for the App Store (e.g. 1234567890), the bundle id for Google Play (e.g. com.example.app). 1–200 characters
days7 | 30 | 90 | 3650optionaldefault 30
The window: 7, 30 or 90 days, or 3650 for all time.
refreshbooleanoptional
Read afresh even if a read from the last six hours is held. Costs the credits.
forcebooleanoptional
Start a new run even when the same one is already queued or running for you.

#Returns

A job, straight away, with status queued. Follow it with GET /jobs/{id} until it is done; the finished job carries the result.

MCP: start_teardown — Start an Appleak teardown of one app: its reviews read by a model into complaints, praise and feature requests with fixes, plus ratings and chart history. Free if read in the last six hours, else spends credits; returns a job id for get_job.