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
RATINGS
RESPONSE_TIME
REVIEW_KEYWORDS
REVIEW_LABELS
REVIEW_STATUS
SENTIMENT_COLLECTION
PARTNERS
- 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
RATINGS
RESPONSE_TIME
REVIEW_KEYWORDS
REVIEW_LABELS
REVIEW_STATUS
SENTIMENT_COLLECTION
PARTNERS
- 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
RATINGS
RESPONSE_TIME
REVIEW_KEYWORDS
REVIEW_LABELS
REVIEW_STATUS
SENTIMENT_COLLECTION
PARTNERS
- 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
RATINGS
RESPONSE_TIME
REVIEW_KEYWORDS
REVIEW_LABELS
REVIEW_STATUS
SENTIMENT_COLLECTION
PARTNERS
- 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
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
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
RATINGS
RESPONSE_TIME
REVIEW_KEYWORDS
REVIEW_LABELS
REVIEW_STATUS
SENTIMENT_COLLECTION
PARTNERS
- 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.
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.
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"}
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.
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"}