---
title: "List post analytics for an integration"
method: GET
path: "/v1/workspaces/{workspaceId}/analytics/posts"
tags: ["Analytics"]
---

# List post analytics for an integration

`GET /v1/workspaces/{workspaceId}/analytics/posts`

## Request

- Base URL: `https://api.maevesocial.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.maevesocial.com/v1/workspaces/{workspaceId}/analytics/posts`
- Auth: HTTP bearer

## Path parameters

- `workspaceId` string, uuid, required

## Query parameters

- `integrationId` string, uuid, required
- `limit` integer, nullable
- `offset` integer, nullable
- `postType` string[]: Comma-separated post types: post, reel, short, story, thread, article, poll, document, event, offer.
- `mediaFormat` string[]: Comma-separated media formats: text, image, gif, video, carousel.

## Response `200`

Post analytics list

- object
  - `data` PublicAnalyticsPostsResponseDto, required
    - `posts` PublicAnalyticsPostDto[], required
      - `id` string, required
      - `contentId` string, uuid
      - `postId` string, uuid, nullable: Root post UUID used by root-post reuse actions. contentId remains the analytics edition UUID.
      - `origin` 'user_created' | 'platform_import': Canonical content origin. platform_import posts are imported reference records and cannot be reused as normal drafts.
      - `platformId` string, required
      - `integrationId` string, uuid
      - `platform` string
      - `type` 'image' | 'video' | 'carousel' | 'story' | 'text', required: Analytics type: story for a Story, otherwise the attachment shape. A gif reports image.
      - `postType` 'post' | 'reel' | 'short' | 'story' | 'thread' | 'article' | 'poll' | 'document' | 'event' | 'offer': Platform surface, such as post, reel, short (YouTube Short), story, document or event.
      - `mediaFormat` 'text' | 'image' | 'gif' | 'video' | 'carousel': Attachment shape: text, image, gif, video, or carousel for two or more items.
      - `thumbnailUrl` string, required
      - `permalink` string, required
      - `caption` string, required
      - `postedAt` string, required
      - `impressions` number, required
      - `reach` number, required
      - `likes` number, required
      - `comments` number, required
      - `shares` number, required
      - `saves` number, required
      - `engagementRate` number, required
      - `metrics` object
      - `warnings` PublicAnalyticsWarningDto[]
        - `code` string, required
        - `message` string, required
        - `severity` 'info' | 'warning' | 'error', required
        - `metadata` object
      - `valueSemantics` 'lifetime' | 'windowed': lifetime: the total to date. windowed: counted within the requested period only.
      - `allowedActions` PublicAnalyticsPostAllowedActionsDto
        - `canReuseAsDraft` boolean, required
    - `warnings` PublicAnalyticsWarningDto[]
      - `code` string, required
      - `message` string, required
      - `severity` 'info' | 'warning' | 'error', required
      - `metadata` object
    - `dataQuality` PublicAnalyticsDataQualityDto
      - `status` 'complete' | 'partial' | 'stale' | 'cached_error' | 'refreshing', required
      - `lastSuccessfulFetch` string
      - `cacheAge` number
      - `missingMetrics` string[]
  - `meta` unknown, required

---

[API](https://skmtc.dev/maevesocial/apis/maeve-social-api.md) · [All operations](https://skmtc.dev/maevesocial/apis/maeve-social-api/llms.txt) · [OpenAPI document](https://skmtc.dev/maevesocial/apis/maeve-social-api/revisions/1b00fd7e4b15?raw)