---
title: "Get location scores via POST"
method: POST
path: "/home/locations/score"
tags: ["Homepage"]
---

# Get location scores via POST

`POST /home/locations/score`

Retrieves aggregated location scores using filter criteria provided in the request body.

## Query parameters

- `includeBenchmark` boolean, required

## Request body

- object — Request body for filtering locations by various criteria
  - `locationIds` integer[], nullable — List of location IDs to include
  - `businessIds` integer[], nullable — List of business IDs to include
  - `locationGroupIds` integer[], nullable — List of location group IDs to include
  - `labels` string[], nullable — List of labels to include
  - `excludedLocationIds` integer[], nullable — List of location IDs to exclude
  - `excludedBusinessIds` integer[], nullable — List of business IDs to exclude
  - `excludedLocationGroupIds` integer[], nullable — List of location group IDs to exclude
  - `excludedLabels` string[], nullable — List of labels to exclude
  - `filterCategory` string, nullable — Filter strategy to apply: location-groups, labels, business, or location
  - `query` string, nullable — Search query string depending on filter category

## Response `200`

Location scores retrieved successfully

- object — Response containing the overall location score, per-product scores, pillar scores, benchmark, and upsell information
  - `score` integer, nullable — Overall location score
  - `maxScore` integer, nullable — Maximum achievable score
  - `productScores` object[], nullable — List of per-product score breakdowns
    - `name` string, required — Product name
    - `completedPercentage` integer — Percentage of score completed for this product
  - `pillarScores` object — Aggregated pillar scores for visibility, reputation, and engagement
    - `visibility` integer, nullable — Visibility pillar score (0-100)
    - `reputation` integer, nullable — Reputation pillar score (0-100)
    - `engagement` integer, nullable — Engagement pillar score (0-100)
  - `benchmark` object — Benchmark score for comparison against similar locations
    - `categoryId` integer, nullable — Category identifier
    - `score` integer, nullable — Benchmark score value
  - `upsellProduct` object — Upsell product recommendation for improving the score
    - `product` string, required — Product identifier
    - `maxValue` integer — Maximum score value the product can contribute
    - `trialAvailable` boolean — Whether a free trial is available for this product
    - `isRequested` boolean — Whether the product has already been requested

## Other responses

- `400` — Invalid request parameters
- `401` — Unauthorized

---

[API](https://skmtc.net/uberall/apis/uberall-api.md) · [All operations](https://skmtc.net/uberall/apis/uberall-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/uberall/uberall-api/versions/a506e82d7cbe/schema)