The JSON AI Review Summaries API allows you to access AI-generated summaries of reviews collected for your products, and (optionally) deeper AI Aspects analysis.
Note: The JSON AI Review Summaries API must be enabled by TestFreaks for your client ID.
The API takes your client ID, and either the product ID or the family ID.
Using a product ID:
https://cr.testfreaks.com/ai-summaries.json?client_id=your.client.id&product_id=PRODUCT001
Using a family ID:
https://cr.testfreaks.com/ai-summaries.json?client_id=your.client.id&family_id=FAMILY001
Note: Replace
your.client.id
with one of your assigned client IDs.
See Product Feed for an explanation of the product and family concepts.
The API returns a JSON response that always contains the following fields:
content
: the AI-generated summary, typically a few sentences of textnumber_of_reviews
: the number of reviews used for the summarydate
: the date when the summary was generated{
"content": "The product reviews are summarized in a few sentences.",
"number_of_reviews": 73,
"date": "2025-03-18"
}
If enabled for your client and if sufficient reviews exist, the response is extended with an aspects
array. Each item represents a specific facet mentioned by reviewers (e.g. Comfort, Battery Life).
{
"content": "The product reviews are summarized in a few sentences.",
"number_of_reviews": 73,
"date": "2025-03-18",
"aspects": [
{
"name": "Comfort",
"content": "Most find this product comfortable to use.",
"number_of_positive_reviews": 123,
"number_of_negative_reviews": 15,
"date": "2025-03-18",
"quotes": [
{
"positive": true,
"content": "...Feels great on the foot...",
"highlight": "Feels great"
}
]
}
]
}
Field | Description |
---|---|
name |
Name of the identified aspect (e.g. “Battery Life”). |
content |
AI-generated sub-summary for this aspect. |
number_of_positive_reviews |
Count of reviews mentioning this aspect positively. |
number_of_negative_reviews |
Count of reviews mentioning this aspect negatively. |
date |
Date of the aspect generation (YYYY-MM-DD). |
sentiment |
Whether this quote expresses a positive , neutral , or negative sentiment (a string with one of these values). |
quotes |
Array of example review excerpts for this aspect. |
Field | Description |
---|---|
date |
Date when the review was published (YYYY-MM-DD). |
author |
Author name. |
positive |
Whether this quote expresses a positive sentiment (true/false). |
content |
Quote from the full review. |
highlight |
Highlighted portion of the quote most relevant to this aspect. |