By Campaign & Creative

POST

/api/public/reports/by-campaign/creative

Impressions, spend and attribution per campaign, episode and creative.

This endpoint utilizes a task system.

Please read the description of Get status of file processing to understand how it works.

const url = 'https://backend.podscribe.ai/api/public/reports/by-campaign/creative';
const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: '{"fields":["Advertiser","Creative ID","Media Type","Type","Tags","Spend","Publisher","Campaign","Show","Episode","Publish Date","Podcast & Streaming Impressions","YouTube Views","Reach","Visitors","Visits","Leads","Installs","Signups","Purchases","Revenue","Visitors Modeled","Visits Modeled","Leads Modeled","Installs Modeled","Signups Modeled","Purchases Modeled","Revenue Modeled","Clicks","Campaign ID","Campaign Internal ID","Publisher ID","Product","Initiative","Business Line","Rumble Impressions","Spotify Video Impressions","Episode GUID","Campaign & Initiative","Campaign Promo","ROAS","ROAS Modeled","AOV","AOV Modeled","Cost Per Visitor","Cost Per Visitor Modeled","Cost Per Lead","Cost Per Lead Modeled","Cost Per Install","Cost Per Install Modeled","Cost Per Signup","Cost Per Signup Modeled","Cost Per Purchase","Cost Per Purchase Modeled","Campaign Start Date","Campaign Expected Date","Campaign End Date","Week","Day","Month"],"fieldMapping":{"Day":"timestamp","Publish Date":"episode_upload"},"formatting":{"numberFormatting":true,"summary":true},"name":"example","startDate":"2026-04-15","endDate":"2026-04-15","advertiser":[],"ytSimulcastConv":true,"rSimulcastConv":true,"svSimulcastConv":true,"includeYtSpend":false,"spendOnPublishDate":true,"useSettingsProfiles":false,"attributionWindow":30,"attributionStreamingWindow":14,"attributionSaiWindow":30,"attributionModel":"first","attributionPreset":"any","excludeReferrers":["email","facebook","tiktok","instagram","twitter"],"excludeUtmMediums":["email","facebook","fb","tiktok","sms","social","klaviyo","youtube","instagram","ig"],"excludeUtmSources":["email","facebook","fb","tiktok","twitter","klaviyo","youtube","instagram","ig"],"excludePriorCustomers":false,"excludePriorVisitors":false,"showIncrementalResults":false,"incrementalDisplayType":"channel","timeRangeConv":false,"timeRangeConvWithWindow":false,"timeGrouping":"all","useNonPurchasesRevenue":false,"weekStartsOn":"monday"}'
};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

import requests

url = "https://backend.podscribe.ai/api/public/reports/by-campaign/creative"

payload = {
    "fields": ["Advertiser", "Creative ID", "Media Type", "Type", "Tags", "Spend", "Publisher", "Campaign", "Show", "Episode", "Publish Date", "Podcast & Streaming Impressions", "YouTube Views", "Reach", "Visitors", "Visits", "Leads", "Installs", "Signups", "Purchases", "Revenue", "Visitors Modeled", "Visits Modeled", "Leads Modeled", "Installs Modeled", "Signups Modeled", "Purchases Modeled", "Revenue Modeled", "Clicks", "Campaign ID", "Campaign Internal ID", "Publisher ID", "Product", "Initiative", "Business Line", "Rumble Impressions", "Spotify Video Impressions", "Episode GUID", "Campaign & Initiative", "Campaign Promo", "ROAS", "ROAS Modeled", "AOV", "AOV Modeled", "Cost Per Visitor", "Cost Per Visitor Modeled", "Cost Per Lead", "Cost Per Lead Modeled", "Cost Per Install", "Cost Per Install Modeled", "Cost Per Signup", "Cost Per Signup Modeled", "Cost Per Purchase", "Cost Per Purchase Modeled", "Campaign Start Date", "Campaign Expected Date", "Campaign End Date", "Week", "Day", "Month"],
    "fieldMapping": {
        "Day": "timestamp",
        "Publish Date": "episode_upload"
    },
    "formatting": {
        "numberFormatting": True,
        "summary": True
    },
    "name": "example",
    "startDate": "2026-04-15",
    "endDate": "2026-04-15",
    "advertiser": [],
    "ytSimulcastConv": True,
    "rSimulcastConv": True,
    "svSimulcastConv": True,
    "includeYtSpend": False,
    "spendOnPublishDate": True,
    "useSettingsProfiles": False,
    "attributionWindow": 30,
    "attributionStreamingWindow": 14,
    "attributionSaiWindow": 30,
    "attributionModel": "first",
    "attributionPreset": "any",
    "excludeReferrers": ["email", "facebook", "tiktok", "instagram", "twitter"],
    "excludeUtmMediums": ["email", "facebook", "fb", "tiktok", "sms", "social", "klaviyo", "youtube", "instagram", "ig"],
    "excludeUtmSources": ["email", "facebook", "fb", "tiktok", "twitter", "klaviyo", "youtube", "instagram", "ig"],
    "excludePriorCustomers": False,
    "excludePriorVisitors": False,
    "showIncrementalResults": False,
    "incrementalDisplayType": "channel",
    "timeRangeConv": False,
    "timeRangeConvWithWindow": False,
    "timeGrouping": "all",
    "useNonPurchasesRevenue": False,
    "weekStartsOn": "monday"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.json())

curl --request POST \
  --url https://backend.podscribe.ai/api/public/reports/by-campaign/creative \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "fields": [ "Advertiser", "Creative ID", "Media Type", "Type", "Tags", "Spend", "Publisher", "Campaign", "Show", "Episode", "Publish Date", "Podcast & Streaming Impressions", "YouTube Views", "Reach", "Visitors", "Visits", "Leads", "Installs", "Signups", "Purchases", "Revenue", "Visitors Modeled", "Visits Modeled", "Leads Modeled", "Installs Modeled", "Signups Modeled", "Purchases Modeled", "Revenue Modeled", "Clicks", "Campaign ID", "Campaign Internal ID", "Publisher ID", "Product", "Initiative", "Business Line", "Rumble Impressions", "Spotify Video Impressions", "Episode GUID", "Campaign & Initiative", "Campaign Promo", "ROAS", "ROAS Modeled", "AOV", "AOV Modeled", "Cost Per Visitor", "Cost Per Visitor Modeled", "Cost Per Lead", "Cost Per Lead Modeled", "Cost Per Install", "Cost Per Install Modeled", "Cost Per Signup", "Cost Per Signup Modeled", "Cost Per Purchase", "Cost Per Purchase Modeled", "Campaign Start Date", "Campaign Expected Date", "Campaign End Date", "Week", "Day", "Month" ], "fieldMapping": { "Day": "timestamp", "Publish Date": "episode_upload" }, "formatting": { "numberFormatting": true, "summary": true }, "name": "example", "startDate": "2026-04-15", "endDate": "2026-04-15", "advertiser": [], "ytSimulcastConv": true, "rSimulcastConv": true, "svSimulcastConv": true, "includeYtSpend": false, "spendOnPublishDate": true, "useSettingsProfiles": false, "attributionWindow": 30, "attributionStreamingWindow": 14, "attributionSaiWindow": 30, "attributionModel": "first", "attributionPreset": "any", "excludeReferrers": [ "email", "facebook", "tiktok", "instagram", "twitter" ], "excludeUtmMediums": [ "email", "facebook", "fb", "tiktok", "sms", "social", "klaviyo", "youtube", "instagram", "ig" ], "excludeUtmSources": [ "email", "facebook", "fb", "tiktok", "twitter", "klaviyo", "youtube", "instagram", "ig" ], "excludePriorCustomers": false, "excludePriorVisitors": false, "showIncrementalResults": false, "incrementalDisplayType": "channel", "timeRangeConv": false, "timeRangeConvWithWindow": false, "timeGrouping": "all", "useNonPurchasesRevenue": false, "weekStartsOn": "monday" }'

Request Body^required

application/json

fields

Exact CSV column header names to include, in order. If omitted, all CSV columns not excluded by default for the resolved report configuration are included. Allowed values list all built-in static columns, including incrementality column names selectable when showIncrementalResults is true. Campaign Incremental % columns require campaign-level incrementalDisplayType. Confidence-interval columns and Incrementality Source are available on this endpoint. Incrementality columns are controlled by showIncrementalResults and incrementalDisplayType. “Show ID” is excluded by default except for advertisers that previously had it enabled; request it explicitly through fields. “Campaign Spend” and “Expected Impressions” are excluded by default; request via fields. “Incrementality Source” is excluded by default and must be explicitly requested. Advertiser-specific custom action columns may also be available. ROAS, AOV, and Cost Per columns are available only when timeGrouping is “all”. Time bucket columns reflect timeGrouping: “day” includes “Day”, “week” includes “Week”, “month” includes “Month”, and “all” omits time bucket columns.

Array

Advertiser Creative ID Media Type Type Tags Spend Publisher Campaign Show Episode Publish Date Podcast & Streaming Impressions YouTube Views Reach Visitors Visits Leads Installs Signups Purchases Revenue Visitors Modeled Visits Modeled Leads Modeled Installs Modeled Signups Modeled Purchases Modeled Revenue Modeled Clicks Campaign ID Campaign Internal ID Publisher ID Product Initiative Business Line Rumble Impressions Spotify Video Impressions Episode GUID Campaign & Initiative Campaign Promo ROAS ROAS Modeled AOV AOV Modeled Cost Per Visitor Cost Per Visitor Modeled Cost Per Lead Cost Per Lead Modeled Cost Per Install Cost Per Install Modeled Cost Per Signup Cost Per Signup Modeled Cost Per Purchase Cost Per Purchase Modeled Campaign Start Date Campaign Expected Date Campaign End Date Week Day Month

55 moreLess

Advertiser Creative ID Media Type Type Tags Spend eCPM CPM Publisher Campaign SmartServe Targeting Profile Show Show ID Genre Episode Episode Duration Ad Servers Adswizz Campaign ID Episode ID Publish Date Podcast & Streaming Impressions Delivered Contracted Impressions YouTube Views Reach Frequency Visitors Visitors % Visits Visits % Leads Leads % Installs Installs % Signups Signups % Purchases Purchases % Revenue Visitors Modeled Visitors Modeled % Visits Modeled Visits Modeled % Leads Modeled Leads Modeled % Installs Modeled Installs Modeled % Signups Modeled Signups Modeled % Purchases Modeled Purchases Modeled % Revenue Modeled Clicks Campaign ID Itunes ID YouTube Channel / Playlist ID Campaign Internal ID Podscribe Campaign ID Publisher ID Product Initiative Business Line Rumble Impressions Spotify Video Impressions Episode GUID Campaign & Initiative Campaign Geo Incrementality Source Incremental Visitors Incremental Visitors % Incremental Visitors Modeled Incremental Visitors Modeled % Visitors Campaign Incremental % Visitors Channel Incremental % Incremental Leads Incremental Leads % Incremental Leads Modeled Incremental Leads Modeled % Leads Campaign Incremental % Leads Channel Incremental % Incremental Installs Incremental Installs % Incremental Installs Modeled Incremental Installs Modeled % Installs Campaign Incremental % Installs Channel Incremental % Incremental Signups Incremental Signups % Incremental Signups Modeled Incremental Signups Modeled % Signups Campaign Incremental % Signups Channel Incremental % Incremental Purchases Incremental Purchases % Incremental Purchases Modeled Incremental Purchases Modeled % Purchases Campaign Incremental % Purchases Channel Incremental % Incremental Visits Incremental Visits % Incremental Visits Modeled Incremental Visits Modeled % Visits Campaign Incremental % Visits Channel Incremental % Incremental Revenue Incremental Revenue Modeled Visits Campaign Confidence Interval (+/- range) Visits Channel Confidence Interval (+/- range) Visitors Campaign Confidence Interval (+/- range) Visitors Channel Confidence Interval (+/- range) Signups Campaign Confidence Interval (+/- range) Signups Channel Confidence Interval (+/- range) Purchases Campaign Confidence Interval (+/- range) Purchases Channel Confidence Interval (+/- range) Installs Campaign Confidence Interval (+/- range) Installs Channel Confidence Interval (+/- range) Leads Campaign Confidence Interval (+/- range) Leads Channel Confidence Interval (+/- range) Downloads Incremental Downloads Incremental Modeled Downloads Campaign Incremental % Downloads Channel Incremental % Downloads Campaign Confidence Interval (+/- range) Downloads Channel Confidence Interval (+/- range) Conversions Campaign Confidence Interval (+/- range) Conversions Channel Confidence Interval (+/- range) Cost Per Incremental Visitor Cost Per Incremental Visitor Modeled Cost Per Incremental Lead Cost Per Incremental Lead Modeled Cost Per Incremental Install Cost Per Incremental Install Modeled Cost Per Incremental Signup Cost Per Incremental Signup Modeled Cost Per Incremental Purchase Cost Per Incremental Purchase Modeled Incremental ROAS Incremental ROAS Modeled Campaign Promo Campaign Unit Campaign Spend Expected Impressions Campaign Creatives ROAS ROAS Modeled AOV AOV Modeled Cost Per Visitor Cost Per Visitor Modeled Cost Per Lead Cost Per Lead Modeled Cost Per Install Cost Per Install Modeled Cost Per Signup Cost Per Signup Modeled Cost Per Purchase Cost Per Purchase Modeled Campaign Start Date Campaign Expected Date Campaign End Date Advertiser Industry Offline Purchases Online Purchases Offline Purchases Modeled Online Purchases Modeled Offline Revenue Online Revenue Offline Revenue Modeled Online Revenue Modeled Bill To Campaign Delivery Issues Campaign Placement Issues Week Day Month YouTube Engaged Views

170 moreLess

fieldMapping

Object to customize column headers in the CSV output (keys are default header names).

Record<string, string>

Example

{
  "Day": "timestamp",
  "Publish Date": "episode_upload"
}

formatting

Object to setup the formatting of CSV output.

{numberFormatting,summary,totals}

numberFormatting

Smart-format as currency, percentage, or comma-separated values for readability.

boolean

false

summary

Include a report summary at the top of the report, featuring the Report Title, Advertiser, and Dates

boolean

false

totals

Total all columns at the bottom of the report. Total reach is calculated for the whole report, not summed from the rows.

boolean

false

Example

{
  "numberFormatting": true,
  "summary": true
}

name

Optional display name for the generated report. Shown in the Reports UI. Ignored when an identical cached report is reused; pass a new request (or wait for cache expiry) to apply a new name.

string

(≤ 255 chars)

startDate

Start date ISO date (e.g., “2023-10-10”). Default is 3 months ago.

string<date>

endDate

End date ISO date (e.g., “2023-10-10”). Default is one week forward.

string<date>

advertiser

List of advertiser names. Default is all user advertisers.

Array<string>

[]

ytSimulcastConv

If true, the audio conversion rate for simulcast buys will be applied to the YouTube views of the corresponding YouTube ad.

boolean

true

rSimulcastConv

If true, the audio conversion rate for simulcast buys will be applied to the Rumble views of the corresponding Rumble ad.

boolean

true

svSimulcastConv

If true, the audio conversion rate for simulcast buys will be applied to the Spotify video views of the corresponding Spotify video ad.

boolean

true

includeYtSpend

If false, spend is not calculated for:

YouTube-only campaigns
Simulcast campaigns with YouTube views only

boolean

false

spendOnPublishDate

Determines how spend is applied for episodic ad buys.
If enabled, spend is applied on the ad’s publish date.
If disabled, spend is prorated based on impression delivery over the first 30 days of baked-in campaigns.

boolean

true

useSettingsProfiles

Enables the use of settings profiles for the request.
When set to true, the request will use the settings profile associated with the selected advertiser.
Any settings from the profile can still be overridden by explicitly provided request parameters.

boolean

false

attributionWindow

Days between converted_at and touched_at.

number

attributionStreamingWindow

Days between converted_at and touched_at for streaming.

number

attributionSaiWindow

Days between converted_at and touched_at for SAI.

number

attributionModel

Attribution model.

multi_timedecay

first last multi_linear multi_timedecay

attributionPreset

Device-graph attribution preset, matching the Device Graph Usage control in the UI. Omitted: the default preset is resolved from the first entry in advertisers. Most advertisers default to any; a small number are configured differently.

any

any all none

excludeReferrers

Referrers to exclude.

Array<string>

email, facebook, tiktok, instagram, twitter

excludeUtmMediums

UTM mediums to exclude.

Array<string>

email facebook fb tiktok sms social klaviyo youtube instagram ig

5 moreLess

excludeUtmSources

UTM sources to exclude.

Array<string>

email facebook fb tiktok twitter klaviyo youtube instagram ig

4 moreLess

excludePriorCustomers

If true, the results will exclude prior customers.

boolean

false

excludePriorVisitors

If true, the results will exclude prior visitors.

boolean

false

showIncrementalResults

If true, incremental columns are available in the output. “Incrementality Source” remains excluded by default and must be explicitly requested through fields.

boolean

false

incrementalDisplayType

Level at which incrementality is calculated. smart_serve_or_channel and smart_serve_or_campaign use SmartServe incrementality where available, otherwise channel or campaign level.

smart_serve_or_channel

channel campaign smart_serve_or_channel smart_serve_or_campaign

timeRangeConv

If true, the results will only include conversions from impressions in this time range (strict when timeRangeConvWithWindow is omitted or false).

boolean

false

timeRangeConvWithWindow

Used with timeRangeConv. If true, only impressions inside the selected report date range are eligible and attributed conversions extend through the configured conversion window after the report end date.

boolean

false

timeGrouping

Group impressions by day, week, month or without grouping if “all” is passed.

day

all day week month

useNonPurchasesRevenue

Include revenue from custom events where order_value is non-zero.

boolean

false

weekStartsOn

The day of the week to start the week.

monday

monday sunday

Response Body

application/json

ID of the file processing task.

string<uuid>

status

Task status: pending, done or failed.

pending done failed

url

Link to download the result file. Returned once the file is ready.

string<uri>

Response example

{
  "status": "pending"
}

Result file

Field	Type	Example	Description
Week	string	2023-12-18	Date of the week in the format YYYY-mm-DD.
Day	string	2023-12-23	Date of the day in the format YYYY-mm-DD.
Advertiser	string	demoAdvertiser	Name of the advertiser for the media content.
Creative ID	string	some-creative-id	ID of the creative.
Media Type	string	podcast	Type of media content, such as “podcast,” “podcast and youtube,” “youtube,” “simulcast,” or “streaming.”
Type	string	baked-in	Type of ad integration, either “baked-in” or “dai” (Dynamic Ad Insertion).
Tags	string	Retail	Optional tags associated with the campaign.
Spend	number	123	Amount spent on the advertisement, if applicable.
Publisher	string	Some publisher	Name of the publisher or platform hosting the content.
Campaign	string	My Campaign	Name of the advertising campaign.
SmartServe Targeting Profile	string	My Profile	Name of the SmartServe targeting profile. Excluded by default; add “SmartServe Targeting Profile” to `fields` to include. Only populated for campaigns served via SmartServe.
Show	string	Some Show	Name of the show associated with the media content.
Show ID	number	123	Podscribe ID of the show. Excluded by default except for previously enabled advertisers; request via `fields`.
Episode	string	Some Ep	Name or identifier of the specific episode, if applicable.
Podcast & Streaming Impressions	number	123	Number of podcast & streaming impressions, if applicable.
Delivered Contracted Impressions	number	123	DAI impressions within flight dates, capped by expected impressions. Hidden by default; request via `fields`.
YouTube Views	number	123	Number of views for YouTube content, if applicable.
Reach	number	123	Reach represents the total number of unique users who saw the ad.
Visitors	number	123	Number of visitors to a website, if applicable.
Visits	number	123	Number of visits to a website, if applicable.
Leads	number	123	Number of leads generated, if applicable.
Installs	number	123	Number of app installations, if applicable.
Signups	number	123	Number of signups or registrations, if applicable.
Purchases	number	123	Number of purchases made, if applicable.
Revenue	number	123	Revenue generated, if applicable.
Visitors Modeled	number	123	Modeled number of visitors based on data analysis, if applicable.
Visits Modeled	number	123	Modeled number of visits based on data analysis, if applicable.
Leads Modeled	number	123	Modeled number of leads based on data analysis, if applicable.
Installs Modeled	number	123	Modeled number of app installations based on data analysis, if applicable.
Signups Modeled	number	123	Modeled number of signups based on data analysis, if applicable.
Purchases Modeled	number	123	Modeled number of purchases based on data analysis, if applicable.
Revenue Modeled	number	123	Modeled revenue based on data analysis, if applicable.
Clicks	number	123	How many times link was clicked.
Campaign ID	string	some-campaign-id	Identifier for the advertising campaign.
Campaign Internal ID	string	mycampaign	The campaign’s identifier in Podscribe.
Podscribe Campaign ID	string	3105cc60-3970-11f1-a827-67ac2fdfebc6	Unique Podscribe campaign request ID.
Publisher ID	string	123	Podscribe publisher ID.
Product	string	some-product	The product name.
Initiative	string	some-initiative	The initiative name.
Business Line	string	some-business-line	The business line name.
Rumble Impressions	number	123	Number of Rumble impressions, if applicable.
Spotify Video Impressions	number	123	Number of Spotify video impressions, if applicable.
Episode ID	number	123	Podscribe ID of the episode, if applicable.
Campaign Promo	string	SALE20	A string value representing a promotional code associated with a campaign
Campaign Geo	string	United States	Name of the campaign country
Incrementality Source	string	Synthetic - Channel	Provenance of the row’s incrementality values. Possible values: “SmartServe”, “SmartServe (PSA)”, “SmartServe (Holdout)”, “Synthetic - Campaign”, or “Synthetic - Channel”. Excluded by default; explicitly add this field and enable `showIncrementalResults`.
Incremental Visitors	number	123	Incremental visitors vs holdout. Requires `showIncrementalResults`.
Incremental Visitors %	number	0.05	Incremental visitors as a share of impressions. Requires `showIncrementalResults`. Available when `timeGrouping` is `all`. Excluded by default; request via `fields`.
Incremental Visitors Modeled	number	123	Modeled incremental visitors. Requires `showIncrementalResults`.
Incremental Visitors Modeled %	number	0.05	Modeled incremental visitors as a share of impressions. Requires `showIncrementalResults`. Available when `timeGrouping` is `all`. Excluded by default; request via `fields`.
Visitors Campaign Incremental %	number	0.05	Campaign-level visitors incrementality. Requires `showIncrementalResults` and campaign-level `incrementalDisplayType`.
Visitors Channel Incremental %	number	0.05	Channel-level visitors incrementality. Requires `showIncrementalResults`.
Incremental Leads	number	123	Incremental leads vs holdout. Requires `showIncrementalResults`.
Incremental Leads %	number	0.05	Incremental leads as a share of impressions. Requires `showIncrementalResults`. Available when `timeGrouping` is `all`. Excluded by default; request via `fields`.
Incremental Leads Modeled	number	123	Modeled incremental leads. Requires `showIncrementalResults`.
Incremental Leads Modeled %	number	0.05	Modeled incremental leads as a share of impressions. Requires `showIncrementalResults`. Available when `timeGrouping` is `all`. Excluded by default; request via `fields`.
Leads Campaign Incremental %	number	0.05	Campaign-level leads incrementality. Requires `showIncrementalResults` and campaign-level `incrementalDisplayType`.
Leads Channel Incremental %	number	0.05	Channel-level leads incrementality. Requires `showIncrementalResults`.
Incremental Installs	number	123	Incremental installs vs holdout. Requires `showIncrementalResults`.
Incremental Installs %	number	0.05	Incremental installs as a share of impressions. Requires `showIncrementalResults`. Available when `timeGrouping` is `all`. Excluded by default; request via `fields`.
Incremental Installs Modeled	number	123	Modeled incremental installs. Requires `showIncrementalResults`.
Incremental Installs Modeled %	number	0.05	Modeled incremental installs as a share of impressions. Requires `showIncrementalResults`. Available when `timeGrouping` is `all`. Excluded by default; request via `fields`.
Installs Campaign Incremental %	number	0.05	Campaign-level installs incrementality. Requires `showIncrementalResults` and campaign-level `incrementalDisplayType`.
Installs Channel Incremental %	number	0.05	Channel-level installs incrementality. Requires `showIncrementalResults`.
Incremental Signups	number	123	Incremental signups vs holdout. Requires `showIncrementalResults`.
Incremental Signups %	number	0.05	Incremental signups as a share of impressions. Requires `showIncrementalResults`. Available when `timeGrouping` is `all`. Excluded by default; request via `fields`.
Incremental Signups Modeled	number	123	Modeled incremental signups. Requires `showIncrementalResults`.
Incremental Signups Modeled %	number	0.05	Modeled incremental signups as a share of impressions. Requires `showIncrementalResults`. Available when `timeGrouping` is `all`. Excluded by default; request via `fields`.
Signups Campaign Incremental %	number	0.05	Campaign-level signups incrementality. Requires `showIncrementalResults` and campaign-level `incrementalDisplayType`.
Signups Channel Incremental %	number	0.05	Channel-level signups incrementality. Requires `showIncrementalResults`.
Incremental Purchases	number	123	Incremental purchases vs holdout. Requires `showIncrementalResults`.
Incremental Purchases %	number	0.05	Incremental purchases as a share of impressions. Requires `showIncrementalResults`. Available when `timeGrouping` is `all`. Excluded by default; request via `fields`.
Incremental Purchases Modeled	number	123	Modeled incremental purchases. Requires `showIncrementalResults`.
Incremental Purchases Modeled %	number	0.05	Modeled incremental purchases as a share of impressions. Requires `showIncrementalResults`. Available when `timeGrouping` is `all`. Excluded by default; request via `fields`.
Purchases Campaign Incremental %	number	0.05	Campaign-level purchases incrementality. Requires `showIncrementalResults` and campaign-level `incrementalDisplayType`.
Purchases Channel Incremental %	number	0.05	Channel-level purchases incrementality. Requires `showIncrementalResults`.
Incremental Visits	number	123	Incremental visits vs holdout. Requires `showIncrementalResults`.
Incremental Visits %	number	0.05	Incremental visits as a share of impressions. Requires `showIncrementalResults`. Available when `timeGrouping` is `all`. Excluded by default; request via `fields`.
Incremental Visits Modeled	number	123	Modeled incremental visits. Requires `showIncrementalResults`.
Incremental Visits Modeled %	number	0.05	Modeled incremental visits as a share of impressions. Requires `showIncrementalResults`. Available when `timeGrouping` is `all`. Excluded by default; request via `fields`.
Visits Campaign Incremental %	number	0.05	Campaign-level visits incrementality. Requires `showIncrementalResults` and campaign-level `incrementalDisplayType`.
Visits Channel Incremental %	number	0.05	Channel-level visits incrementality. Requires `showIncrementalResults`.
Incremental Revenue	number	123	Incremental revenue vs holdout. Requires `showIncrementalResults`.
Incremental Revenue Modeled	number	123	Modeled incremental revenue. Requires `showIncrementalResults`.
Visits Campaign Confidence Interval (+/- range)	number	0.02	Campaign-level visits incrementality confidence interval. Requires `showIncrementalResults` and campaign-level `incrementalDisplayType`. Excluded by default; request via `fields`.
Visits Channel Confidence Interval (+/- range)	number	0.02	Channel-level visits incrementality confidence interval. Requires `showIncrementalResults`. Excluded by default; request via `fields`.
Visitors Campaign Confidence Interval (+/- range)	number	0.02	Campaign-level visitors incrementality confidence interval. Requires `showIncrementalResults` and campaign-level `incrementalDisplayType`. Excluded by default; request via `fields`.
Visitors Channel Confidence Interval (+/- range)	number	0.02	Channel-level visitors incrementality confidence interval. Requires `showIncrementalResults`. Excluded by default; request via `fields`.
Signups Campaign Confidence Interval (+/- range)	number	0.02	Campaign-level signups incrementality confidence interval. Requires `showIncrementalResults` and campaign-level `incrementalDisplayType`. Excluded by default; request via `fields`.
Signups Channel Confidence Interval (+/- range)	number	0.02	Channel-level signups incrementality confidence interval. Requires `showIncrementalResults`. Excluded by default; request via `fields`.
Purchases Campaign Confidence Interval (+/- range)	number	0.02	Campaign-level purchases incrementality confidence interval. Requires `showIncrementalResults` and campaign-level `incrementalDisplayType`. Excluded by default; request via `fields`.
Purchases Channel Confidence Interval (+/- range)	number	0.02	Channel-level purchases incrementality confidence interval. Requires `showIncrementalResults`. Excluded by default; request via `fields`.
Installs Campaign Confidence Interval (+/- range)	number	0.02	Campaign-level installs incrementality confidence interval. Requires `showIncrementalResults` and campaign-level `incrementalDisplayType`. Excluded by default; request via `fields`.
Installs Channel Confidence Interval (+/- range)	number	0.02	Channel-level installs incrementality confidence interval. Requires `showIncrementalResults`. Excluded by default; request via `fields`.
Leads Campaign Confidence Interval (+/- range)	number	0.02	Campaign-level leads incrementality confidence interval. Requires `showIncrementalResults` and campaign-level `incrementalDisplayType`. Excluded by default; request via `fields`.
Leads Channel Confidence Interval (+/- range)	number	0.02	Channel-level leads incrementality confidence interval. Requires `showIncrementalResults`. Excluded by default; request via `fields`.
Downloads Incremental	number	123	Incremental downloads. Smart promo reports only. Requires `showIncrementalResults`.
Downloads Incremental Modeled	number	123	Modeled incremental downloads. Smart promo reports only. Requires `showIncrementalResults`.
Downloads Campaign Incremental %	number	0.05	Campaign-level downloads incrementality. Smart promo reports only. Requires `showIncrementalResults` and campaign-level `incrementalDisplayType`.
Downloads Channel Incremental %	number	0.05	Channel-level downloads incrementality. Smart promo reports only. Requires `showIncrementalResults`.
Downloads Campaign Confidence Interval (+/- range)	number	0.02	Campaign-level downloads incrementality confidence interval. Smart promo reports only. Requires `showIncrementalResults` and campaign-level `incrementalDisplayType`. Excluded by default; request via `fields`.
Downloads Channel Confidence Interval (+/- range)	number	0.02	Channel-level downloads incrementality confidence interval. Smart promo reports only. Requires `showIncrementalResults`. Excluded by default; request via `fields`.
Conversions Campaign Confidence Interval (+/- range)	number	0.02	Campaign-level conversions incrementality confidence interval. Smart promo reports only. Requires `showIncrementalResults` and campaign-level `incrementalDisplayType`. Excluded by default; request via `fields`.
Conversions Channel Confidence Interval (+/- range)	number	0.02	Channel-level conversions incrementality confidence interval. Smart promo reports only. Requires `showIncrementalResults`. Excluded by default; request via `fields`.
Campaign Start Date	string	2015-03-19	Campaign start date in the format YYYY-mm-DD
Campaign End Date	string	2015-03-19	Campaign end date in the format YYYY-mm-DD
Campaign Expected Date	string	2015-03-19	Campaign expected date in the format YYYY-mm-DD
Adswizz Campaign ID	string	12345	Adswizz campaign ID from pixel params (Adswizz platforms: adswizz, streaming_adswizz, adswizz_ron, streaming_adswizz_simple). Only populated when the column is requested and impressions were served via Adswizz.
Month	string	2023-12-01	First day of the month in YYYY-mm-DD. Present when `timeGrouping` is `month`.
eCPM	number	12.5	Estimated cost per thousand impressions. Excluded by default; request via `fields`.
CPM	number	10	Cost per thousand impressions. Excluded by default; request via `fields`.
Genre	string	Comedy	Genre of the show. Excluded by default; request via `fields`.
Episode Duration	number	3600	Episode duration in seconds. Excluded by default; request via `fields`.
Ad Servers	string	megaphone	Ad servers that served the impressions. Excluded by default; request via `fields`.
Publish Date	string	2023-12-18	Date when the media content was published, in the format YYYY-mm-DD.
Frequency	number	1.5	Average impressions per unique listener. Available when `timeGrouping` is `all`. Excluded by default; request via `fields`.
Visitors %	number	0.05	Visitors as a share of impressions. Available when `timeGrouping` is `all`. Excluded by default; request via `fields`.
Visits %	number	0.04	Visits as a share of impressions. Available when `timeGrouping` is `all`. Excluded by default; request via `fields`.
Leads %	number	0.01	Leads as a share of impressions. Available when `timeGrouping` is `all`. Excluded by default; request via `fields`.
Installs %	number	0.01	Installs as a share of impressions. Available when `timeGrouping` is `all`. Excluded by default; request via `fields`.
Signups %	number	0.02	Signups as a share of impressions. Available when `timeGrouping` is `all`. Excluded by default; request via `fields`.
Purchases %	number	0.02	Purchases as a share of impressions. Available when `timeGrouping` is `all`. Excluded by default; request via `fields`.
Visitors Modeled %	number	0.05	Modeled visitors as a share of impressions. Available when `timeGrouping` is `all`. Excluded by default; request via `fields`.
Visits Modeled %	number	0.04	Modeled visits as a share of impressions. Available when `timeGrouping` is `all`. Excluded by default; request via `fields`.
Leads Modeled %	number	0.01	Modeled leads as a share of impressions. Available when `timeGrouping` is `all`. Excluded by default; request via `fields`.
Installs Modeled %	number	0.01	Modeled installs as a share of impressions. Available when `timeGrouping` is `all`. Excluded by default; request via `fields`.
Signups Modeled %	number	0.02	Modeled signups as a share of impressions. Available when `timeGrouping` is `all`. Excluded by default; request via `fields`.
Purchases Modeled %	number	0.02	Modeled purchases as a share of impressions. Available when `timeGrouping` is `all`. Excluded by default; request via `fields`.
ROAS	number	2.5	Return on advertising spend. Available when `timeGrouping` is `all`.
ROAS Modeled	number	2.5	Modeled return on advertising spend. Available when `timeGrouping` is `all`.
AOV	number	45	Average order value. Available when `timeGrouping` is `all`.
AOV Modeled	number	45	Modeled average order value. Available when `timeGrouping` is `all`.
Cost Per Visitor	number	12	Spend divided by visitors. Available when `timeGrouping` is `all`.
Cost Per Visitor Modeled	number	12	Spend divided by modeled visitors. Available when `timeGrouping` is `all`.
Cost Per Lead	number	20	Spend divided by leads. Available when `timeGrouping` is `all`.
Cost Per Lead Modeled	number	20	Spend divided by modeled leads. Available when `timeGrouping` is `all`.
Cost Per Install	number	25	Spend divided by installs. Available when `timeGrouping` is `all`.
Cost Per Install Modeled	number	25	Spend divided by modeled installs. Available when `timeGrouping` is `all`.
Cost Per Signup	number	18	Spend divided by signups. Available when `timeGrouping` is `all`.
Cost Per Signup Modeled	number	18	Spend divided by modeled signups. Available when `timeGrouping` is `all`.
Cost Per Purchase	number	30	Spend divided by purchases. Available when `timeGrouping` is `all`.
Cost Per Purchase Modeled	number	30	Spend divided by modeled purchases. Available when `timeGrouping` is `all`.
Cost Per Incremental Visitor	number	12	Spend divided by incremental visitors. Requires `showIncrementalResults`. Available when `timeGrouping` is `all`. Excluded by default; request via `fields`.
Cost Per Incremental Visitor Modeled	number	12	Spend divided by modeled incremental visitors. Requires `showIncrementalResults`. Available when `timeGrouping` is `all`. Excluded by default; request via `fields`.
Cost Per Incremental Lead	number	20	Spend divided by incremental leads. Requires `showIncrementalResults`. Available when `timeGrouping` is `all`. Excluded by default; request via `fields`.
Cost Per Incremental Lead Modeled	number	20	Spend divided by modeled incremental leads. Requires `showIncrementalResults`. Available when `timeGrouping` is `all`. Excluded by default; request via `fields`.
Cost Per Incremental Install	number	25	Spend divided by incremental installs. Requires `showIncrementalResults`. Available when `timeGrouping` is `all`. Excluded by default; request via `fields`.
Cost Per Incremental Install Modeled	number	25	Spend divided by modeled incremental installs. Requires `showIncrementalResults`. Available when `timeGrouping` is `all`. Excluded by default; request via `fields`.
Cost Per Incremental Signup	number	18	Spend divided by incremental signups. Requires `showIncrementalResults`. Available when `timeGrouping` is `all`. Excluded by default; request via `fields`.
Cost Per Incremental Signup Modeled	number	18	Spend divided by modeled incremental signups. Requires `showIncrementalResults`. Available when `timeGrouping` is `all`. Excluded by default; request via `fields`.
Cost Per Incremental Purchase	number	30	Spend divided by incremental purchases. Requires `showIncrementalResults`. Available when `timeGrouping` is `all`. Excluded by default; request via `fields`.
Cost Per Incremental Purchase Modeled	number	30	Spend divided by modeled incremental purchases. Requires `showIncrementalResults`. Available when `timeGrouping` is `all`. Excluded by default; request via `fields`.
Incremental ROAS	number	2.5	Incremental return on advertising spend. Requires `showIncrementalResults`. Available when `timeGrouping` is `all`. Excluded by default; request via `fields`.
Incremental ROAS Modeled	number	2.5	Modeled incremental return on advertising spend. Requires `showIncrementalResults`. Available when `timeGrouping` is `all`. Excluded by default; request via `fields`.
Itunes ID	string	123	iTunes ID of the show. Hidden by default; request via `fields`.
YouTube Channel / Playlist ID	string	UCxxxx	YouTube channel or playlist ID of the show. Hidden by default; request via `fields`.
Episode GUID	string	episode-guid	Guid of the episode.
Campaign & Initiative	string	Campaign / Initiative	Combined campaign and initiative label.
Campaign Unit	string	Mid	Booked campaign unit. Excluded by default; request via `fields`.
Campaign Spend	number	5000	Booked cost of the campaign flight, or Podscribe’s estimate when no rate is set. Blank for flights priced by CPM. Unlike Spend, this is planned rather than delivered. Excluded by default; request via `fields`.
Expected Impressions	number	250000	Number of impressions the campaign flight was booked to deliver, as opposed to the delivered impression columns. Excluded by default; request via `fields`.
Campaign Creatives	string	Creative A	Campaign creative names. Excluded by default; request via `fields`.
Advertiser Industry	string	Retail	Advertiser industry. Excluded by default; request via `fields`.
Offline Purchases	number	12	Offline purchase conversions. Excluded by default; request via `fields`.
Online Purchases	number	80	Online purchase conversions. Excluded by default; request via `fields`.
Offline Purchases Modeled	number	12	Modeled offline purchase conversions. Excluded by default; request via `fields`.
Online Purchases Modeled	number	80	Modeled online purchase conversions. Excluded by default; request via `fields`.
Offline Revenue	number	400	Offline revenue. Excluded by default; request via `fields`.
Online Revenue	number	3200	Online revenue. Excluded by default; request via `fields`.
Offline Revenue Modeled	number	400	Modeled offline revenue. Excluded by default; request via `fields`.
Online Revenue Modeled	number	3200	Modeled online revenue. Excluded by default; request via `fields`.
Bill To	string	Agency	Billing account. Excluded by default; request via `fields`.
Campaign Delivery Issues	string	WRONG GEO	Campaign delivery issue flags. Excluded by default; request via `fields`. Not available for limited-overview API keys.
Campaign Placement Issues	string	STALE READ	Campaign placement issue flags. Excluded by default; request via `fields`. Not available for limited-overview API keys.
YouTube Engaged Views	number	123	Engaged YouTube views when Engaged Views is enabled. Hidden by default; request via `fields`.

By Campaign & Creative

Request Bodyrequired

Example

Example

Response Body

Result file

Request Body^required