Skip to content
Gridlode
Docs · Reference

AI Review Insights

GET /v1/ai/review-insightsUsage-basedcache 60 min

Turns a set of customer reviews into insights with Claude: overall sentiment and score, the sentiment of every review and the resulting distribution, the top positive and negative themes with how many reviews mention each and verbatim example quotes, the average rating, and a short summary. Send up to 1,000 review texts (with optional ratings) or let it fetch them from a review engine. Billed by the model's actual token usage (plus the source engine's credits), never above your max_credits.

Query parameters

reviews
string
Reviews to analyse: strings, or objects {text, rating, id}. Give reviews or source.
Default: null
source
string
Fetch the reviews with a review engine instead: {engine, params}. That engine's own credits are included in the charge.
Default: null
language
string
Language for the summary and theme names (quotes stay verbatim).
Default: "en"
max_themes
integer
Themes per side (positive / negative).
Default: 5
max_chars
string
Review text sent to the model is cut at this many characters (server limit applies when lower).
Default: null
max_credits
integer
The most this call may cost, source engine included. The actual charge follows token usage and is never higher.
Default: 150
max_age
integer
Accept a cached answer up to this many seconds old, billed at 50%.

Response data fields

    Example

    curl "https://api.gridlode.com/v1/ai/review-insights?" \
  -H "Authorization: Bearer $GRIDLODE_KEY"

    Try it without code on the AI Review Insights API page.