Skip to content
RSFlowHub
  1. Home
  2. APIs
  3. Reviews
  4. E-Commerce & App Review Topic Intelligence API
Reviews API

E-Commerce & App Review Topic Intelligence API

Review intelligence API discovering product trends, feature gaps, competitor weaknesses, and sentiment drivers.

POST https://rsflowhub.com/api/v1/ai/review-insights
  • 3 credits per call
  • X-API-Key header
  • JSON in, JSON out
POST /api/v1/ai/review-insights
{
    "reviews": [
        {
            "text": "The software is great but missing single sign-on (SSO).",
            "rating": 3
        },
        {
            "text": "Very intuitive interface, we onboarded our team of 20 in a single afternoon.",
            "rating": 5
        },
        {
            "text": "The billing page keeps throwing error 500 when I try to update my card details.",
            "rating": 2
        },
        {
            "text": "We need custom user permissions. The current admin vs member roles are not enough.",
            "rating": 3
        }
    ],
    "context": "B2B SaaS project management tool"
}
200 OK response.json
{
    "result": {
        "executive_summary": "Satisfaction is high overall; battery life is the main driver of negative reviews.",
        "top_strengths": [
            "Build quality",
            "Shipping speed"
        ],
        "top_weaknesses": [
            "Battery life"
        ],
        "recurring_complaints": [
            "Battery drains quickly"
        ],
        "feature_requests": [
            "Fast charging"
        ],
        "emerging_patterns": [
            "More complaints since firmware 2.1"
        ],
        "recommended_actions": [
            {
                "action": "Ship a battery optimisation update",
                "priority": "high",
                "rationale": "Most frequent complaint in recent reviews"
            }
        ]
    }
}
Definition

What is the E-Commerce & App Review Topic Intelligence API?

E-Commerce & App Review Topic Intelligence API is a REST API on RSFlowHub for web, mobile and AI agent applications. Send a JSON request to POST /api/v1/ai/review-insights 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-insights
Authentication
X-API-Key header
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.

FieldTypeRequiredDescription
reviews array Required Required array of reviews to analyze (Min: 1, Max: 50). Can contain strings or structured objects.
context string Optional Optional business context to frame insights.

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-insights" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: rfh_your_api_key" \
  -d '{"reviews":[{"text":"The software is great but missing single sign-on (SSO).","rating":3},{"text":"Very intuitive interface, we onboarded our team of 20 in a single afternoon.","rating":5},{"text":"The billing page keeps throwing error 500 when I try to update my card details.","rating":2},{"text":"We need custom user permissions. The current admin vs member roles are not enough.","rating":3}],"context":"B2B SaaS project management tool"}'

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": {
            "executive_summary": "Satisfaction is high overall; battery life is the main driver of negative reviews.",
            "top_strengths": [
                "Build quality",
                "Shipping speed"
            ],
            "top_weaknesses": [
                "Battery life"
            ],
            "recurring_complaints": [
                "Battery drains quickly"
            ],
            "feature_requests": [
                "Fast charging"
            ],
            "emerging_patterns": [
                "More complaints since firmware 2.1"
            ],
            "recommended_actions": [
                {
                    "action": "Ship a battery optimisation update",
                    "priority": "high",
                    "rationale": "Most frequent complaint in recent reviews"
                }
            ]
        }
    },
    "meta": {
        "version": "v1",
        "timestamp": "2026-10-05T09:30:00Z"
    }
}
Envelope fields
FieldTypeMeaning
successbooleantrue when the call worked, false on any error.
request_idstringUnique id for this call. Quote it when you contact support.
data.resultobjectThe result of this endpoint (see the example).
errorobjectOnly on failure: code, message and details per field.
metaobjectAPI version and server timestamp.

All error codes: Errors reference

Features

Emerging Trend & Sentiment Drivers

Detects sudden spikes in customer complaints or praise topics across time to surface hidden product issues.

Competitive Weakness Spotter

Extracts competitor product flaws and weaknesses mentioned in comparative buyer reviews.

Feature Request & Gap Discovery

Mines customer feedback to identify explicitly requested missing features and product improvements.

Strategic Executive Takeaways

Outputs high-level strategic summaries for product, engineering, and marketing leadership teams.

Use cases

How teams use the E-Commerce & App Review Topic Intelligence API in production.

SaaS & Mobile App Teams

Product Management Feature Gap Mining

Mine thousands of user reviews to discover the top 5 requested missing features and UI friction points.

Input
["Great app but lacks CSV export", "I wish I could export my reports to PDF or CSV", "Need Google Login"]
Output
{"feature_gaps": ["CSV/PDF Export", "Google SSO Login"], "demand_level": "high"}

Drives customer-centric product roadmap decisions.

Marketplace Brands

E-Commerce Competitive Intelligence

Analyze competitor product reviews on Amazon to identify durability and sizing complaints.

Input
["Brand X backpack straps broke in 2 weeks", "Straps are weak compared to original"]
Output
{"competitor_weakness": "Strap durability", "opportunity": "Highlight reinforced stitching in ads"}

Gives marketing teams a sharp competitive edge in product positioning.

Retail & Hospitality

Customer Experience Quality Auditing

Track customer satisfaction trends across multiple restaurant or hotel locations over time.

Input
["Location A staff was super slow today", "Location A order took 35 mins"]
Output
{"location": "Location A", "issue": "Service speed delay", "urgency": "medium"}

Improves regional service quality standards.

E-Commerce & App Review Topic Intelligence API vs building it yourself

The same job done three ways.

TopicRSFlowHub APIRaw LLM promptsRules / regex
Output Validated JSON fieldsFree text you have to parseFixed patterns only
Setup One POST request, no promptsWrite and maintain prompts and parsingWrite and maintain rule lists
Provider outage Automatic fallback to a backup modelYou build retries and a second vendorNot applicable
Pricing 3 credits per call, failed calls freePer token, per vendorYour own servers and upkeep
Understands context Yes, AI modelYes, AI modelNo, keywords only

Frequently asked questions

How does the Review Insights API identify feature gaps?
The engine scans review text for explicit request language (e.g. "wish it had", "lacks feature", "please add") and groups similar requests into structured feature gap insights.
Can I compare customer feedback against competitor products?
Yes! By passing competitor_name, the engine isolates comparative feedback pointing out where your product wins or loses.
How fast is the Review Insights API?
Review Insights 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 the API support multi-language review datasets?
Yes! The API analyzes review datasets written across 50+ global languages.
How many credits are deducted per request?
Standard Review Insights API calls consume 3 base credits per request.

Start using the E-Commerce & App Review Topic Intelligence 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.

RSFlowHub

Sign in to continue

You'll come straight back to this page.

Forgot password?

New to RSFlowHub? Create a free account