Zernio icon

Zernio

Schedule and manage social media posts across multiple platforms with Zernio - supporting Twitter/X, Instagram, Facebook, LinkedIn, TikTok, YouTube, Threads, Bluesky, Pinterest, Reddit, Telegram, Google Business, and Snapchat

Actions115

Analytics → Instagram Account Insights

AI-generated

Summary

Fetch Instagram account insights metrics over a specified date range, optionally filtered by account ID, with control over metric types and breakdown dimensions.

Inputs

  • Account ID — The specific Instagram social account ID to filter the insights data.
  • Metrics — Comma-separated list of metrics to retrieve, defaulting to 'reach,views,accounts_engaged,total_interactions' if left empty.
  • Since — Start date (YYYY-MM-DD) for the insights data range; defaults to 30 days before the current date if omitted.
  • Until — End date (YYYY-MM-DD) for the insights data range; defaults to the current date if omitted.
  • Metric Type (required) — Specify 'total_value' to get aggregated totals (supports breakdowns) or 'time_series' to get daily values (only works with 'reach' metric).
  • Breakdown — Dimension to break down the 'total_value' metrics by; valid values depend on the metric, e.g., 'media_product_type', 'follow_type', etc.

Output shape

A list of Instagram account insights data entries matching the specified parameters, including either aggregated totals or time series daily values depending on Metric Type.

If Metric Type is 'time_series', only the 'reach' metric is supported. The response structure varies by the selected metrics and breakdown dimension. Defaults for date range and metrics apply if parameters are omitted.

Links

Discussion