# openai_ads_get_insights

> Read ChatGPT Ads delivery, finalized cost and attributed conversions by account, campaign, ad group or ad.

[Documentation](https://www.getmcpads.com/docs) / [Sources](https://www.getmcpads.com/docs/sources) / [ChatGPT Ads](https://www.getmcpads.com/docs/sources/chatgpt-ads)

Read ChatGPT Ads delivery, finalized cost and attributed conversions by account, campaign, ad group or ad. Inclusive local dates; native CTR/CVR are fractions; money uses major account currency units. Paginated automatically without retries; truncated output is explicit. Default attribution is 30-day click / 1-day view, ad-event time.

> **Note** Connect with the Ads Management API key from Ads Manager Settings, then select the verified advertising account. Native account permissions and feature eligibility apply.

|  |  |
| --- | --- |
| Source | [ChatGPT Ads](https://www.getmcpads.com/docs/sources/chatgpt-ads) |
| Kind | Read |
| Discovery | Reachable through `search_tools` and `run_tool` |
| Account parameter | `adAccountId` |
| Endpoint | https://mcp.getmcpads.com/openai-ads/mcp |

## Parameters

| Name | Type | Required | Notes |
| --- | --- | --- | --- |
| `adAccountId` | string | Required | Exact verified and selected ChatGPT Ads account ID. The key is scoped to this account. |
| `since` | string | Required | Beginning of the requested reporting period; use the format accepted by the provider. |
| `until` | string | Required | End of the requested reporting period; use the format accepted by the provider. |
| `level` | string | Optional | Entity or aggregation level for the requested report. One of: `ad_account`, `campaign`, `ad_group`, `ad`. Default: `"campaign"`. |
| `metrics` | array | Optional | Native or documented calculated metric names to request. Check compatibility with the selected dimensions. Default: `["spend","impressions","clicks"]`. |
| `timeGranularity` | string | Optional | One of: `daily`, `none`. Default: `"daily"`. |
| `maxRows` | integer | Optional | Default: `10000`. |

## Calling it

Through run_tool, since it is not announced

```json
{
  "name": "run_tool",
  "arguments": {
    "name": "openai_ads_get_insights",
    "args": {
      "adAccountId": "<string>",
      "since": "<string>",
      "until": "<string>"
    }
  }
}
```

- [ChatGPT Ads metrics](https://www.getmcpads.com/docs/sources/chatgpt-ads/metrics): What you can ask for.
- [ChatGPT Ads dimensions](https://www.getmcpads.com/docs/sources/chatgpt-ads/dimensions): How you can break it down.

---

This page as HTML: https://www.getmcpads.com/docs/sources/chatgpt-ads/tools/openai_ads_get_insights
Every page under /docs is available as Markdown: append `.md`, or send `Accept: text/markdown`.