- Docs
- API reference
- Endpoints and schemas
- GraphQL
- Selection
BrandReviewSummary
A summary of customer reviews across the operating locations associated with a brand.
Selection. This type is a selection. You reach it through a connection, and you choose which of its fields come back.
A summary of publicly available customer reviews across the operating locations associated with a brand.
Time Structure
Section titled “Time Structure”This attribute reflects the latest available review summary for each associated operating location. It does not currently include a time series.
Data Sources
Section titled “Data Sources”This attribute is derived from:
- Brand to operating location relationships
- The latest review summary for each associated operating location
Methodology
Section titled “Methodology”The review count is the sum of review counts across contributing operating locations. The average review score is weighted by each location’s review count. Locations without a usable current review summary do not contribute to either value.
Where it appears
Section titled “Where it appears”Shortest path from a primary entity: Brand → reviewSummaries → BrandReviewSummary.
Brand.reviewSummaries
Fields
Section titled “Fields”| Field | Label | Type | Description |
|---|---|---|---|
id |
ID | UUID! |
The unique identifier of this object. |
firstObservedDate |
First Observed Date | String |
The earliest date of a source record that supports this attribute or relationship. The source date is, for example, the date when Enigma collected the record or when the source last updated it. Most values have a date, a time, and a UTC offset, but some have the date only. |
lastObservedDate |
Last Observed Date | String |
The latest date of a source record that supports this attribute or relationship. It uses the same source dates and the same format as firstObservedDate. |
rank |
Rank | Int |
Determines the display order of the attribute, with lower values shown first |
reviewCount |
Review Count | String |
The total review count across the brand’s contributing operating locations. |
reviewScoreAvg |
Review Score Average | String |
The review-count-weighted average score across the brand’s contributing operating locations. |
firstReviewDate |
First Review Date | Date |
The earliest available review date across the brand’s contributing operating locations. |
lastReviewDate |
Last Review Date | Date |
The latest available review date across the brand’s contributing operating locations. |
internalId |
String |
A numeric identifier that Enigma assigns to this object when it builds its data. On most attribute objects, id is the UUID form of this number. |
|
internalBrandId |
String |
The internalId of the brand that this attribute describes. |
Math fields
Section titled “Math fields”Every record of this type answers count, countDistinct, has, sum, min, max, avg, collect, minDateTime, maxDateTime. Each takes field and an optional conditions. See Selection.
Example
Section titled “Example”query { search(searchInput: { entityType: BRAND name: "Safeway" conditions: { limit: 1 } }) { ... on Brand { id reviewSummaries(first: 1) { edges { node { id firstObservedDate lastObservedDate rank reviewCount } } } } }}Response, as returned:
{ "data": { "search": [ { "id": "0f26fbef-3436-4f85-8bcd-31fe12a4f99a", "reviewSummaries": { "edges": [ { "node": { "id": "0020f7ab-c05e-1ca3-0000-0e8000000000", "firstObservedDate": "2021-11-27 04:05:47+00", "lastObservedDate": "2026-09-20 13:14:03+00", "rank": 0, "reviewCount": "1326093" } } ] } } ] }}