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

# Campaigns analytics roll-up

> The campaigns insights tab in one response for the whole account (every campaign the token owner can see): email send volume split AI vs manual per bucket, LinkedIn connection metrics with month-over-month deltas, the LinkedIn time series (performanceOverTime, engagementActivity and aiVsManual share the same buckets) and the top 10 LinkedIn campaigns by acceptance rate. Buckets are daily (MM/DD) for 7d and weekly (Wxx, ISO week) for 30d and 90d; rates are percentages and the delta keys compare against the previous window, so they can be negative. Each of the four panels is computed independently and is null when its aggregation fails, so always null-check them. Per-campaign detail stays on GET /business/campaigns/{campaignId}/stats. Rate limit: 20 requests per minute, 1000 per day.

Errors:
- `422` `VALIDATION_FAILED` — `range` was sent and is not one of 7d, 30d or 90d.
- `429` `RATE_LIMITED` — Per-user quota for this endpoint family exceeded (20 per minute, 1000 per day); retry after the Retry-After / RateLimit-Reset seconds.

Requires one of the following token scopes: analytics.



## OpenAPI

````yaml /openapi.json get /business/analytics/campaigns
openapi: 3.1.0
info:
  title: Fuse Business API
  version: 1.0.0
  description: >-
    External API for lists, campaigns, prospect search and contacts.
    Authenticate with your API token as HTTP Basic. All paths are under /api/v1.
servers:
  - url: https://api.tryfuse.ai/api/v1
    description: Production
security:
  - basicAuth: []
tags:
  - name: Lists
  - name: Custom columns
  - name: Smart columns
  - name: Exports
  - name: Campaigns
  - name: Knowledge hubs
  - name: Analytics
  - name: Website intent
  - name: Account
  - name: Prospect search
  - name: Campaign steps
  - name: Scheduled sends
  - name: Campaign templates
  - name: Agents
  - name: Research
  - name: Company search
  - name: Saved searches
  - name: Folders
  - name: Contacts
paths:
  /business/analytics/campaigns:
    get:
      tags:
        - Analytics
      summary: Campaigns analytics roll-up
      description: >-
        The campaigns insights tab in one response for the whole account (every
        campaign the token owner can see): email send volume split AI vs manual
        per bucket, LinkedIn connection metrics with month-over-month deltas,
        the LinkedIn time series (performanceOverTime, engagementActivity and
        aiVsManual share the same buckets) and the top 10 LinkedIn campaigns by
        acceptance rate. Buckets are daily (MM/DD) for 7d and weekly (Wxx, ISO
        week) for 30d and 90d; rates are percentages and the delta keys compare
        against the previous window, so they can be negative. Each of the four
        panels is computed independently and is null when its aggregation fails,
        so always null-check them. Per-campaign detail stays on GET
        /business/campaigns/{campaignId}/stats. Rate limit: 20 requests per
        minute, 1000 per day.


        Errors:

        - `422` `VALIDATION_FAILED` — `range` was sent and is not one of 7d, 30d
        or 90d.

        - `429` `RATE_LIMITED` — Per-user quota for this endpoint family
        exceeded (20 per minute, 1000 per day); retry after the Retry-After /
        RateLimit-Reset seconds.


        Requires one of the following token scopes: analytics.
      operationId: getCampaignAnalytics
      parameters:
        - name: range
          in: query
          required: false
          description: >-
            Rolling window ending now: 7d, 30d (default) or 90d, i.e. the
            roll-up covers the last 7, 30 or 90 days; time-series bucket sizes
            (daily, weekly, monthly) are chosen from the window length.
          schema:
            type: string
            enum:
              - 7d
              - 30d
              - 90d
            default: 30d
            description: >-
              Rolling window ending now: 7d, 30d (default) or 90d, i.e. the
              roll-up covers the last 7, 30 or 90 days; time-series bucket sizes
              (daily, weekly, monthly) are chosen from the window length.
      responses:
        '200':
          description: Success
          headers:
            RateLimit-Limit:
              schema:
                type: integer
              description: Requests permitted in the current window.
            RateLimit-Remaining:
              schema:
                type: integer
              description: Requests remaining in the current window.
            RateLimit-Reset:
              schema:
                type: integer
              description: Seconds until the current window resets.
          content:
            application/json:
              schema:
                type: object
                properties:
                  range:
                    type: string
                    enum:
                      - 7d
                      - 30d
                      - 90d
                  email:
                    type: object
                    properties:
                      aiManualVolumeTrend:
                        type:
                          - array
                          - 'null'
                        items:
                          type: object
                          properties:
                            date:
                              type: string
                            ai:
                              type: integer
                            manual:
                              type: integer
                            total:
                              type: integer
                          required:
                            - date
                            - ai
                            - manual
                            - total
                    required:
                      - aiManualVolumeTrend
                  linkedin:
                    type: object
                    properties:
                      connectionMetrics:
                        type:
                          - object
                          - 'null'
                        properties:
                          totalSent:
                            type: number
                          totalReplied:
                            type: number
                          totalInvitesSent:
                            type: number
                          totalInvitesAccepted:
                            type: number
                          inmailsSent:
                            type: number
                          profileVisits:
                            type: number
                          postsLiked:
                            type: number
                          totalPositive:
                            type: number
                          positiveReplyRate:
                            type: number
                          totalManual:
                            type: number
                          totalAI:
                            type: number
                          totalBounced:
                            type: number
                          repliedRate:
                            type: number
                          invitesAcceptedRate:
                            type: number
                          bounceRate:
                            type: number
                          deliverabilityRate:
                            type: number
                          manualRate:
                            type: number
                          aiRate:
                            type: number
                          sentDeltaOverLastMonth:
                            type: number
                          repliedDeltaOverLastMonth:
                            type: number
                          invitesSentDeltaOverLastMonth:
                            type: number
                          invitesAcceptedDeltaOverLastMonth:
                            type: number
                          inmailsSentDeltaOverLastMonth:
                            type: number
                          profileVisitsDeltaOverLastMonth:
                            type: number
                          postsLikedDeltaOverLastMonth:
                            type: number
                          acceptanceRate:
                            type: number
                          connectionReplyRate:
                            type: number
                        required:
                          - totalSent
                          - totalReplied
                          - totalInvitesSent
                          - totalInvitesAccepted
                          - inmailsSent
                          - profileVisits
                          - postsLiked
                          - totalPositive
                          - positiveReplyRate
                          - totalManual
                          - totalAI
                          - totalBounced
                          - repliedRate
                          - invitesAcceptedRate
                          - bounceRate
                          - deliverabilityRate
                          - manualRate
                          - aiRate
                          - sentDeltaOverLastMonth
                          - repliedDeltaOverLastMonth
                          - invitesSentDeltaOverLastMonth
                          - invitesAcceptedDeltaOverLastMonth
                          - inmailsSentDeltaOverLastMonth
                          - profileVisitsDeltaOverLastMonth
                          - postsLikedDeltaOverLastMonth
                          - acceptanceRate
                          - connectionReplyRate
                      connectionTimeSeries:
                        type:
                          - object
                          - 'null'
                        properties:
                          performanceOverTime:
                            type: array
                            items:
                              type: object
                              properties:
                                date:
                                  type: string
                                connectionsSent:
                                  type: integer
                                connectionsAccepted:
                                  type: integer
                                acceptanceRate:
                                  type: number
                                repliesReceived:
                                  type: integer
                                replyRate:
                                  type: number
                                positiveRepliesReceived:
                                  type: integer
                                positiveReplyRate:
                                  type: number
                              required:
                                - date
                                - connectionsSent
                                - connectionsAccepted
                                - acceptanceRate
                                - repliesReceived
                                - replyRate
                                - positiveRepliesReceived
                                - positiveReplyRate
                          engagementActivity:
                            type: array
                            items:
                              type: object
                              properties:
                                date:
                                  type: string
                                invitesSent:
                                  type: integer
                                invitesAccepted:
                                  type: integer
                                repliesReceived:
                                  type: integer
                              required:
                                - date
                                - invitesSent
                                - invitesAccepted
                                - repliesReceived
                          aiVsManual:
                            type: array
                            items:
                              type: object
                              properties:
                                date:
                                  type: string
                                aiMessagesSent:
                                  type: integer
                                templatedMessagesSent:
                                  type: integer
                                totalMessagesSent:
                                  type: integer
                              required:
                                - date
                                - aiMessagesSent
                                - templatedMessagesSent
                                - totalMessagesSent
                        required:
                          - performanceOverTime
                          - engagementActivity
                          - aiVsManual
                      topCampaigns:
                        type:
                          - array
                          - 'null'
                        items:
                          type: object
                          properties:
                            campaignId:
                              type: string
                            campaignName:
                              type: string
                            connectionRequestsSent:
                              type: integer
                            connectionsAccepted:
                              type: integer
                            repliesReceived:
                              type: integer
                            positiveRepliesReceived:
                              type: integer
                            acceptanceRate:
                              type: number
                            connectionReplyRate:
                              type: number
                            positiveReplyRate:
                              type: number
                          required:
                            - campaignId
                            - campaignName
                            - connectionRequestsSent
                            - connectionsAccepted
                            - repliesReceived
                            - positiveRepliesReceived
                            - acceptanceRate
                            - connectionReplyRate
                            - positiveReplyRate
                    required:
                      - connectionMetrics
                      - connectionTimeSeries
                      - topCampaigns
                required:
                  - range
                  - email
                  - linkedin
              example:
                range: 30d
                email:
                  aiManualVolumeTrend:
                    - date: W31
                      ai: 20
                      manual: 12
                      total: 32
                    - date: W32
                      ai: 0
                      manual: 34
                      total: 34
                linkedin:
                  connectionMetrics:
                    totalSent: 183
                    totalReplied: 104
                    totalInvitesSent: 156
                    totalInvitesAccepted: 193
                    inmailsSent: 6
                    profileVisits: 46
                    postsLiked: 14
                    totalPositive: 11
                    positiveReplyRate: 10.58
                    totalManual: 154
                    totalAI: 33
                    totalBounced: 94
                    repliedRate: 55.03
                    invitesAcceptedRate: 123.72
                    bounceRate: 49.74
                    deliverabilityRate: 50.26
                    manualRate: 82.35
                    aiRate: 17.65
                    sentDeltaOverLastMonth: -18.37
                    repliedDeltaOverLastMonth: 1200
                    invitesSentDeltaOverLastMonth: 8.1
                    invitesAcceptedDeltaOverLastMonth: 3.4
                    inmailsSentDeltaOverLastMonth: 0
                    profileVisitsDeltaOverLastMonth: 5
                    postsLikedDeltaOverLastMonth: 0
                    acceptanceRate: 123.72
                    connectionReplyRate: 53.89
                  connectionTimeSeries:
                    performanceOverTime:
                      - date: W31
                        connectionsSent: 130
                        connectionsAccepted: 40
                        acceptanceRate: 30.77
                        repliesReceived: 11
                        replyRate: 27.5
                        positiveRepliesReceived: 4
                        positiveReplyRate: 36.36
                    engagementActivity:
                      - date: W31
                        invitesSent: 130
                        invitesAccepted: 38
                        repliesReceived: 10
                    aiVsManual:
                      - date: W31
                        aiMessagesSent: 15
                        templatedMessagesSent: 7
                        totalMessagesSent: 22
                  topCampaigns:
                    - campaignId: 69c50c3da19bd0c24ab4b503
                      campaignName: Qa linkedin campaign
                      connectionRequestsSent: 132
                      connectionsAccepted: 130
                      repliesReceived: 29
                      positiveRepliesReceived: 0
                      acceptanceRate: 98.48
                      connectionReplyRate: 22.31
                      positiveReplyRate: 0
        '400':
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '401':
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '402':
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '403':
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '404':
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '409':
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '422':
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '429':
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '500':
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      security:
        - basicAuth: []
components:
  schemas:
    Error:
      type: object
      properties:
        error:
          type: object
          properties:
            code:
              type: string
            message:
              type: string
            param:
              type:
                - string
                - 'null'
            doc_url:
              type:
                - string
                - 'null'
            request_id:
              type:
                - string
                - 'null'
          required:
            - code
            - message
      required:
        - error
  securitySchemes:
    basicAuth:
      type: http
      scheme: basic
      description: >-
        Your API token (`af_…`) as the Basic-auth username, with an empty
        password.

````