---
title: "Get best performing posts grouped by network for a dashboard. Both impressions and interactions metrics are returned per section."
method: GET
path: "/v2/reporting/campaigns-dashboard/{dashboardId}/best-posts/by-network"
tags: ["Performance Dashboards Api Service"]
---

# Get best performing posts grouped by network for a dashboard. Both impressions and interactions metrics are returned per section.

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

## Request

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

## Path parameters

- `dashboardId` integer, required

## Response `200`

OK

- JsonOkResponsePerformanceDashboardBestPostsPerNetworkResponseDto
  - `metadata` object
  - `page` JsonPaging
    - `next` string
  - `data` PerformanceDashboardBestPostsPerNetworkResponseDto: Response containing best-performing posts grouped by network for a dashboard
    - `networks` PerformanceDashboardNetworkBestPostsDto[]: Per-network best-posts sections; empty when the dashboard does not qualify (<=1 network, or fewer than 5 eligible items, or no network with 5 items)
      - `network` string: Network identifier
      - `networkDisplayName` string: Display name of the network account
      - `networkImageUrl` string: Image URL of the network account
      - `averageImpressions` number, double: Average impressions across the network's eligible posts; null if no post has impressions
      - `averageInteractions` number, double: Average interactions across the network's eligible posts; null if no post has interactions
      - `topPostsByImpressions` PerformanceDashboardBestPostDto[]: Top posts in this network ranked by impressions (up to 5). Only includes posts with impressions > 0, so may contain fewer than 5 entries; empty when no post in the network has impressions > 0
        - `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
      - `topPostsByInteractions` PerformanceDashboardBestPostDto[]: Top posts in this network ranked by interactions (up to 5). Only includes posts with interactions > 0, so may contain fewer than 5 entries; empty when no post in the network has interactions > 0
        - `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

---

[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/aea9d9a8415a?raw)