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

# Get Social Selling overview

> Summarize LinkedIn performance of the caller’s Social Selling identities over a date range: posts published, impressions, reactions, comments, people reached and new people reached, compared with the previous period of the same length (`previousPeriod`, `changePct`), plus per-identity impressions, reactions, comments and new people reached (`series`; use `list_social_selling_identity_performance` for posts and people reached per identity). Requested `identityIds` the caller may not see or the workspace does not have are ignored. Same numbers as the Social Selling Overview page. Defaults to the last 30 days; only completed UTC days count (metrics are snapshotted daily at 03:00 UTC). Add `includeDaily=true` for one row per day. Read-only.

    > **Required scope:** `SOCIAL_SELLING_READ`
    >
    > **Rate limit:** 100 requests per minute



## OpenAPI

````yaml https://openapi.enginy.ai/definitions.json get /v1/social-selling/analytics/overview
openapi: 3.1.0
info:
  title: Enginy API
  version: 1.0.0
  description: Public API for Enginy platform
servers:
  - url: https://openapi.enginy.ai
    description: Configured server
security: []
tags:
  - name: AI Variables
    description: >-
      Manage AI variables and discover the entity fields you can reference in
      prompts and entity requests.
  - name: Inbox
    description: >-
      Inbox endpoints for listing contact threads, reading thread messages,
      managing tags, and sending manual replies.
  - name: Workflows
    description: >-
      Build, validate, publish, run, and inspect advanced (graph) workflows,
      plus the block/condition catalog needed to author a workflow plan.
paths:
  /v1/social-selling/analytics/overview:
    get:
      tags:
        - Social Selling
      summary: Get Social Selling overview
      description: >-
        Summarize LinkedIn performance of the caller’s Social Selling identities
        over a date range: posts published, impressions, reactions, comments,
        people reached and new people reached, compared with the previous period
        of the same length (`previousPeriod`, `changePct`), plus per-identity
        impressions, reactions, comments and new people reached (`series`; use
        `list_social_selling_identity_performance` for posts and people reached
        per identity). Requested `identityIds` the caller may not see or the
        workspace does not have are ignored. Same numbers as the Social Selling
        Overview page. Defaults to the last 30 days; only completed UTC days
        count (metrics are snapshotted daily at 03:00 UTC). Add
        `includeDaily=true` for one row per day. Read-only.

            > **Required scope:** `SOCIAL_SELLING_READ`
            >
            > **Rate limit:** 100 requests per minute
      parameters:
        - schema:
            type: string
            pattern: ^\d{4}-\d{2}-\d{2}$
            example: '2026-09-01'
            description: First day (UTC, inclusive). Defaults to 30 days before `dateTo`.
          required: false
          description: First day (UTC, inclusive). Defaults to 30 days before `dateTo`.
          name: dateFrom
          in: query
        - schema:
            type: string
            pattern: ^\d{4}-\d{2}-\d{2}$
            example: '2026-09-01'
            description: >-
              Last day (UTC, inclusive). Defaults to today. At most 366 days in
              total. Only completed days count: today (and yesterday before
              03:00 UTC) has no metrics yet.
          required: false
          description: >-
            Last day (UTC, inclusive). Defaults to today. At most 366 days in
            total. Only completed days count: today (and yesterday before 03:00
            UTC) has no metrics yet.
          name: dateTo
          in: query
        - schema:
            type:
              - array
              - 'null'
            items:
              type: integer
              exclusiveMinimum: 0
            minItems: 1
            description: >-
              List of identity ids to include (REST also accepts a
              comma-separated value). Defaults to every identity the caller may
              see; ids outside that scope are ignored.
            example: 12,34
          required: false
          description: >-
            List of identity ids to include (REST also accepts a comma-separated
            value). Defaults to every identity the caller may see; ids outside
            that scope are ignored.
          name: identityIds
          in: query
        - schema:
            type: boolean
            default: false
            description: >-
              Also return one row per day (`daily`). Off by default to keep the
              answer small.
          required: false
          description: >-
            Also return one row per day (`daily`). Off by default to keep the
            answer small.
          name: includeDaily
          in: query
      responses:
        '200':
          description: Totals of the range vs the previous period, and per identity
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: string
                    enum:
                      - success
                  message:
                    type: string
                  data:
                    type: object
                    properties:
                      dateFrom:
                        type: string
                        example: '2026-09-19'
                      dateTo:
                        type: string
                        example: '2026-10-19'
                      countedDays:
                        type: number
                        description: Completed days of the range the totals cover.
                      totals:
                        type: object
                        properties:
                          posts:
                            type: number
                            description: Posts published (reposts included).
                          impressions:
                            type: number
                          reactions:
                            type: number
                          comments:
                            type: number
                          reached:
                            type: number
                            description: >-
                              Distinct external people who engaged with posts
                              published in the period.
                          newReached:
                            type: number
                            description: People who engaged for the first time.
                        required:
                          - posts
                          - impressions
                          - reactions
                          - comments
                          - reached
                          - newReached
                      previousPeriod:
                        type: object
                        properties:
                          dateFrom:
                            type: string
                          dateTo:
                            type: string
                          totals:
                            type: object
                            properties:
                              posts:
                                type: number
                                description: Posts published (reposts included).
                              impressions:
                                type: number
                              reactions:
                                type: number
                              comments:
                                type: number
                              reached:
                                type: number
                                description: >-
                                  Distinct external people who engaged with
                                  posts published in the period.
                              newReached:
                                type: number
                                description: People who engaged for the first time.
                            required:
                              - posts
                              - impressions
                              - reactions
                              - comments
                              - reached
                              - newReached
                          fullyTracked:
                            type: boolean
                            description: >-
                              False when tracking started inside the previous
                              period, so its totals undercount.
                        required:
                          - dateFrom
                          - dateTo
                          - totals
                          - fullyTracked
                      changePct:
                        type: object
                        properties:
                          posts:
                            type:
                              - number
                              - 'null'
                          impressions:
                            type:
                              - number
                              - 'null'
                          reactions:
                            type:
                              - number
                              - 'null'
                          comments:
                            type:
                              - number
                              - 'null'
                          reached:
                            type:
                              - number
                              - 'null'
                          newReached:
                            type:
                              - number
                              - 'null'
                        required:
                          - posts
                          - impressions
                          - reactions
                          - comments
                          - reached
                          - newReached
                        description: >-
                          Percent change vs the previous period (one decimal);
                          null when the previous value is 0.
                      impressionsSource:
                        type: string
                        enum:
                          - LINKEDIN_ANALYTICS
                          - MIXED
                          - PER_POST
                        description: >-
                          LINKEDIN_ANALYTICS: LinkedIn’s own analytics for every
                          identity; PER_POST: summed per-post counters; MIXED:
                          some of each.
                      trackingStartedAt:
                        type:
                          - string
                          - 'null'
                        description: First tracked day (YYYY-MM-DD).
                      dataThrough:
                        type:
                          - string
                          - 'null'
                        description: Last day with metrics (YYYY-MM-DD).
                      computedAt:
                        type:
                          - string
                          - 'null'
                        description: When the newest metrics snapshot was taken.
                      series:
                        type: array
                        items:
                          type: object
                          properties:
                            identityId:
                              type:
                                - number
                                - 'null'
                            label:
                              type: string
                            impressionsSource:
                              type:
                                - string
                                - 'null'
                              enum:
                                - LINKEDIN_ANALYTICS
                                - PER_POST
                                - null
                            totals:
                              type: object
                              properties:
                                impressions:
                                  type: number
                                reactions:
                                  type: number
                                comments:
                                  type: number
                                newReached:
                                  type: number
                              required:
                                - impressions
                                - reactions
                                - comments
                                - newReached
                          required:
                            - identityId
                            - label
                            - impressionsSource
                            - totals
                        description: >-
                          Per identity: impressions, reactions, comments and new
                          people reached only. Posts and people reached per
                          identity: `list_social_selling_identity_performance`.
                      daily:
                        type: array
                        items:
                          type: object
                          properties:
                            date:
                              type: string
                            posted:
                              type: boolean
                            postsCount:
                              type: number
                            impressions:
                              type: number
                            reactions:
                              type: number
                            comments:
                              type: number
                            newReached:
                              type: number
                            trackingStatus:
                              type: string
                              enum:
                                - NOT_TRACKED
                                - TRACKING_STARTED
                                - TRACKED
                          required:
                            - date
                            - posted
                            - postsCount
                            - impressions
                            - reactions
                            - comments
                            - newReached
                            - trackingStatus
                        description: Only with `includeDaily=true`.
                    required:
                      - dateFrom
                      - dateTo
                      - countedDays
                      - totals
                      - previousPeriod
                      - changePct
                      - impressionsSource
                      - trackingStartedAt
                      - dataThrough
                      - computedAt
                      - series
                required:
                  - status
                  - message
                  - data
        '400':
          description: >-
            Invalid query: a date that is not YYYY-MM-DD or a day that does not
            exist (`2026-02-30`), a range over 366 days or ending before it
            starts, or malformed identity ids
        '403':
          description: >-
            Social Selling is not enabled for this workspace. Ask your workspace
            admin to enable the feature.
      security:
        - apiKey: []
components:
  securitySchemes:
    apiKey:
      type: apiKey
      in: header
      name: x-api-key

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.