{"uid":"cap_nreJG6xVNG7DzuNPupa7J","slug":"app-release-regression-intelligence-bb39b5e8","name":"App Release Regression Intelligence","description":"Pay-per-call data & tool APIs","url":"https://api.timzinin.com/api/app-release-regression-intelligence","method":"POST","headers":{},"bodySchema":{"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,"minLength":1},"schemaVersion":{"enum":["1.0"],"type":"string"},"releaseVersion":{"type":["string","null"],"pattern":"^[A-Za-z0-9][A-Za-z0-9._+:-]{0,127}$","maxLength":128,"minLength":1},"openrouterApiKey":{"type":"string"},"maxTotalChargeUsd":{"type":"number","minimum":0}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.08","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.08/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.08","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.08","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_O7WC35TJF8bDf9kLLScnq","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.08","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Analyzes app store reviews around a release date to detect rating regressions or quality degradations introduced by a specific app version","exampleAgentPrompt":"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.","exampleUseCases":[{"title":"Post-launch regression alert for iOS app","prompt":"We shipped version 2.5.0 of our iOS app 'FitTrack' on 2025-04-01T00:00:00Z and I have 300 App Store reviews. Can you analyze them with a 21-day pre and post window to see if that release caused a meaningful drop in user ratings?"},{"title":"Google Play quality check after hotfix","prompt":"We pushed a hotfix (v1.9.3) to Google Play for 'Budgetly' on 2025-02-10T00:00:00Z — here are 150 reviews. Run a regression analysis with 7 pre-days and 7 post-days to tell me if user sentiment got worse after that fix went out."},{"title":"Automated release QA gate for CI pipeline","prompt":"After every production deploy of our Android app 'ShopEase' (com.shopease.app), I want to check 500 recent Google Play reviews around the release timestamp to detect any rating regression — use a 30-day pre-window, 14-day post-window, and require at least 10 reviews to confirm."}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:58:42.105Z","isFirstParty":false}