- Docs
- API reference
- Endpoints and schemas
- GraphQL
- Selection
ReviewSummary
Summary of publicly available customer reviews for this entity.
Selection. This type is a selection. You reach it through a connection, and you choose which of its fields come back.
Summary of publicly available customer reviews for this entity.
Time Structure
Section titled “Time Structure”The review summary is a time series.
-
Rank = 0: The most recent review summary has rank 0
-
Higher ranks (1, 2, etc.): Represent review summaries from earlier periods in time.
Healthy businesses will have a steadily increasing number of reviews overtime. You can calculate the “review velocity” by measuring the difference in review_count between time periods. The review velocity may be a useful indicator of business health.
Data Sources
Section titled “Data Sources”The status data is derived from:
- Actual customer reviews about business locations that are publicly available
Methodology
Section titled “Methodology”Sourced from publicly available customer reviews of locations. This data is updated at least every months for each location. For simplicity, individual reviews are aggregated to provide an overview of a location. It’s possible for reviews to be removed or edited after some time, so it’s possible you may see the number of reviews decrease for a location at one point in time.
Where it appears
Section titled “Where it appears”Shortest path from a primary entity: Brand → operatingLocations → OperatingLocation → reviewSummaries → ReviewSummary.
OperatingLocation.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 number of reviews submitted for a location. |
reviewScoreAvg |
Review Score Average | String |
The average rating of the reviews for a location. |
firstReviewDate |
First Review Date | Date |
The date of the earliest available review (from a sample of one hundred reviews). |
lastReviewDate |
Last Review Date | Date |
The date of the latest available review. |
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. |
|
internalReviewSummaryId |
String |
A numeric identifier that Enigma assigns to the review summary when it builds its data. All ReviewSummary objects for one review summary share this value. |
Connections
Section titled “Connections”Each one is a connection: read it through edges { node { … } }, page it with first, and narrow it with conditions.
| Field | Leads to | Description |
|---|---|---|
operatingLocations |
OperatingLocation |
Operating locations that this review summary describes. Default first: 100. |
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 operatingLocations(first: 1) { edges { node { reviewSummaries(first: 1) { edges { node { id firstObservedDate lastObservedDate rank reviewCount } } } } } } } }}Response, as returned:
{ "data": { "search": [ { "id": "0f26fbef-3436-4f85-8bcd-31fe12a4f99a", "operatingLocations": { "edges": [ { "node": { "reviewSummaries": { "edges": [ { "node": { "id": "0000000e-0026-30a4-0000-098000000000", "firstObservedDate": "2023-08-07 14:50:28+00", "lastObservedDate": "2023-08-15 09:05:14+00", "rank": 0, "reviewCount": "187" } } ] } } } ] } } ] }}