Metrics
ChatGPT Ads metrics via API
Your customer connects their ChatGPT Ads account and your product queries 25 metrics through the same endpoint as every other platform. Each metric has an id (reference_key) that goes in the request.
POST /api/metrics/get-data
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
{
"customer_integration": "<connection uuid>",
"start": "2026-10-01",
"end": "2026-10-31",
"comparison_start": "2026-09-01",
"comparison_end": "2026-09-30",
"metrics": [
{
"id": "m1",
"reference_key": "chatgpt_ads:impressions",
"component": "number_v1",
"metrics": [
"impressions"
]
}
]
}More ChatGPT Ads request examples
The same endpoint for every kind of metric. The metrics and dimensions of each item come from the platform catalog (GET /api/metrics/{integration_slug}).
Chart
Impressions and Clicks per Day
Daily evolution of the impressions and clicks of your ads during the selected period.
POST /api/metrics/get-data
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
{
"customer_integration": "<connection uuid>",
"start": "2026-10-01",
"end": "2026-10-31",
"metrics": [
{
"id": "m1",
"reference_key": "chatgpt_ads:impressions_clicks_per_day",
"component": "chart_v1",
"metrics": [
"impressions",
"clicks"
],
"dimensions": [
"date"
]
}
]
}Table
Top Campaigns
Performance of your campaigns during the selected period.
POST /api/metrics/get-data
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
{
"customer_integration": "<connection uuid>",
"start": "2026-10-01",
"end": "2026-10-31",
"metrics": [
{
"id": "m1",
"reference_key": "chatgpt_ads:campaigns_table",
"component": "datatable_v1",
"metrics": [
"impressions",
"clicks",
"spend",
"ctr",
"cpc",
"conversions",
"cpa"
],
"dimensions": [
"campaign"
]
}
]
}Number
Clicks
Number of clicks your ads received during the selected period.
POST /api/metrics/get-data
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
{
"customer_integration": "<connection uuid>",
"start": "2026-10-01",
"end": "2026-10-31",
"metrics": [
{
"id": "m1",
"reference_key": "chatgpt_ads:clicks",
"component": "number_v1",
"metrics": [
"clicks"
]
}
]
}Numbers
11 metrics
Impressions
Number of times your ads were shown in ChatGPT during the selected period.
chatgpt_ads:impressionsClicks
Number of clicks your ads received during the selected period.
chatgpt_ads:clicksAmount spent
Total amount spent by your ads during the selected period, in the ad account's currency.
chatgpt_ads:spendCTR
The Click Through Rate (CTR) represents the number of total clicks that your ads received divided by the number of time it was shown (impressions).
chatgpt_ads:ctrCPC
Cost per Click (CPC) shows how much, on average, each link click costs you. It is calculated by dividing Cost/Number of Clicks. CPC is a metric used in the online advertising industry for benchmarking ad efficiency and performance.
chatgpt_ads:cpcCPM
Cost per Mille (CPM) is the average cost for 1,000 impressions. It is calculated by dividing Spent Amount/(Number of Impressions x 1000). CPM is a common metric used by the online advertising industry to gauge the cost-effectiveness of an ad campaign. It's often used to compare performance among different ad publishers and campaigns.
chatgpt_ads:cpmConversions
Click-through conversions for the conversion events configured on your campaigns, reported on the date the conversion happened. Conversion tracking must be set up on the ad account.
chatgpt_ads:conversionsCost per Conversion
Average amount spent per conversion during the selected period.
chatgpt_ads:cpaConversion Rate
Post-click conversion rate: conversions divided by clicks during the selected period.
chatgpt_ads:conversion_rateAttributed Sales
Value of the purchase events (order created) attributed to your ads, in the ad account's currency. Depends on purchase events being sent through the advertiser's conversion tracking.
chatgpt_ads:attributed_salesROAS
Return on ad spend: attributed purchase value divided by the amount spent. A value of 4 means four units of attributed sales per unit spent.
chatgpt_ads:roas
Charts
11 metrics
Impressions and Clicks per Day
Daily evolution of the impressions and clicks of your ads during the selected period.
chatgpt_ads:impressions_clicks_per_dayAmount Spent per Day
Daily evolution of the amount spent by your ads during the selected period.
chatgpt_ads:spend_per_dayCTR per Day
Daily evolution of the Click Through Rate (CTR) of your ads during the selected period.
chatgpt_ads:ctr_per_dayCPC and CPM per Day
Daily evolution of the average cost per click (CPC) and cost per one thousand impressions (CPM) during the selected period.
chatgpt_ads:cpc_cpm_per_dayConversions per Day
Daily evolution of the click-through conversions of your campaigns, reported on the date the conversion happened.
chatgpt_ads:conversions_per_dayAttributed Sales per Day
Daily evolution of the purchase value attributed to your ads during the selected period.
chatgpt_ads:attributed_sales_per_dayImpressions and Clicks by Country
Impressions and clicks of your ads split by the country where they were delivered.
chatgpt_ads:performance_per_countryAmount Spent by Country
Amount spent by your ads split by the country where they were delivered.
chatgpt_ads:spend_per_countryClicks by Device
This graph displays the number of clicks on your ads, grouped by the device that the person was using.
chatgpt_ads:clicks_per_deviceImpressions and Clicks by Platform
Impressions and clicks of your ads split by ChatGPT platform: iOS app, Android app or web browser.
chatgpt_ads:performance_per_platformAmount Spent by Platform
Amount spent by your ads split by ChatGPT platform: iOS app, Android app or web browser.
chatgpt_ads:spend_per_platform
Tables
3 metrics
Top Campaigns
Performance of your campaigns during the selected period.
chatgpt_ads:campaigns_tableTop Ad Groups
Performance of your ad groups during the selected period.
chatgpt_ads:ad_groups_tableTop Ads
Performance of your ads during the selected period, identified by the ad title shown in ChatGPT.
chatgpt_ads:ads_table
See Connect applied to your product.
Try it for 15 days with no card, or walk our team through your use case.
