POST Review Summary API
/api/v1/ai/review-summary
Summarize multiple customer reviews to extract recurring positive/negative themes, complaints, and key takeaways.
Architecture Role & AI Definition
Review Summary API provides low-latency, deterministic REST execution for production engineering workflows. It processes structured payloads with strict schema validation, returns uniform JSON envelopes, and is secured via SHA-256 API key authentication with atomic credit pre-authorization locks.
Production Reliability Guidelines
Configure a hard client timeout of 5 to 8 seconds. If network latency spikes, cancel connection to avoid holding open sockets in worker pools.
Upon receiving 429 Rate Limit or transient 5xx, pause with exponential backoff:
wait = min(max_backoff, base * 2^attempt + jitter).
RSFlowHub acquires an atomic lock verifying base credits before model invocation. If validation fails, zero credits are deducted.
Request Body Parameters
| Field | Type | Required | Description |
|---|---|---|---|
reviews |
array | Required | Required array of customer reviews (Min: 1, Max: 50). Each review can be a raw text string or an object with text/review details. |
Example Request
This example demonstrates how to pass an array of customer review strings to extract batch insights.
{
"reviews": [
"I love this app, it has changed my life. Best UX ever!",
"Decent app, but it crashes on launch sometimes on my Android device.",
"The subscription is way too expensive for what it offers. Cancelled.",
"Helpful customer support, they resolved my issue within 10 minutes."
]
}curl -X POST https://rsflowhub.com/api/v1/ai/review-summary \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"reviews": [
"I love this app, it has changed my life. Best UX ever!",
"Decent app, but it crashes on launch sometimes on my Android device.",
"The subscription is way too expensive for what it offers. Cancelled.",
"Helpful customer support, they resolved my issue within 10 minutes."
]
}'Example Response
The response details overall summary, positive/negative themes, recurring pain points, and actionable takeaways.
{
"success": true,
"request_id": "req_7f3a9c2d1e4b8a6f",
"data": {
"result": {
"summary": "Customers generally like the UX and find support helpful, but there are complaints about high subscription costs and app crashes on Android.",
"overall_sentiment": "mixed",
"total_analyzed": 4,
"positive_themes": [
"User experience",
"Responsive support"
],
"negative_themes": [
"Android crashes",
"High subscription pricing"
],
"common_praise": [
"Best UX ever",
"Support resolved issue in 10 minutes"
],
"common_complaints": [
"Crashes on Android launch",
"Too expensive subscription"
],
"recurring_pain_points": [
"App crash blocking access",
"High cost barrier"
],
"common_suggestions": [],
"important_patterns": [
"Android users encounter stability issues",
"Pricing causes subscriber churn"
],
"key_takeaways": [
"Investigate Android boot crash immediately",
"Consider reviewing pricing tiers or value delivery"
]
}
},
"meta": {
"version": "v1",
"timestamp": "2026-09-27T12:34:56+00:00"
}
}API Request Example
Use the cURL snippet below to test the endpoint.
curl -X POST 'https://rsflowhub.com/api/v1/ai/review-summary' \
-H 'Authorization: Bearer YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{
"reviews": [
"I love this app, it has changed my life. Best UX ever!",
"Decent app, but it crashes on launch sometimes on my Android device.",
"The subscription is way too expensive for what it offers. Cancelled.",
"Helpful customer support, they resolved my issue within 10 minutes."
]
}'Want to try it without code? Test this request in the live Playground.
Common Failure Modes & Troubleshooting Matrix
| HTTP Code | Error Code | Root Cause | Recommended Remediation |
|---|---|---|---|
| 401 | API_KEY_MISSING / INVALID_API_KEY |
No key sent, or the key was mistyped or regenerated. | Copy the current key from Dashboard → API Keys and send it as Authorization: Bearer (or X-API-Key). |
| 402 | INSUFFICIENT_CREDITS |
Your balance cannot cover the estimate for this call (base 3 credits plus input/output size). | Buy a plan in Dashboard → Billing. Nothing was charged. |
| 422 | VALIDATION_ERROR |
A field is missing, too long or the wrong type, or the body is not valid JSON. | Read error.details for the field messages and fix the request. Do not retry the same body. |
| 429 | RATE_LIMIT_EXCEEDED |
Your plan-wide or per-endpoint per-minute limit was reached. | Wait the seconds in the Retry-After header, then retry with jitter. Rate limits |
| 502 | AI_PROVIDER_ERROR |
The AI model and its backup both failed. | Retry with backoff and check the status page. Nothing was charged. |