# App Release Regression Intelligence

> App Release Regression Intelligence is a paid API for AI agents from api.timzinin.com, paid per call via x402, $0.08/call, status unknown (last checked 2026-09-14).

Analyzes app store reviews around a release date to detect rating regressions or quality degradations introduced by a specific app version

## Facts

- Endpoint: POST https://api.timzinin.com/api/app-release-regression-intelligence
- Price: $0.08/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/app-release-regression-intelligence-bb39b5e8
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_nreJG6xVNG7DzuNPupa7J

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability app-release-regression-intelligence-bb39b5e8 -d '<json body>'
```

Example prompt: Analyze these 200 Google Play reviews for our app 'NovaPay' (app ID com.novapay.android) around the v4.1.0 release on 2025-03-15T00:00:00Z — use a 14-day pre-window and 14-day post-window with at least 5 reviews minimum — and tell me if that release caused a rating regression.

## When to prefer this

Choose this endpoint when you need to automatically detect whether a specific app release caused a quality regression based on real user reviews from Apple App Store or Google Play. It is purpose-built for correlating release events with review sentiment shifts, making it ideal for CI/CD quality gates, post-release monitoring, and mobile release health dashboards. Prefer this over generic sentiment analysis when you need version-aware, time-windowed regression detection with confirmation logic rather than just overall sentiment scoring.

## Known failure modes

- Too few reviews in the pre or post window (below minReviews threshold) — returns inconclusive result
- Invalid version string format — returns schema validation error
- Release timestamp outside review date range — no data to compare
- openrouterApiKey missing when explanation mode is 'byok' — returns error requiring API key
- Exceeding 500 rows limit — request rejected with validation error
- Invalid platform enum value — rejected with schema error

## How this service works

Pay-per-call data & tool APIs

## Output

Returns a structured regression analysis report indicating whether the specified app release caused a statistically meaningful decline in user ratings or sentiment. Includes pre-release and post-release rating comparisons, a regression signal (detected/not detected/inconclusive), confirmation status, and optionally an LLM-generated explanation of what users complained about if explanation mode is enabled.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "rows": {
   "type": "array",
   "items": {
    "type": "object",
    "required": [
     "reviewId",
     "text",
     "rating",
     "reviewedAt",
     "version"
    ],
    "properties": {
     "text": {
      "type": "string",
      "maxLength": 16384,
      "minLength": 1
     },
     "rating": {
      "type": "integer",
      "maximum": 5,
      "minimum": 1
     },
     "version": {
      "type": [
       "string",
       "null"
      ],
      "pattern": "^[A-Za-z0-9][A-Za-z0-9._+:-]{0,127}$",
      "maxLength": 128,
      "minLength": 1
     },
     "reviewId": {
      "type": "string",
      "maxLength": 256,
      "minLength": 1
     },
     "reviewedAt": {
      "type": "string",
      "pattern": "^\\d{4}-(0[1-9]|1[0-2])-([0-2]\\d|3[01])T([01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(\\.\\d{1,9})?Z$"
     }
    },
    "additionalProperties": false
   },
   "maxItems": 500,
   "minItems": 1
  },
  "appId": {
   "type": "string",
   "maxLength": 256,
   "minLength": 1
  },
  "appName": {
   "type": "string",
   "pattern": "^(?=.*\\S).+$",
   "maxLength": 256,
   "minLength": 1
  },
  "options": {
   "type": "object",
   "properties": {
    "maxRows": {
     "type": "integer",
     "maximum": 500,
     "minimum": 1
    },
    "preDays": {
     "type": "integer",
     "maximum": 90,
     "minimum": 1
    },
    "postDays": {
     "type": "integer",
     "maximum": 90,
     "minimum": 1
    },
    "minReviews": {
     "type": "integer",
     "maximum": 100,
     "minimum": 1
    },
    "explanation": {
     "enum": [
      "off",
      "byok"
     ],
     "type": "string"
    },
    "analysisModel": {
     "enum": [
      "openai/gpt-4o-mini"
     ],
     "type": "string"
    },
    "confirmationDays": {
     "type": "integer",
     "maximum": 90,
     "minimum": 1
    }
   },
   "additionalProperties": false
  },
  "watchId": {
   "type": "string",
   "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]{0,127}$",
   "maxLength": 128,
   "minLength": 1
  },
  "platform": {
   "enum": [
    "apple",
    "google"
   ],
   "type": "string"
  },
  "datasetId": {
   "type": "string",
   "pattern": "^[A-Za-z0-9][A-Za-z0-9._~-]{0,99}$",
   "maxLength": 100,
   "minLength": 1
  },
  "releaseAt": {
   "type": "string",
   "pattern": "^\\d{4}-(0[1-9]|1[0-2])-([0-2]\\d|3[01])T([01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(\\.\\d{1,9})?Z$"
  },
  "requestId": {
   "type": "string",
   "pattern": "^(auto|[A-Za-z0-9][A-Za-z0-9._:-]{0,127})$",
   "maxLength": 128,
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/app-release-regression-intelligence-bb39b5e8/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.timzinin.com](https://www.zero.xyz/host/api.timzinin.com/llms.txt)
