Skip to main content

Description

Returns locations ranked by experience score — either the highest-scoring locations first or the lowest-scoring first — along with sentiment, reputation, and listing scores and delta comparisons vs a prior period. Use this to quickly surface top or bottom performers instead of scanning the full location list. The response contains:
  • totalCount — total number of matching locations
  • dataPoints (array) — one entry per location, each with:
    • id — location business number
    • name — location name
    • experienceScore, reputationScore, sentimentScore, listingScore — current period scores
    • experienceDeltaScore, reputationDeltaScore, sentimentDeltaScore, listingDeltaScore — prior period scores
    • experienceDelta, reputationDelta, sentimentDelta, listingDelta — point change vs prior period (positive = improvement)
businessNumbers is required for this tool. Call get_child_locations first to get valid businessNumber values. If the user has not specified which locations to include, present the available locations and ask them to choose before calling this tool.

Parameters

Required

Optional

Example Usage