Retrieve analytics data for multiple social media accounts. Provides metrics for the last 7 days with comparison to the previous 7 days. Supports filtering by platforms and specific connected accounts.

http
POST https://services.leadconnectorhq.com/social-media-posting/statistics

Authorization

NameTypeRequiredExampleDescription
AuthorizationstringYesBearer token generated from the Leadway portal. See Authentication.
VersionstringYes2021-07-28API version.

Query parameters

NameTypeRequiredExampleDescription
locationIdstringYesw37swmmLbA02zgqKPpxITe2Account ID

Body

NameTypeRequiredExampleDescription
profileIdsstring[]YesArray of connected social media account IDs to fetch analytics for. This can be found as 'profileId' in /accounts api.
platformsstring[]NoArray of social media platforms to filter analytics by. If not provided, all platforms will be included. NOTE: Linkedin (PAGE only) and Tiktok (BUSINESS only) are supported.

Responses

201 - Successfully retrieved analytics data
  • results (object): Analytics data grouped by metrics and platforms

    • dayRange (string[]): Array of day names for the analytics period

    • totals (object): Aggregated metrics totals

      • posts (number)

      • likes (number)

      • followers (number)

      • impressions (number)

      • comments (number)

    • postPerformance (object): Post performance metrics over time

      • posts (object)

      • impressions (number[])

      • likes (number[])

      • comments (number[])

    • breakdowns (object): Detailed breakdowns by metric and platform

      • posts (object)

        • total (number)

        • totalChange (number)

        • platforms (object)

      • impressions (object)

        • total (number)

        • totalChange (number)

        • platforms (object)

      • reach (object)

        • total (number)

        • totalChange (number)

        • platforms (object)

      • engagement (object)

    • platformTotals (object): Platform-wise totals with time series data

      • impressions (object)

      • followers (object)

      • likes (object)

    • demographics (object): Demographic data breakdown

      • gender (object)

        • totals (object)

          • male (object)

          • female (object)

          • unknown (object)

      • age (object)

        • totals (object)

          • 13-17 (number)

          • 18-24 (number)

          • 25-34 (number)

          • 35-44 (number)

          • 45-54 (number)

          • 55-64 (number)

          • 65+ (number)

  • message (string): Example: Analytics Built Successfully

  • traceId (string): Example: 42fc8dd8-d55b-475f-944f-9efb90d77564

json
{
  "results": {
    "dayRange": [
      "Mon",
      "Tue",
      "Wed",
      "Thu",
      "Fri",
      "Sat",
      "Sun"
    ],
    "totals": {
      "posts": 0,
      "likes": 0,
      "followers": 0,
      "impressions": 0,
      "comments": 0
    },
    "postPerformance": {
      "posts": {
        "google": [
          0,
          0,
          0,
          0,
          0,
          0,
          0
        ]
      },
      "impressions": [
        0,
        0,
        0,
        0,
        0,
        0,
        0
      ],
  // truncado: 136 lineas mas
}
400 - Bad Request - Occurs when more than 100 accounts are requested or invalid parameters are provided
json
{}
401 - Unauthorized - Invalid or missing authentication credentials
json
{}
422 - Unprocessable Entity - Invalid request body format
json
{}

Example

curl -X POST 'https://services.leadconnectorhq.com/social-media-posting/statistics' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Version: 2021-07-28' \
  -H 'Content-Type: application/json' \
  -d '{
  "profileIds": [
    "67a5a9aa776c837de4aa5b12"
  ],
  "platforms": [
    "facebook",
    "instagram"
  ]
}'

Last updated October 26, 2026

Was this page helpful?