Documentation menu

Instagram account insights

Views, reach, interactions, and accounts engaged over 28 days.

GEThttps://app.tryadeli.com/api/v1/analytics/instagram/account-insights

AuthorizationBearer <API key>How keys work

Request

curl --fail-with-body "https://app.tryadeli.com/api/v1/analytics/instagram/account-insights?accountId=00000000-0000-4000-8000-000000000003" \
  -H "Authorization: Bearer $ADELI_API_KEY"

Response

{
  "platform": "instagram",
  "accountId": "00000000-0000-4000-8000-000000000003",
  "profileId": "00000000-0000-4000-8000-000000000001",
  "insights": [{ "name": "reach", "values": [] }],
  "fetchedAt": "2026-04-01T12:00:00.000Z"
}

Returns Instagram's own insight records for a rolling 28-day window, covering views, reach, total_interactions, and accounts_engaged.

Query parameters

accountIduuidRequired: A connected Instagram account.
profileIduuid: Optional, because accountId names its profile. If you pass both, they must agree.

An empty insights array is normal

Instagram omits metrics entirely for accounts with too few followers or too little history, and its data lags by up to 48 hours. Render a missing metric as unavailable rather than as zero — they mean different things.

insights is Instagram's array, passed through unchanged. Adeli does not store history, so each call is a live read.

Errors — 401 unauthorized, 400 invalid_request, 404 account_not_found, 404 profile_not_found, 422 connection_expired, 422 provider_not_configured, 502 provider_error.