Automated Pros & Cons Extraction
Generates structured arrays of positive product highlights and negative complaint themes from review text.
Reviews API
Customer Review Summary & Pros/Cons Extractor API
Batch review summarization API extracting pros, cons, recurring product feedback, and sentiment score distribution.
POST
https://rsflowhub.com/api/v1/ai/review-summary
- 3 credits per call
-
X-API-Keyheader - JSON in, JSON out
{
"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."
]
}
200 OK
response.json
{
"result": {
"summary": "Customers love the build quality and fast shipping, but battery life is the most common complaint.",
"overall_sentiment": "positive",
"total_analyzed": 120,
"positive_themes": [
"build quality",
"fast shipping"
],
"negative_themes": [
"battery life"
],
"common_praise": [
"Feels premium",
"Arrived early"
],
"common_complaints": [
"Battery drains by afternoon"
],
"recurring_pain_points": [
"Charging twice a day"
],
"common_suggestions": [
"Bigger battery"
],
"important_patterns": [
"Battery complaints rose after firmware 2.1"
],
"key_takeaways": [
"Prioritise a battery fix in the next release"
]
}
}
Definition
What is the Customer Review Summary & Pros/Cons Extractor API?
Customer Review Summary & Pros/Cons Extractor API is a REST API on RSFlowHub for web, mobile and AI agent applications. Send a JSON request to POST /api/v1/ai/review-summary with your API key; RSFlowHub runs it on a tuned AI model, falls back to a backup provider if needed, and returns a structured JSON result, usually within 1 to 3 seconds.
- Category
- Reviews
- Endpoint
POST /api/v1/ai/review-summary- Authentication
X-API-Keyheader- Price
- 3 credits per call
- Rate limit
- 10 to 120 requests / minute by plan
- Typical response
- 1 to 3 seconds
- Format
- JSON, UTF-8
Request parameters
Send these fields as a JSON body. An invalid or missing field returns a 422 error that names the field.
| 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. |
Code examples
Copy, replace rfh_your_api_key with your key and run. Prefer a client library? See the official SDKs.
request.sh
curl -X POST "https://rsflowhub.com/api/v1/ai/review-summary" \
-H "Content-Type: application/json" \
-H "X-API-Key: rfh_your_api_key" \
-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."]}'
client.php
<?php
$client = new \GuzzleHttp\Client();
$response = $client->post('https://rsflowhub.com/api/v1/ai/review-summary', [
'headers' => [
'Content-Type' => 'application/json',
'X-API-Key' => 'rfh_your_api_key',
],
'json' => array (
'reviews' =>
array (
0 => 'I love this app, it has changed my life. Best UX ever!',
1 => 'Decent app, but it crashes on launch sometimes on my Android device.',
2 => 'The subscription is way too expensive for what it offers. Cancelled.',
3 => 'Helpful customer support, they resolved my issue within 10 minutes.',
),
),
]);
echo $response->getBody();
client.js
const response = await fetch('https://rsflowhub.com/api/v1/ai/review-summary', {
method: 'POST',
headers: {
'Content-Type': 'application/json',
'X-API-Key': 'rfh_your_api_key'
},
body: JSON.stringify({"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."]})
});
const data = await response.json();
console.log(data);
main.py
import requests
url = "https://rsflowhub.com/api/v1/ai/review-summary"
headers = {
"Content-Type": "application/json",
"X-API-Key": "rfh_your_api_key"
}
payload = {"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."]}
response = requests.post(url, json=payload, headers=headers)
print(response.json())Response
Every RSFlowHub endpoint uses the same envelope, so one parser handles all of them. Failed calls are not charged.
response.json
{
"success": true,
"request_id": "req_3f9a2c7e-5b1d-4e8a-9c2f-7d6e1a0b4c8d",
"data": {
"result": {
"summary": "Customers love the build quality and fast shipping, but battery life is the most common complaint.",
"overall_sentiment": "positive",
"total_analyzed": 120,
"positive_themes": [
"build quality",
"fast shipping"
],
"negative_themes": [
"battery life"
],
"common_praise": [
"Feels premium",
"Arrived early"
],
"common_complaints": [
"Battery drains by afternoon"
],
"recurring_pain_points": [
"Charging twice a day"
],
"common_suggestions": [
"Bigger battery"
],
"important_patterns": [
"Battery complaints rose after firmware 2.1"
],
"key_takeaways": [
"Prioritise a battery fix in the next release"
]
}
},
"meta": {
"version": "v1",
"timestamp": "2026-10-05T09:30:00Z"
}
}
error.json
{
"success": false,
"request_id": "req_8c1d4e2a-7f3b-4a9c",
"error": {
"code": "VALIDATION_ERROR",
"message": "The given data was invalid.",
"details": {
"reviews": [
"This field is required."
]
}
},
"meta": {
"version": "v1",
"timestamp": "2026-10-05T09:30:00Z"
}
}| Field | Type | Meaning |
|---|---|---|
success | boolean | true when the call worked, false on any error. |
request_id | string | Unique id for this call. Quote it when you contact support. |
data.result | object | The result of this endpoint (see the example). |
error | object | Only on failure: code, message and details per field. |
meta | object | API version and server timestamp. |
All error codes: Errors reference
Features
Batch Processing Engine
Summarizes dozens or hundreds of raw customer reviews in a single unified API payload.
Executive Actionable Takeaways
Highlights top 3 urgent product improvements and feature requests requested by customers.
Sentiment Score Distribution
Outputs percentage breakdown of positive, neutral, and negative customer feedback across batches.
Use cases
How teams use the Customer Review Summary & Pros/Cons Extractor API in production.
E-Commerce Product Page Review Summary
Display instant "AI Pros & Cons Summary" pills above product reviews to accelerate buyer purchase decisions.
- Input
- ["Loved the design and battery life!", "Screen broke after 1 week", "Super fast delivery!"]
- Output
{"pros": ["Design", "Battery life", "Fast delivery"], "cons": ["Screen durability"], "overall": "positive"}
Gives every product page a clear, persuasive description.
Product Roadmap & Feature Prioritization
Analyze app store feedback batches weekly to help product managers prioritize bug fixes.
- Input
- ["Great app but dark mode is broken", "Add dark mode please", "UI is nice but crashes on Android 14"]
- Output
{"top_requests": ["Fix dark mode bug", "Android 14 crash fix"], "sentiment": "mixed"}
Saves product teams 10+ hours of manual review tagging.
Executive Brand Reputation Briefs
Summarize monthly customer satisfaction reviews across G2, Trustpilot, and Google Business for executive reports.
- Input
- ["Support team resolved my ticket in 5 mins!", "Billing department charged twice.", "Great platform!"]
- Output
{"highlights": "Support response time praised; billing double-charge complaint flagged."}
Delivers clear monthly brand reputation summaries.
Customer Review Summary & Pros/Cons Extractor API vs building it yourself
The same job done three ways.
| Topic | RSFlowHub API | Raw LLM prompts | Rules / regex |
|---|---|---|---|
| Output | Validated JSON fields | Free text you have to parse | Fixed patterns only |
| Setup | One POST request, no prompts | Write and maintain prompts and parsing | Write and maintain rule lists |
| Provider outage | Automatic fallback to a backup model | You build retries and a second vendor | Not applicable |
| Pricing | 3 credits per call, failed calls free | Per token, per vendor | Your own servers and upkeep |
| Understands context | Yes, AI model | Yes, AI model | No, keywords only |
Frequently asked questions
How many reviews can I pass in a single batch summary request?
The API can process batches ranging from a few reviews up to dozens of customer comments in a single request payload.
Can the API extract structured Pros and Cons lists?
Yes! The API returns structured "pros" and "cons" arrays alongside executive takeaway summaries.
How fast is the Review Summary API?
Review Summary requests usually complete in 1 to 3 seconds, depending on input length and the AI model. Identical repeat requests are served from cache and return faster.
Does it support multi-language review batches?
Yes! The API can process and summarize review batches written in English, Spanish, French, German, and 45+ other languages.
How many credits are deducted per request?
Standard Review Summary API calls consume 3 base credits per request.
Start using the Customer Review Summary & Pros/Cons Extractor API
Free plan with 100 credits/month + 1,000 bonus credits when you sign in before 23 Nov. Test it in the playground first, no code needed.