> ## Documentation Index
> Fetch the complete documentation index at: https://info.bundle.social/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Bulk Post Analytics

> Retrieve analytics for multiple posts in a single request. Maximum 60 posts per request, paginated with 20 per page.



## OpenAPI

````yaml https://api.bundle.social/swagger-json get /api/v1/analytics/post/bulk
openapi: 3.0.2
info:
  title: bundle.social API
  description: >-
    REST API for social media management. Perfect for AI assistants, GPTs,
    automation tools, and integrations. Post to 14+ platforms including Twitter,
    Instagram, Facebook, LinkedIn, TikTok, Pinterest, Reddit, Discord, Slack,
    YouTube, Mastodon, Bluesky, Threads, and Google Business. Schedule posts,
    manage content, analyze performance, and automate your social media workflow
    across all platforms.
  version: 1.0.0
  contact:
    email: contact@bundle.social
  termsOfService: https://bundle.social/terms
servers:
  - url: https://api.bundle.social
  - url: http://localhost:3001
security:
  - ApiKeyAuth: []
tags:
  - name: app
  - name: organization
  - name: team
  - name: socialAccount
  - name: upload
  - name: post
  - name: postImport
  - name: analytics
  - name: comment
  - name: misc
  - name: postCSV
paths:
  /api/v1/analytics/post/bulk:
    get:
      tags:
        - analytics
      summary: Get Bulk Post Analytics
      description: >-
        Retrieve analytics for multiple posts in a single request. Maximum 60
        posts per request, paginated with 20 per page.
      operationId: analytics.getBulkPostAnalytics
      parameters:
        - name: postIds
          in: query
          required: true
          schema:
            type: array
            items:
              type: string
            minItems: 1
            maxItems: 60
        - name: platformType
          in: query
          required: true
          schema:
            type: string
            enum:
              - TIKTOK
              - YOUTUBE
              - INSTAGRAM
              - FACEBOOK
              - THREADS
              - REDDIT
              - PINTEREST
              - MASTODON
              - LINKEDIN
              - BLUESKY
              - GOOGLE_BUSINESS
              - SNAPCHAT
        - name: page
          in: query
          schema:
            default: 1
            type: number
            minimum: 1
        - name: limit
          in: query
          schema:
            default: 20
            type: number
            minimum: 1
            maximum: 20
      responses:
        '200':
          description: '200'
          content:
            application/json:
              schema:
                type: object
                properties:
                  results:
                    type: array
                    items:
                      type: object
                      properties:
                        postId:
                          type: string
                        items:
                          type: array
                          items:
                            type: object
                            properties:
                              id:
                                type: string
                              profilePostId:
                                type: string
                              impressions:
                                type: number
                              impressionsUnique:
                                type: number
                              views:
                                type: number
                              viewsUnique:
                                type: number
                              likes:
                                type: number
                              dislikes:
                                type: number
                              comments:
                                type: number
                              shares:
                                type: number
                              saves:
                                type: number
                              raw:
                                nullable: true
                              forced:
                                type: boolean
                              createdAt:
                                type: string
                                format: date-time
                                nullable: true
                              updatedAt:
                                type: string
                                format: date-time
                                nullable: true
                              deletedAt:
                                type: string
                                format: date-time
                                nullable: true
                            required:
                              - id
                              - profilePostId
                              - impressions
                              - impressionsUnique
                              - views
                              - viewsUnique
                              - likes
                              - dislikes
                              - comments
                              - shares
                              - saves
                              - forced
                              - createdAt
                              - updatedAt
                        error:
                          type: string
                          nullable: true
                      required:
                        - postId
                        - items
                        - error
                  pagination:
                    type: object
                    properties:
                      page:
                        type: number
                      limit:
                        type: number
                      total:
                        type: number
                      totalPages:
                        type: number
                    required:
                      - page
                      - limit
                      - total
                      - totalPages
                required:
                  - results
                  - pagination
        '400':
          description: '400'
          content:
            application/json:
              schema:
                type: object
                properties:
                  statusCode:
                    type: number
                    nullable: true
                  message:
                    type: string
                  issues:
                    type: array
                    items:
                      type: object
                      properties:
                        code:
                          type: string
                          enum:
                            - invalid_type
                            - invalid_literal
                            - custom
                            - invalid_union
                            - invalid_union_discriminator
                            - invalid_enum_value
                            - unrecognized_keys
                            - invalid_arguments
                            - invalid_return_type
                            - invalid_date
                            - invalid_string
                            - too_small
                            - too_big
                            - invalid_intersection_types
                            - not_multiple_of
                            - not_finite
                          nullable: true
                        message:
                          type: string
                        path:
                          type: array
                          items:
                            oneOf:
                              - type: string
                              - type: number
                          nullable: true
                      required:
                        - message
                    nullable: true
                required:
                  - message
        '401':
          description: '401'
          content:
            application/json:
              schema:
                type: object
                properties:
                  statusCode:
                    type: number
                    nullable: true
                  message:
                    type: string
                required:
                  - message
        '403':
          description: '403'
          content:
            application/json:
              schema:
                type: object
                properties:
                  statusCode:
                    type: number
                    nullable: true
                  message:
                    type: string
                required:
                  - message
        '404':
          description: '404'
          content:
            application/json:
              schema:
                type: object
                properties:
                  statusCode:
                    type: number
                    nullable: true
                  message:
                    type: string
                required:
                  - message
        '429':
          description: '429'
          content:
            application/json:
              schema:
                type: object
                properties:
                  statusCode:
                    type: number
                    nullable: true
                  message:
                    type: string
                required:
                  - message
        '500':
          description: '500'
          content:
            application/json:
              schema:
                type: object
                properties:
                  statusCode:
                    type: number
                    nullable: true
                  message:
                    type: string
                required:
                  - message
components:
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      name: x-api-key
      in: header

````