---
title: "Get best performing posts for a dashboard, ranked by the selected metric."
method: GET
path: "/v2/reporting/campaigns-dashboard/{dashboardId}/best-posts"
tags: ["Performance Dashboards Api Service"]
---

# Get best performing posts for a dashboard, ranked by the selected metric.

`GET /v2/reporting/campaigns-dashboard/{dashboardId}/best-posts`

## Request

- Base URL: `https://app.metricool.com/api`
- URL: `https://app.metricool.com/api/v2/reporting/campaigns-dashboard/{dashboardId}/best-posts`
- Auth: none declared

## Path parameters

- `dashboardId` integer, required

## Query parameters

- `metric` string, required

## Response `200`

OK

- JsonOkResponsePerformanceDashboardBestPostsResponseDto
  - `metadata` object
  - `page` JsonPaging
    - `next` string
  - `data` PerformanceDashboardBestPostsResponseDto: Response containing the best-performing posts for a dashboard
    - `bestPosts` PerformanceDashboardBestPostDto[]: List of best-performing posts ranked by the selected metric
      - `contentId` string: Content ID of the post
      - `network` string: Network where the post was published
      - `type` string: Type of the post
      - `thumbnail` string: Thumbnail URL of the post
      - `caption` string: Caption text of the post
      - `link` string: URL of the post on the social network
      - `publicationDate` DateTimeInfo
        - `dateTime` string, required: Local Date-time represented with a certain timezone
        - `timezone` string: Timezone applied to the datetime
      - `impressions` number, double: Number of impressions
      - `interactions` number, double: Number of interactions
      - `improvementPercentage` number, double: Improvement percentage over the average metric value
      - `networkDisplayName` string: Display name of the network account
      - `networkImageUrl` string: Image URL of the network account
      - `collaborativeOwnerUsername` string: Username of the collaborating account owner, when this best post is a collaborative post; absent otherwise
      - `isCollaborative` boolean
    - `metric` string: Metric used to rank the posts
    - `averageMetricValue` number, double: Average value of the selected metric across all dashboard content

---

[API](https://skmtc.dev/metricool/apis/metricool-api.md) · [All operations](https://skmtc.dev/metricool/apis/metricool-api/llms.txt) · [OpenAPI document](https://skmtc.dev/metricool/apis/metricool-api/revisions/e80d55f71a08?raw)