instagram

Instagram

Official API (no first-party CLI) · Meta Graph API

Reads: reach, impressions, likes, comments, saves, video views.
Locators: Instagram media id (resolved from the post/Reel permalink).
Evidence for a linked target: Instagram Graph API insights result for a business/creator account.
Official docs: https://developers.facebook.com/docs/instagram-platform/insights

Usage

Agent command: superdense reward docs connectors --connector instagram

# instagram — usage

Instagram has **no first-party CLI**. Use the official **Meta Graph API** (Instagram
Platform) for business/creator accounts to read media insights.

```bash
# Media-level insights
curl "https://graph.facebook.com/v21.0/<ig-media-id>/insights?metric=reach,likes,comments,saved&access_token=$TOKEN"
```

Note: requires a business/creator account and Meta App Review. Some metrics changed in
Graph API v21 — check the docs for the current metric names.

**Reward dimensions:** reach, impressions, likes, comments, saves.
**Locators:** Instagram media id.

Install

Agent command: superdense reward docs connectors --connector instagram --section install

Instagram has **no first-party CLI**. Call the official API directly with credentials you control.
You need a Meta developer app, a connected business/creator account, a long-lived access token, and Meta App Review approval (free; ~4–6 weeks) before production use.

Set up access via the provider's official docs (credentials, scopes, and quotas live there):
- https://developers.facebook.com/docs/instagram-platform/getting-started

Troubleshoot

Agent command: superdense reward docs connectors --connector instagram --section troubleshoot

Meta Graph API failures are almost always credential, scope, or quota issues.

Check, in order:

1. **Token validity** — refresh/rotate the access token.
2. **Scopes** — confirm the token grants the metric you are reading.
3. **Quota** — confirm you are within the daily/per-minute limits.

Reference the official docs for error codes and limits:

- https://developers.facebook.com/docs/graph-api/guides/error-handling