API reference · Reviews

A pull’s counts

What a pull’s reviews add up to, counted and never inferred: the rating mix, the words and two-word phrases most reviews use (with how negative each is), storefronts, versions, apps, a weekly timeline, developer replies, and text posted more than once. Counted over the newest 8,000 reviews when a pull holds more; `sampled` says so.

GET/api/v1/reviews/pulls/{id}/insights

Costs: Free
MCP tool: get_pull_insights
Answers: At once (200)

curl "https://appleak.app/api/v1/reviews/pulls/0b8e2f4a-7c1d-4e9b-a2f3-5d6c7e8f9a01/insights" \
  -H "Authorization: Bearer $APPLEAK_KEY"

Response200 OK

{
  "pull": {
    "id": "0b8e2f4a-7c1d-4e9b-a2f3-5d6c7e8f9a01",
    "status": "completed"
  },
  "total": 312,
  "analysed": 312,
  "sampled": false,
  "avgRating": 1.6,
  "byRating": {
    "1": 201,
    "2": 111,
    "3": 0,
    "4": 0,
    "5": 0
  },
  "medianLength": 142,
  "terms": [
    {
      "term": "subscription",
      "reviews": 88,
      "share": 0.28,
      "avgRating": 1.4,
      "negativeShare": 1,
      "phrase": false
    }
  ],
  "countries": [
    {
      "key": "us",
      "label": "United States",
      "count": 312,
      "share": 1,
      "avgRating": 1.6
    }
  ],
  "versions": [],
  "apps": [],
  "timeline": [
    {
      "week": "2026-10-12",
      "count": 41,
      "avgRating": 1.5,
      "negative": 41
    }
  ],
  "replies": {
    "answered": 0,
    "playAnalysed": 0,
    "share": 0
  },
  "repeated": {
    "reviews": 4,
    "share": 0.01,
    "texts": [
      {
        "text": "Worst app ever",
        "count": 4,
        "authors": 4,
        "countries": [
          "us"
        ],
        "avgRating": 1
      }
    ]
  },
  "notTokenised": 0
}

#Parameters

Path parameters

iduuidrequired
The pull’s id: `result.pull.id` of a finished pull job, or an id from GET /reviews/pulls.

#Returns

The answer as JSON, beside. Free, and does not count against your credits.

MCP: get_pull_insights — Count an Appleak pull’s reviews: rating mix, the most used words and phrases with their share of negative reviews, storefronts, versions, apps, weekly volume, developer replies and repeated text. Counted, not generated. Free.