Reviews Metrics and Dimensions | Yext Hitchhikers Platform
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
- Reviews
AWAITING_RESPONSE
GENERATION_SOURCE
REVIEW_PUBLISHER_TYPE
RATINGS
RESPONSE_TIME
REVIEW_KEYWORDS
REVIEW_LABELS
REVIEW_STATUS
SENTIMENT_COLLECTION
PARTNERS
REVIEW_TRENDS
- 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
- Reviews
AWAITING_RESPONSE
GENERATION_SOURCE
REVIEW_PUBLISHER_TYPE
RATINGS
RESPONSE_TIME
REVIEW_KEYWORDS
REVIEW_LABELS
REVIEW_STATUS
SENTIMENT_COLLECTION
PARTNERS
REVIEW_TRENDS
- 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
- Reviews
AWAITING_RESPONSE
GENERATION_SOURCE
REVIEW_PUBLISHER_TYPE
RATINGS
RESPONSE_TIME
REVIEW_KEYWORDS
REVIEW_LABELS
REVIEW_STATUS
SENTIMENT_COLLECTION
PARTNERS
REVIEW_TRENDS
- API Only
ACCOUNT_IDS
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
- Reviews
AWAITING_RESPONSE
GENERATION_SOURCE
REVIEW_PUBLISHER_TYPE
RATINGS
RESPONSE_TIME
REVIEW_KEYWORDS
REVIEW_LABELS
REVIEW_STATUS
SENTIMENT_COLLECTION
PARTNERS
REVIEW_TRENDS
- 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
- Reviews
AWAITING_RESPONSE
GENERATION_SOURCE
REVIEW_PUBLISHER_TYPE
RATINGS
RESPONSE_TIME
REVIEW_KEYWORDS
REVIEW_LABELS
REVIEW_STATUS
SENTIMENT_COLLECTION
PARTNERS
- API Only
ACCOUNT_IDS
Response Time (Hours)
Description: The average time in hours between the review date and the response date of all reviews with responses that can be responded to in the platform.
Request ID: RESPONSE_TIME
Response ID: Response Time (Hours)
Data Type: Float
Example Response Value: 0
Example Response: {"Response Time (Hours)": 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
- Reviews
AWAITING_RESPONSE
GENERATION_SOURCE
REVIEW_PUBLISHER_TYPE
RATINGS
RESPONSE_TIME
REVIEW_KEYWORDS
REVIEW_LABELS
REVIEW_STATUS
SENTIMENT_COLLECTION
PARTNERS
- 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
- Reviews
AWAITING_RESPONSE
GENERATION_SOURCE
REVIEW_PUBLISHER_TYPE
RATINGS
RESPONSE_TIME
REVIEW_KEYWORDS
REVIEW_LABELS
REVIEW_STATUS
SENTIMENT_COLLECTION
PARTNERS
REVIEW_TRENDS
- API Only
ACCOUNT_IDS
Reviews Theme Average Rating
Description: The average review of all the 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
- 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
- API Only
ACCOUNT_IDS
Rolling Average Rating
Description: Average review rating of your entities as well as your competitors entities. This metric is 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
LOCATION_NAMES
ZIP_CODE
- Reviews
PARTNERS
- API Only
ACCOUNT_IDS
Rolling Review Volume
Description: Cumulative review volume of your entities as well as 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. This metric is 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
LOCATION_NAMES
ZIP_CODE
- Reviews
PARTNERS
- API Only
ACCOUNT_IDS
Reviews Dimensions
Awaiting Response
Description: Identify 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: Identify reviews by their generation source
Request ID: GENERATION_SOURCE
Response ID: GENERATION_SOURCE
Data Type: enum: ["SMS", "QR Code", "Organic", "Email", or "Direct Link"]
Example Response Value: QR Code
Example Response: {"Reviews": 124, "GENERATION_SOURCE": "QR Code"}
Publisher Type
Description: Identify 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: Identify 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 Time
Description: Identify 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: Identify 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: Identify 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: Identify 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: Identify 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: Identify 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"}