API Endpoint

POST Review Summary API

/api/v1/ai/review-summary

Summarize multiple customer reviews to extract recurring positive/negative themes, complaints, and key takeaways.

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

Example Request

This example demonstrates how to pass an array of customer review strings to extract batch insights.

JSON Request

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

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.

JSON Response

{
  "success": true,
  "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": {
    "credits_used": 3,
    "credits_remaining": 987
  }
}

API Request Example

Use the cURL snippet below to test the endpoint.