API Endpoint

POST Review Insights API

/api/v1/ai/review-insights

Analyze multiple reviews to generate structured actionable business recommendations, priority ratings, and emerging patterns.

Request Body Parameters

Field	Type	Required	Description
`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.
`model`	string	Optional	Optional AI model to use.

Example Request

This example demonstrates how to request priority insights from a list of structured e-commerce or SaaS reviews.

JSON Request

{
  "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"
}

cURL

curl -X POST https://rsflowhub.com/api/v1/ai/review-insights \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -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"
  }'

Example Response

The response provides actionable business metrics, categorized recommended actions, and confidence rationale.

JSON Response

{
  "success": true,
  "data": {
    "result": {
      "executive_summary": "Users highly appreciate the interface and onboarding simplicity, but core account management (billing failures) and enterprise access gaps (SSO, custom roles) block growth.",
      "top_strengths": [
        "Intuitive interface and ease of onboarding"
      ],
      "top_weaknesses": [
        "Billing page stability",
        "Lack of enterprise access controls"
      ],
      "pain_points": [
        "Users unable to update card details (HTTP 500 error)"
      ],
      "recurring_complaints": [
        "Billing card update failure"
      ],
      "improvement_opportunities": [
        "Implement Single Sign-On (SSO)",
        "Refine role-based access control (RBAC)"
      ],
      "customer_expectations": [
        "Smooth payment experience",
        "Granular team role options"
      ],
      "feature_requests": [
        "SSO integration",
        "Custom permissions roles"
      ],
      "emerging_patterns": [
        "Early adoption by larger team accounts reveals enterprise feature gaps"
      ],
      "recommended_actions": [
        {
          "action": "Fix billing page HTTP 500 card updates.",
          "priority": "high",
          "rationale": "Directly impacts revenue collection and customer billing satisfaction."
        },
        {
          "action": "Implement SSO and Custom Roles.",
          "priority": "medium",
          "rationale": "Enables higher tier enterprise adoption and resolves user management feedback."
        }
      ]
    }
  },
  "meta": {
    "credits_used": 4,
    "credits_remaining": 980
  }
}

API Request Example

Use the cURL snippet below to test the endpoint.