---
title: "Instagram engagement rate calculator"
method: GET
path: "/v1/insights"
tags: ["Engagement"]
---

# Instagram engagement rate calculator

`GET /v1/insights`

## Request

- Base URL: `https://data.fastsocial.co`
- URL: `https://data.fastsocial.co/v1/insights`
- Auth: API key in header `X-API-Key`

Engagement rate (mean and median), posting cadence, format mix, best posting hours (UTC) and a percentile against the Instagram Benchmarks report, from the latest 12 posts. Pinned posts are excluded.

Cost: **2 credits**.

## Query parameters

- `username` string
- `user_id` string

## Response `200`

OK

- object
  - `ok` unknown, required
  - `data` Insights, required
    - `username` string
    - `followers` integer
    - `follower_bucket` string
    - `sample_size` integer
    - `confidence` 'good' | 'low' | 'insufficient'
    - `avg_likes` number, nullable
    - `avg_comments` number, nullable
    - `engagement_rate_pct` number, nullable
    - `engagement_rate_median_pct` number, nullable
    - `posts_per_week` number, nullable
    - `format_share` object
    - `best_hours_utc` object[], nullable
      - `hour_utc` integer
      - `posts` integer
      - `score` number
    - `last_post_at` integer, nullable
    - `benchmark_percentile` integer, nullable
    - `benchmark_month` string, nullable
  - `meta` Meta, required
    - `cache` 'hit' | 'miss' | 'stale'
    - `age_seconds` integer
    - `stale` boolean
    - `credits` integer
    - `credits_remaining` integer, nullable

## Other responses

- `400`: Error
- `401`: Error
- `404`: Error
- `422`: Error
- `429`: Error
- `451`: Error
- `502`: Error
- `503`: Error

---

[API](https://skmtc.dev/fastsocial/apis/fastsocial-instagram-data-api.md) · [All operations](https://skmtc.dev/fastsocial/apis/fastsocial-instagram-data-api/llms.txt) · [OpenAPI document](https://skmtc.dev/fastsocial/apis/fastsocial-instagram-data-api/revisions/fe69c993e76a?raw)