> For the complete documentation index, see [llms.txt](https://docs.coupler.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.coupler.io/sources/category/ppc/instagram-ads/faq.md).

# FAQ

<details>

<summary>Do I need an Instagram login to connect?</summary>

No. Instagram Ads connects through the **Meta (Facebook) Graph API**, so you authenticate with your Facebook account — not your Instagram credentials. The Facebook account must have admin or advertiser access to the ad account linked to your Instagram Business profile.

</details>

<details>

<summary>Can I pull organic Instagram data — like post reach, profile visits, or follower counts?</summary>

No, this source is for **Instagram Ads (paid) data only**. Organic metrics like post insights, profile visits, or story views are not available through the Instagram Ads source. You would need a separate Instagram Business account integration for those.

</details>

<details>

<summary>Why does the Publisher platform breakdown show Facebook and Audience Network data, not just Instagram?</summary>

If your Meta campaigns are set to run across multiple placements, the Publisher platform breakdown will include all platforms where your ads ran — Instagram, Facebook, Audience Network, and Messenger. To isolate Instagram-only performance, use the Graph API filter to restrict results to `publisher_platform = instagram`, or analyze the breakdown column in your destination tool.

</details>

<details>

<summary>Can I combine Instagram Ads data from multiple ad accounts in one report?</summary>

Yes. Add multiple ad accounts as separate sources within the same data flow and use the **Append** transformation to stack them into one dataset. Make sure to include the `account_name` column so you can tell the accounts apart in your reports.

</details>

<details>

<summary>How do I set up filters for Insights reports?</summary>

Filters for the Insights entity use **Meta's Graph API filter syntax** — they're not a simple dropdown. For example, to filter by campaign ID or effective status, you need to write the filter expression manually. See the [data overview](/sources/category/ppc/instagram-ads/data-overview.md) for the correct syntax and examples.

</details>

<details>

<summary>Why do my monthly stats look wrong or incomplete?</summary>

This is usually a split period setting issue. By default, Insights reports use a **daily breakdown**. To get monthly-aggregated data, set **Split data by period** to **Monthly** in the report settings, and make sure your date range covers at least one full calendar month.

</details>

<details>

<summary>Can I use Coupler.io to send Instagram Ads data to an AI tool for analysis?</summary>

Yes. Coupler.io supports AI destinations including **ChatGPT, Claude, Gemini, Cursor, Perplexity, and OpenClaw**. You can send your Insights data directly to these tools to generate performance summaries, flag anomalies, or get optimization suggestions — no manual copy-pasting required.

</details>

<details>

<summary>Some metrics I used before are no longer returning data — what happened?</summary>

Meta periodically deprecates metrics from its API. If a field that previously worked now returns nothing, it may have been retired. Check Meta's API changelog or the Coupler.io Help Center for known deprecated fields.

</details>

{% hint style="info" %}
For a full breakdown of available metrics, dimensions, and breakdowns, see [Data Overview](/sources/category/ppc/instagram-ads/data-overview.md). If you're running into connection or permission problems, check [Common Issues](/sources/category/ppc/instagram-ads/common-issues.md). For tips on structuring your reports efficiently, visit [Best Practices](/sources/category/ppc/instagram-ads/best-practices.md).
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.coupler.io/sources/category/ppc/instagram-ads/faq.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.