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"}