This reference covers the Reviews metrics and dimensions available in Report Builder and the Analytics API.

Reviews Metrics

Average Rating

Description: The cumulative average of the ratings your business has received.

Request ID: AVERAGE_RATING

Response ID: Average Rating

Data Type: Float

Example Response Value: 0

Example Response: {"Average Rating": 0.0, "day": "1980-01-01"}

Compatible Dimensions:

• Time: DAY_OF_WEEK, DAYS, MONTHS, QUARTERS, WEEK_NUMBER, WEEKS
• Entities: ENTITY_IDS, ENTITY_TYPES, FOLDER_NAMES, LOCATION_NAMES / LOCATION_IDS
• Reviews: AWAITING_RESPONSE, GENERATION_SOURCE, REVIEW_PUBLISHER_TYPE, RATINGS, RESPONSE_SOURCE, RESPONSE_TIME, REVIEW_KEYWORDS, REVIEW_LABELS, REVIEW_STATUS, SENTIMENT_COLLECTION, PARTNERS, REVIEW_TRENDS, USER_NAME
• API Only: ACCOUNT_IDS

Keyword Mentions

Description: The number of times a review keyword is mentioned.

Request ID: KEYWORD_MENTIONS

Response ID: Keyword Mentions

Data Type: Integer

Example Response Value: 0

Example Response: {"day": "1980-01-01", "Keyword Mentions": 0}

Compatible Dimensions:

• Time: DAY_OF_WEEK, DAYS, MONTHS, QUARTERS, WEEK_NUMBER, WEEKS
• Entities: ENTITY_IDS, ENTITY_TYPES, FOLDER_NAMES, LOCATION_NAMES / LOCATION_IDS
• Reviews: AWAITING_RESPONSE, GENERATION_SOURCE, REVIEW_PUBLISHER_TYPE, RATINGS, RESPONSE_SOURCE, RESPONSE_TIME, REVIEW_KEYWORDS, REVIEW_LABELS, REVIEW_STATUS, SENTIMENT_COLLECTION, PARTNERS, REVIEW_TRENDS, USER_NAME
• API Only: ACCOUNT_IDS

Keyword Sentiment

Description: The sentiment score of review keywords.

Request ID: KEYWORD_SENTIMENT

Response ID: Keyword Sentiment

Data Type: Float

Example Response Value: 0

Example Response: {"Keyword Sentiment": 0.0, "day": "1980-01-01"}

Compatible Dimensions:

• Time: DAY_OF_WEEK, DAYS, MONTHS, QUARTERS, WEEK_NUMBER, WEEKS
• Entities: ENTITY_IDS, ENTITY_TYPES, FOLDER_NAMES, LOCATION_NAMES / LOCATION_IDS
• Reviews: AWAITING_RESPONSE, GENERATION_SOURCE, REVIEW_PUBLISHER_TYPE, RATINGS, RESPONSE_SOURCE, RESPONSE_TIME, REVIEW_KEYWORDS, REVIEW_LABELS, REVIEW_STATUS, SENTIMENT_COLLECTION, PARTNERS, REVIEW_TRENDS, USER_NAME
• API Only: 

Response Count

Description: The number of reviews with responses on publishers that support in-platform response.

Request ID: RESPONSE_COUNT

Response ID: Response Count

Data Type: Integer

Example Response Value: 0

Example Response: {"Response Count": 0, "day": "1980-01-01"}

Compatible Dimensions:

• Time: DAY_OF_WEEK, DAYS, MONTHS, QUARTERS, WEEK_NUMBER, WEEKS
• Entities: ENTITY_IDS, ENTITY_TYPES, FOLDER_NAMES, LOCATION_NAMES / LOCATION_IDS
• Reviews: AWAITING_RESPONSE, GENERATION_SOURCE, REVIEW_PUBLISHER_TYPE, RATINGS, RESPONSE_SOURCE, RESPONSE_TIME, REVIEW_KEYWORDS, REVIEW_LABELS, REVIEW_STATUS, SENTIMENT_COLLECTION, PARTNERS, REVIEW_TRENDS, USER_NAME
• API Only: ACCOUNT_IDS

Response Rate

Description: The percentage of reviews with responses on publishers that support in-platform response.

Request ID: RESPONSE_RATE

Response ID: Response Rate

Data Type: Integer

Example Response Value: 0

Example Response: {"Response Rate": 0, "day": "1980-01-01"}

Compatible Dimensions:

• Time: DAY_OF_WEEK, DAYS, MONTHS, QUARTERS, WEEK_NUMBER, WEEKS
• Entities: ENTITY_IDS, ENTITY_TYPES, FOLDER_NAMES, LOCATION_NAMES / LOCATION_IDS
• Reviews: AWAITING_RESPONSE, GENERATION_SOURCE, REVIEW_PUBLISHER_TYPE, RATINGS, RESPONSE_SOURCE, RESPONSE_TIME, REVIEW_KEYWORDS, REVIEW_LABELS, REVIEW_STATUS, SENTIMENT_COLLECTION, PARTNERS, REVIEW_TRENDS, USER_NAME
• API Only: ACCOUNT_IDS

Response Time (Hours), Response Timestamp Based

Description: The average time in hours between the review date and the response date for all responses posted in the specified time period. Only includes publishers that support in-platform response.

Request ID: RESPONSE_TIME

Response ID: Response Time (Hours), Response Timestamp Based

Data Type: Float

Example Response Value: 0

Example Response: {"Response Time (Hours), Response Timestamp Based": 0.0, "day": "1980-01-01"}

Compatible Dimensions:

• Time: DAY_OF_WEEK, DAYS, MONTHS, QUARTERS, WEEK_NUMBER, WEEKS
• Entities: ENTITY_IDS, ENTITY_TYPES, FOLDER_NAMES, LOCATION_NAMES / LOCATION_IDS
• Reviews: AWAITING_RESPONSE, GENERATION_SOURCE, REVIEW_PUBLISHER_TYPE, RATINGS, RESPONSE_SOURCE, RESPONSE_TIME, REVIEW_KEYWORDS, REVIEW_LABELS, REVIEW_STATUS, SENTIMENT_COLLECTION, PARTNERS, REVIEW_TRENDS, USER_NAME
• API Only: ACCOUNT_IDS

Response Time (Hours), Review Timestamp Based

Description: The average time in hours until response for all reviews left in the specified time period that have a response. Only includes publishers that support in-platform response.

Request ID: RESPONSE_TIME_REVIEW_TIMESTAMP_BASED

Response ID: Response Time (Hours), Review Timestamp Based

Data Type: Float

Example Response Value: 0

Example Response: {"Response Time (Hours), Review Timestamp Based": 0.0, "day": "1980-01-01"}

Compatible Dimensions:

• Time: DAY_OF_WEEK, DAYS, MONTHS, QUARTERS, WEEK_NUMBER, WEEKS
• Entities: ENTITY_IDS, ENTITY_TYPES, FOLDER_NAMES, LOCATION_NAMES / LOCATION_IDS
• Reviews: AWAITING_RESPONSE, GENERATION_SOURCE, REVIEW_PUBLISHER_TYPE, RATINGS, RESPONSE_SOURCE, RESPONSE_TIME, REVIEW_KEYWORDS, REVIEW_LABELS, REVIEW_STATUS, SENTIMENT_COLLECTION, PARTNERS, REVIEW_TRENDS, USER_NAME
• API Only: ACCOUNT_IDS

Reviews

Description: The number of new reviews your business has received.

Request ID: NEW_REVIEWS

Response ID: Reviews

Data Type: Integer

Example Response Value: 0

Example Response: {"New Reviews": 0, "day": "1980-01-01"}

Compatible Dimensions:

• Time: DAY_OF_WEEK, DAYS, MONTHS, QUARTERS, WEEK_NUMBER, WEEKS
• Entities: ENTITY_IDS, ENTITY_TYPES, FOLDER_NAMES, LOCATION_NAMES / LOCATION_IDS
• Reviews: AWAITING_RESPONSE, GENERATION_SOURCE, REVIEW_PUBLISHER_TYPE, RATINGS, RESPONSE_SOURCE, RESPONSE_TIME, REVIEW_KEYWORDS, REVIEW_LABELS, REVIEW_STATUS, SENTIMENT_COLLECTION, PARTNERS, REVIEW_TRENDS, USER_NAME
• API Only: ACCOUNT_IDS

Reviews Theme Average Rating

Description: The average rating of all reviews in the theme.

Request ID: CLUSTER_AVERAGE_RATING

Response ID: CLUSTER_AVERAGE_RATING

Data Type: Float

Example Response Value: 3.98

Example Response: {"CLUSTER_AVERAGE_RATING": 3.98, "DAY_OF_WEEK": "Friday"}

Compatible Dimensions:

• Time: DAY_OF_WEEK, DAYS, MONTHS, QUARTERS, WEEKS
• Entities: ENTITY_IDS
• Listings: SITES
• API Only: ACCOUNT_IDS

Reviews Theme Reviews

Description: The total number of reviews in the theme.

Request ID: CLUSTER_REVIEW_COUNT

Response ID: CLUSTER_REVIEW_COUNT

Data Type: Integer

Example Response Value: 124

Example Response: {"CLUSTER_REVIEW_COUNT": 124, "MONTHS": "2025-01-01"}

Compatible Dimensions:

• Time: DAY_OF_WEEK, DAYS, MONTHS, QUARTERS, WEEKS
• Entities: ENTITY_IDS
• Listings: SITES
• API Only: ACCOUNT_IDS

Rolling Average Rating

Description: Average review rating of your entities and your competitors' entities. Available for accounts with Competitive Intelligence.

Request ID: CUMULATIVE_RATING

Response ID: Rolling Average Rating

Data Type: Float

Example Response Value: 3.98

Example Response: {"Rolling Average Rating": 3.98, "competitor": "Ali Baba"}

Compatible Dimensions:

• Time: MONTHS
• Entities: ENTITY_IDS, ENTITY_GROUPS, ENTITY_TYPES, FOLDER_NAMES / FOLDER_IDS, LOCATION_NAMES / LOCATION_IDS, ZIP_CODE
• Reviews: PARTNERS
• API Only: ACCOUNT_IDS

Rolling Review Volume

Description: Cumulative review volume of your entities and your competitors' entities. Competitor data is based on the most recent Competitive Intelligence scan before your selected date range. Your entity data includes all reviews within your selected date range. Available for accounts with Competitive Intelligence.

Request ID: CUMULATIVE_REVIEW_VOLUME

Response ID: Rolling Review Volume

Data Type: Integer

Example Response Value: 124

Example Response: {"Rolling Review Volume": 124, "competitor": "Ali Baba"}

Compatible Dimensions:

• Time: MONTHS
• Entities: ENTITY_IDS, ENTITY_GROUPS, ENTITY_TYPES, FOLDER_NAMES / FOLDER_IDS, LOCATION_NAMES / LOCATION_IDS, ZIP_CODE
• Reviews: PARTNERS
• API Only: ACCOUNT_IDS

Reviews Dimensions

Awaiting Response

Description: Identifies reviews by whether they have a response or not.

Request ID: AWAITING_RESPONSE

Response ID: AWAITING_RESPONSE

Data Type: Boolean

Example Response Value: FALSE

Example Response: {"Reviews": 124, "AWAITING_RESPONSE": "FALSE"}

Generation Source

Description: Identifies reviews by their generation source.

Request ID: GENERATION_SOURCE

Response ID: GENERATION_SOURCE

Data Type: enum: ["SMS", "QR Code", "Organic", "Email", "Direct Link"]

Example Response Value: QR Code

Example Response: {"Reviews": 124, "GENERATION_SOURCE": "QR Code"}

Publisher Type

Description: Identifies reviews by their publisher type, first-party or third-party.

Request ID: REVIEW_PUBLISHER_TYPE

Response ID: REVIEW_PUBLISHER_TYPE

Data Type: enum: ["First-party", "Third-party"]

Example Response Value: First-party

Example Response: {"Reviews": 124, "REVIEW_PUBLISHER_TYPE": "First-party"}

Ratings

Description: Identifies reviews by their star ratings.

Request ID: RATINGS

Response ID: RATINGS

Data Type: String

Example Response Value: enum: ["0", "1", "2", "3", "4", "5"]

Example Response: {"Reviews": 124, "RATINGS": "4"}

Response Source

Description: Identifies reviews by their response source.

Request ID: RESPONSE_SOURCE

Response ID: RESPONSE_SOURCE

Data Type: enum: ["Automatic", "Generative", "Platform", "Publisher", "Mobile", "API"]

Example Response Value: Automatic

Example Response: {"Reviews": 124, "RESPONSE_SOURCE": "Automatic"}

Response Time

Description: Identifies reviews by how long it took to respond to them.

Request ID: RESPONSE_TIME

Response ID: RESPONSE_TIME

Data Type: enum: ["LESS_THAN_HOUR", "BETWEEN_HOUR_DAY", "BETWEEN_DAY_WEEK", "BETWEEN_WEEK_MONTH", "GREATER_THAN_MONTH"]

Example Response Value: BETWEEN_WEEK_MONTH

Example Response: {"Reviews": 124, "RESPONSE_TIME": "BETWEEN_WEEK_MONTH"}

Review Keywords

Description: Identifies reviews by the keywords used.

Request ID: REVIEW_KEYWORDS

Response ID: REVIEW_KEYWORDS

Data Type: String

Example Response Value: "Service"

Example Response: {"Reviews": 124, "REVIEW_KEYWORDS": "Service"}

Review Labels

Description: Identifies reviews by their label.

Request ID: REVIEW_LABELS

Response ID: REVIEW_LABELS

Data Type: String

Example Response Value: "Appetizers"

Example Response: {"Reviews": 124, "REVIEW_LABELS": "Appetizers"}

Review Status

Description: Identifies reviews by their status.

Request ID: REVIEW_STATUS

Response ID: REVIEW_STATUS

Data Type: enum: ["Live", "Quarantined", "Removed"]

Example Response Value: Live

Example Response: {"Reviews": 124, "REVIEW_STATUS": "Live"}

Sentiment Collection

Description: Identifies reviews by their sentiment collection of keywords. The response value is formatted as "[ID] - [Name]" of the sentiment collection.

Request ID: SENTIMENT_COLLECTION

Response ID: SENTIMENT_COLLECTION

Data Type: String

Example Response Value: "3 - Food"

Example Response: {"Reviews": 124, "SENTIMENT_COLLECTION": "3 - Food"}

Sites

Description: Sites, apps, or integrations in the Publisher network.

Request ID: PARTNERS

Response ID: PARTNERS

Data Type: String

Example Response Value: "Facebook"

Example Response: {"Reviews": 124, "PARTNERS": "Facebook"}

Summary

Description: Identifies reviews by their summary.

Request ID: REVIEW_TRENDS

Response ID: REVIEW_TRENDS

Data Type: String

Example Response Value: "[Jun 01 - Jun 30] - Appointment dissatisfaction"

Example Response: {"Reviews": 124, "REVIEW_TRENDS": "[Jun 01 - Jun 30] - Appointment dissatisfaction"}

User Name

Description: Full name of Yext user.

Request ID: USER_NAME

Response ID: USER_NAME

Data Type: String

Example Response Value: "Alex Mobile"

Example Response: {"Reviews": 4, "USER_NAME": "Alex Mobile"}