ChatGPT Ads Read
Conversion reporting for ChatGPT Ads: conversions, click-through conversions, and view-through conversions (1-day, reported separately — not added into the total), at ad_account/campaign/ad_group/ad l
POST https://api.adspirer.ai/api/v1/tools/get_chatgpt_conversion_insights/execute
Authorization: Bearer sk_live_... — your Adspirer API key (required)Content-Type: application/json (required)Idempotency-Key: <uuid> — recommended for write operations to make retries safeAll tool arguments are wrapped in an arguments object.
| Field | Type | Description |
|---|---|---|
aggregation_level | string optional | Report rows at this level: 'campaign', 'ad_group', or 'ad' (this endpoint does not support account-total rows). default: "campaign" |
entity_ids | array optional | The ids to report on at that level (cmpn_/adgrp_/ad_ ...). REQUIRED by the API. At campaign level, omitting this auto-reports ALL the account's campaigns. |
lookback_days | integer optional | How many days back to report (used unless start/end are given). default: 30 |
start | integer optional | Explicit window start (unix seconds, floored to the hour). |
end | integer optional | Explicit window end (unix seconds, floored to the hour). |
breakdown | string optional | Time granularity: 'none' or 'daily'. default: "none" |
segment | string optional | Optional segment: 'country' or 'device'. |
raw_data | boolean optional | Return the full raw JSON instead of the formatted table. default: false |
{
"arguments": {
"aggregation_level": "campaign",
"entity_ids": [
"string"
],
"lookback_days": 30,
"start": 1,
"end": 1,
"breakdown": "none"
}
}
{
"success": true,
"data": {
"text": "(tool-specific textual output for get_chatgpt_conversion_insights)",
"quota": {
"used": 42,
"limit": 150,
"tier": "plus",
"period_end": "2026-05-01"
}
},
"tool": "get_chatgpt_conversion_insights"
}
{
"success": false,
"error": "You have 25 meta_ads accounts connected. Please specify which account to use by passing the ad_account_id parameter:\n - Acme Holdings (ad_account_id=\"act_123456789\")\n - Acme EU (ad_account_id=\"act_987654321\")",
"is_error": true,
"tool": "get_chatgpt_conversion_insights"
}
{
"success": false,
"error": "\ud83d\udea8 Monthly limit reached (150/150 tool calls on Plus tier).\nUpgrade to Pro at https://adspirer.ai to keep building.",
"is_error": true,
"tool": "get_chatgpt_conversion_insights",
"quota": {
"used": 150,
"limit": 150,
"tier": "plus",
"period_end": "2026-05-01",
"upgrade_url": "https://adspirer.ai"
}
}
Interactive: Swagger UI
Machine-readable: OpenAPI 3.1 spec · llms-full.txt
More tools: ChatGPT Ads · All tools
Adspirer REST API — get an API key at adspirer.ai/keys · adspirer.ai