> ## Documentation Index
> Fetch the complete documentation index at: https://docs.adriel.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Data reference

> Metrics, breakdowns, refresh cadence, and limits for the Instagram Public data source in Adriel.

## Introduction

Instagram Public retrieves publicly available metadata and metrics about other Instagram professional (business or creator) accounts. It surfaces two kinds of data: the account's public profile (followers, biography, website, profile picture) and its recent media with public engagement (likes, comments, captions, and media details).

This is a public connector: it reads only publicly available data about professional accounts and does not require ownership of or admin access to the target account. It is distinct from Instagram organic analytics, which report on an owned account and require an authenticated login.

To connect this data source, see [How to connect Instagram Public to Adriel](/data-sources/g-n/instagram-public/how-to-connect).

## Data refresh strategy

### Architecture data

Instagram Public is a simple-cache connector: for each connected account, Adriel re-fetches the public data and refreshes the cache on a fixed daily schedule. There is no historical backfill — the cache holds the current snapshot of the account profile and the most recent media, and values accumulate from the connection date forward as each refresh runs.

### Reports data

The cache refreshes twice daily, at **5:00 AM UTC** and **5:00 PM UTC**.

This connector does not support date filtering. Reports always read the current cached snapshot: the profile view returns a single row for the account, and the media view returns up to the 100 most recent posts.

## Architecture levels

Instagram Public operates in two data modes, selected by the breakdown applied to a widget:

* **Account/profile mode** — reads the account's public profile. Returns a single row describing the account (followers, biography, website, profile picture, and related profile fields).
* **Media & post engagement mode** — reads the account's recent media. Returns one row per post, up to a cap of 100 of the most recent posts.

Metrics and breakdowns differ by mode: profile fields are only compatible with the account/profile breakdown, and post fields are only compatible with the media/post breakdowns. When no breakdown is selected, a default view combines both, placing the account row ahead of the post rows.

## Date range limits

Not applicable. Instagram Public is a no-date connector — reports ignore the dashboard date range and always return the current cached snapshot (one account row; up to 100 recent posts). The effective date shown reflects the most recent successful cache refresh.

## Metrics

<Note>
  **How to read the columns**

  **Data type** uses this vocabulary: Number, Currency, Percentage, Ratio, Duration, Date, Text, URL, Array, Boolean.

  **API Key** in code style such as `followers_count` is the literal Graph API field. *Italic text* describes how a value is produced when it does not map cleanly to a single API field.
</Note>

### Account/profile

Available in account/profile mode. Returns a single row describing the account's public profile.

| Metric          | Description                                      | Data type | API Key                                                 |
| --------------- | ------------------------------------------------ | --------- | ------------------------------------------------------- |
| Followers count | Number of accounts that follow this account.     | Number    | `followers_count`                                       |
| Follows count   | Number of accounts this account follows.         | Number    | `follows_count`                                         |
| Media count     | Total number of posts the account has published. | Number    | `media_count`                                           |
| Biography       | The account's public bio text.                   | Text      | `biography`                                             |
| Display name    | The account's public display name.               | Text      | `name`                                                  |
| Username        | The account's Instagram handle.                  | Text      | `username`                                              |
| Website         | Website listed on the account's profile.         | URL       | `website`                                               |
| Profile picture | URL of the account's profile picture.            | URL       | `profile_picture_url`                                   |
| Profile URL     | Link to the account's Instagram profile.         | URL       | *Constructed as `https://www.instagram.com/{username}`* |
| User ID         | Instagram's unique identifier for the account.   | Text      | `id`                                                    |

### Media & post engagement

Available in media & post engagement mode. Returns one row per post, up to the 100 most recent posts.

| Metric             | Description                                                           | Data type | API Key              |
| ------------------ | --------------------------------------------------------------------- | --------- | -------------------- |
| Post likes         | Number of likes on the post.                                          | Number    | `like_count`         |
| Post comments      | Number of comments on the post.                                       | Number    | `comments_count`     |
| Post timestamp     | Date and time the post was published.                                 | Date      | `timestamp`          |
| Post ID            | Instagram's unique identifier for the post.                           | Text      | `id`                 |
| Media URL          | Direct URL to the post's media.                                       | URL       | `media_url`          |
| Post caption       | The post's caption text.                                              | Text      | `caption`            |
| Media type         | The post's media type (for example, image, video, or carousel album). | Text      | `media_type`         |
| Media product type | The surface the media was published to (for example, feed).           | Text      | `media_product_type` |
| Post URL           | Permalink to the post on Instagram.                                   | URL       | `permalink`          |

## Breakdowns

### Account/profile

Available in account/profile mode.

| Breakdown | Description                              | API Key    |
| --------- | ---------------------------------------- | ---------- |
| Username  | Group by the account's Instagram handle. | `username` |

### Media & post engagement

Available in media & post engagement mode. These group and identify individual posts.

| Breakdown          | Description                             | API Key              |
| ------------------ | --------------------------------------- | -------------------- |
| Post ID            | Group by the individual post.           | `id`                 |
| Post caption       | Group by the post's caption text.       | `caption`            |
| Post URL           | Group by the post's permalink.          | `permalink`          |
| Media URL          | Group by the post's media URL.          | `media_url`          |
| Media type         | Group by the post's media type.         | `media_type`         |
| Media product type | Group by the post's media product type. | `media_product_type` |

## Limitations

* **No date filtering** — reports always return the current cached snapshot; the dashboard date range has no effect. There is no historical daily data, only what accumulates from the connection date forward.
* **Posts are capped at \~100** — metrics are provided for at most the 100 most recent posts. Older posts are not retrieved.
* **Professional accounts only** — only Instagram professional (business or creator) accounts can be read. Personal accounts are not supported.
* **Age-gated accounts are excluded** — data about age-gated Instagram professional accounts is not returned.
* **Username changes break the data source** — if the account's Instagram username changes, any data source linked to the old username stops working and must be recreated.
* **Public data only** — only publicly visible profile fields and public engagement are available. Owner-only insights such as reach and impressions are not accessible; use Instagram organic analytics for those.
* **Media may expire** — profile-picture and post media URLs point to Instagram-hosted media that can expire or change if the underlying content is removed or is no longer accessible through the API.

## API references

* [Instagram Platform (Meta Graph API)](https://developers.facebook.com/docs/instagram-platform/)
* [Business Discovery API](https://developers.facebook.com/docs/instagram-platform/instagram-graph-api/reference/ig-user/business_discovery/)
* [Instagram media (Graph API reference)](https://developers.facebook.com/docs/instagram-platform/reference/instagram-media/)

## See also

* [How to connect Instagram Public to Adriel](/data-sources/g-n/instagram-public/how-to-connect) (paired how-to)
* [Facebook Page Public data reference](/data-sources/a-f/facebook-page-public/data-reference) — the equivalent public connector for Facebook Pages
