Revunda: app review complaints

Top complaint themes in an app's low-star reviews, with real counts and shares from Revunda's studies, plus a link to the app's Revunda page. Pass an app name (e.g. 'AccuWeather'), an App Store URL or numeric id, a Google Play URL or package name (e.g. 'com.commbank.netbank'), or a Shopify App Store URL or handle (e.g. 'judgeme'). If the app is not covered, returns covered:false and a link to Revunda's free check for any app.

{
  "type": "object",
  "properties": {
    "app": {
      "type": "string",
      "description": "App name, store URL, App Store numeric id, Google Play package name or Shopify app handle."
    },
    "store": {
      "type": "string",
      "enum": [
        "any",
        "ios",
        "play",
        "shopify"
      ],
      "description": "Optional store filter. Default 'any'."
    }
  },
  "required": [
    "app"
  ],
  "additionalProperties": false
}

List or search the apps that have complaint data in Revunda's studies. Filter by store, by sector/category (e.g. 'Banks & payments', 'Product reviews') or by a name search. Returns name, store, sample size, top complaint and link.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Optional name search, e.g. 'bank' or 'uber'."
    },
    "store": {
      "type": "string",
      "enum": [
        "any",
        "ios",
        "play",
        "shopify"
      ],
      "description": "Optional store filter. Default 'any'."
    },
    "sector": {
      "type": "string",
      "description": "Optional sector or Shopify category, case-insensitive substring match."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100,
      "description": "Max results, default 25."
    }
  },
  "additionalProperties": false
}

How often a complaint theme appears in 1-star reviews overall and by sector, and which apps get it most. App stores themes: login (Login & account access), crash (Crashes & won’t open), slow (Slow, loading & lag), update (Broke after an update), support (Customer service), billing (Charges, fees & refunds), payment (Payment or checkout fails), ux (Redesign & confusing UI), ads (Ads), notif (Notifications & alerts). Shopify App Store themes (market='shopify'): support (Slow or no support), bugs (Bugs & broke the store), billing (Charges & refunds), after_uninstall (Charged after uninstalling/cancelling), price_change (Price increases & plan changes), missing (Missing features & limits), slow (Slow store & app speed), leftover (Code left after uninstall), scam (Called it a scam or misleading), expensive (Too expensive for what it does), hard (Hard to use or set up), lockin (Export, import & migration pain), sync (Sync, orders & inventory errors). Omit theme to get the ranking of all themes.

{
  "type": "object",
  "properties": {
    "theme": {
      "type": "string",
      "description": "Theme key or words, e.g. 'login', 'ads', 'refund', 'crash'. Optional."
    },
    "market": {
      "type": "string",
      "enum": [
        "app_stores",
        "shopify"
      ],
      "description": "'app_stores' (App Store + Google Play, default) or 'shopify'."
    }
  },
  "additionalProperties": false
}

Same maths as Revunda's 1-star review cost calculator: estimated 1-star reviews per month by complaint theme (sector shares from the 29,785-review study), money exposure if you give a cost per 1-star, 5-star ratings that offset one 1-star, and 5-star ratings needed to reach a target rating. Sectors: parcels, telecom, taxi, energy, news, betting, travel, streaming, insurance, smarthome, banks, shopping, food, health, other.

{
  "type": "object",
  "properties": {
    "reviews_per_month": {
      "type": "number",
      "minimum": 0,
      "description": "Total new reviews per month (all star ratings)."
    },
    "one_star_share_pct": {
      "type": "number",
      "minimum": 0,
      "maximum": 100,
      "description": "Optional: your own % of reviews that are 1-star. If omitted, the sector average is used."
    },
    "sector": {
      "type": "string",
      "enum": [
        "parcels",
        "telecom",
        "taxi",
        "energy",
        "news",
        "betting",
        "travel",
        "streaming",
        "insurance",
        "smarthome",
        "banks",
        "shopping",
        "food",
        "health",
        "other"
      ],
      "description": "Optional sector key for theme shares and the default 1-star share."
    },
    "rating": {
      "type": "number",
      "minimum": 1,
      "maximum": 5,
      "description": "Optional current average rating."
    },
    "ratings_count": {
      "type": "integer",
      "minimum": 0,
      "description": "Optional current number of ratings."
    },
    "target_rating": {
      "type": "number",
      "minimum": 1,
      "maximum": 5,
      "description": "Optional target average rating."
    },
    "cost_per_one_star": {
      "type": "number",
      "minimum": 0,
      "description": "Optional: your own estimate of what one 1-star review costs you, any currency."
    }
  },
  "additionalProperties": false
}