Analytics · Analytics

Get LinkedIn org analytics

Fetches LinkedIn org analytics.

GEThttps://api.pozy.ai/v1/analytics/linkedin/org-aggregate-analytics
getLinkedInOrgAggregateAnalytics

Guides: LinkedIn, Platform insights

Request

Send your API key as Authorization: Bearer pz_live_.... Read-only keys can call it. Keys with the analytics resource group disabled get 403 resource_group_disabled. Authentication

Query parameters

NameTypeNotes
accountIdrequiredstring
metricsstring
fromDatestring (date)
toDatestring (date)
sincestring (date)
untilstring (date)
metricTypestringOne of time_series, total_valueDefault total_value

Example

curl -X GET "https://api.pozy.ai/v1/analytics/linkedin/org-aggregate-analytics?accountId=696e0b682d0a31188e7a2ba9" \
  -H "Authorization: Bearer $POZY_API_KEY"

Response

200 on success

  • successboolean
  • accountIdstring
  • platformstring

    One of facebook, instagram, youtube, linkedin, tiktok.

  • dateRangeobject
    • sincestring (date)
    • untilstring (date)
  • metricTypestring

    One of time_series, total_value.

  • breakdownstring
  • metricsmap of object

    Keys are free-form; each value has these fields.

    • totalnumber
    • valuesarray of object
      2 child fields
      • datestring (date)
      • valuenumber
    • breakdownsarray of object
      2 child fields
      • dimensionstring
      • valuenumber
    • unitstring

      One of micro_amount, unspecified.

    • currencystring

      Can be null.

  • unavailableMetricsarray of object
    • metricstring
    • reasonstring

      One of not_enrolled, permission_missing, unsupported_metric, no_data, unreadable_value, mixed_currency, upstream_error.

    • messagestring
  • dataDelaystring
200 response
{
  "success": true,
  "accountId": "696e0b682d0a31188e7a2ba9",
  "platform": "facebook",
  "dateRange": {
    "since": "2026-10-01",
    "until": "2026-10-01"
  },
  "metricType": "time_series",
  "breakdown": "string",
  "metrics": {
    "key": {
      "total": 12.5,
      "values": [
        {
          "date": "2026-10-02T09:00:00.000Z",
          "value": 12.5
        }
      ],
      "breakdowns": [
        {
          "dimension": "string",
          "value": 12.5
        }
      ],
      "unit": "micro_amount",
      "currency": "USD"
    }
  },
  "unavailableMetrics": [
    {
      "metric": "string",
      "reason": "not_enrolled",
      "message": "Hello from Pozy"
    }
  ],
  "dataDelay": "string"
}

Errors

Errors use one shape: { error, type, code, param?, details? }. The ones you are most likely to see here:

400invalid_request_errorA parameter or body field is missing or invalid. param names it.
401authentication_errorThe API key is missing, revoked or expired.
403permission_errorThe key is scoped to other profiles or has this resource group disabled.
429rate_limit_errorToo many requests this minute. Wait for Retry-After seconds.

Every code is listed in Errors.

More in Analytics