API reference · Runs

Research

Ask about one app (and up to two more to compare): its reviews, revenue, ads and social reach, read and answered in about a minute. With no app, a growth question ("organic, UGC or ads first?") is answered from the playbook, Ad Search, UGC videos and Influencer Search.

POST/api/v1/research

Costs: 1 credit
MCP tool: start_research
Answers: A job, at once (202)

curl "https://appleak.app/api/v1/research" \
  -H "Authorization: Bearer $APPLEAK_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "question": "why are people cancelling their subscription?",
    "app": {
      "store": "apple",
      "appId": "1234567890"
    }
  }'

Response202 Accepted

{
  "id": "6f1c2b9e-1d0a-4c55-9a51-2b7f0c3e8d41",
  "object": "job",
  "kind": "research",
  "status": "queued",
  "credits": 1,
  "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

questionstringrequired
3–600 characters
app{ store, appId }optional
The app the question is about. Leave out for a growth question with no app.
compare{ store, appId }[]optional
Up to two more apps, compared with the first. 0–2 items
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_research — Start Appleak research on one mobile app (optionally compared with up to two others): reviews, revenue, ads and social reach, answered in writing. With no app, answers a growth-strategy question. Spends credits; returns a job id for get_job.