---
title: "Ranking Metrics For Multiple Properties"
method: POST
path: "/v1/reports/ranking-overview/multi"
tags: ["Ranking Reports"]
---

# Ranking Metrics For Multiple Properties

`POST /v1/reports/ranking-overview/multi`

Returns the <<glossary:Ranking>> for all the requested entities within a selected scope :<br/> <ul> <li> Chain scope - compares each entity <<glossary:Ranking>> vs all other chain’s entities.</li> <li>Group category scope - compares each entity <<glossary:Ranking>> vs all venues under the selected group category (Apparel, Leisure, …).</li> <li>Category scope - compares each entity <<glossary:Ranking>> vs all venues under the selected category (Regional Mall, Industrial, …).</li> </ul> The service supports <<glossary:Ranking>> based on pre-defined periods. (In case a custom date range is required use /reports/ranking-overview endpoint).<br/><br/><strong>&#x21e1; This service supports bulk request</strong><br/>

&#x23F1; <strong>Average measured processing time: 3.58 seconds </strong><br/> For more information on request retries best practices and   processing measurements you may visit <a href="https://docs.placer.ai/reference/measurements"> this</a> page<br/><br/> NOTE: <<glossary:Flagged entities>> will not be taken into consideration in the resulting report

## Request body

- RankingRequestMulti — Returns the <<glossary:Ranking>> metrics for given property in all regions.
  - `apiIds` ApiId[], required
  - `period` 'last3Months' | 'last6Months' | 'last12Months' | 'lastWeek' | 'lastMonth' | 'lastQuarter' | 'yearToDate' | 'year2018' | 'year2019' | 'year2020' | 'year2021' | 'year2022' | 'year2023' | 'year2024' | 'year2025', nullable, required — The time period for which the <<glossary:Ranking>> will be calculated. Cannot be used along with startDate and endDate
  - `scope` 'chain' | 'category' | 'groupCategory', required
  - `metric` 'visitsPerSqft' | 'visits', required

## Response `200`

200 response

- RankingResponseMulti[]
  - `apiId` string — Placer API Entity Id
  - `metricType` string
  - `info` RankingEntityInfo
    - `name` string — Entity name
    - `entityId` string — Entity ID
    - `entityType` 'venue' | 'complex' | 'chain' — Entity Type (i.e. venue, complex etc.)
    - `flagged` boolean — Flagging status for entity
    - `rankedBy` string — the scope which the <<glossary:Ranking>> has been ranked by
    - `categoryInfo` CategoryInfo — Property’s categorization
      - `category` string
      - `group` string
      - `subCategory` string
    - `parentChain` string — The name of the chain that entity belongs to
  - `ranking` union
    - RankingMetrics — <<glossary:Ranking>> info for a property
      - `nationwide` RankingRegionObjectNationwide
        - `rank` integer
        - `percentile` integer
        - `rankedOutOf` integer
        - `regionCode` string
      - `state` RankingRegionObjectState
        - `rank` integer
        - `percentile` integer
        - `rankedOutOf` integer
        - `regionCode` string
      - `dma` RankingRegionObjectDma
        - `rank` integer
        - `percentile` integer
        - `rankedOutOf` integer
        - `regionCode` string
      - `cbsa` RankingRegionObjectCbsa
        - `rank` integer
        - `percentile` integer
        - `rankedOutOf` integer
        - `regionCode` string
    - object
      - `rankError` string — The error that was occuerd while trying to get <<glossary:Ranking>> for that entity
  - `visitDurationSegmentation` 'under10Min' | '10MinOrLonger' | 'allVisits' | 'mixedSegments', nullable — Represents the requested visit duration segmentation.<br> If the default visit duration segmentation is requested, the visitDurationSegmentation will display the actual segment.<br> In cases where the default segment was requested for a chain, in which the list of entities used different default segments for the report calculation, the visitDurationSegmentation will be set to 'mixedSegments'.

## Other responses

- `400` — 400 Bad Request
- `403` — 403 Permission Denied
- `500` — 500 Internal Server Error

---

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