By Campaign

POST

/api/public/impressions

Impressions, reach, spend and conversions per campaign, show and episode by day, week or month, or per-campaign totals.

For the most accurate YouTube Engaged Views and attribution numbers, set endDate to at least 3 days before today. Numbers in the last 3 days may include estimates and can change once YouTube reports actual data.

This endpoint utilizes a task system.

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

By Campaign

const url = 'https://backend.podscribe.ai/api/public/impressions';
const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: '{"fields":["Week","Day","Advertiser","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","Promo codes","Clicks","Campaign ID","Campaign Internal ID","Publisher ID","Product","Initiative","Business Line","Rumble Impressions","Spotify Video Impressions","Episode GUID","Campaign & Initiative","Campaign Promo","Campaign Start Date","Campaign Expected Date","Campaign End Date"],"fieldMapping":{"Day":"timestamp","Publish Date":"episode_upload"},"formatting":{"numberFormatting":true,"summary":true},"name":"example","startDate":"example","endDate":"example","advertiser":[],"ytSimulcastConv":true,"rSimulcastConv":true,"svSimulcastConv":true,"ytSimulcastConvWeight":1,"rSimulcastConvWeight":0.7,"svSimulcastConvWeight":0.7,"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","incCiCertainty":95,"timeRangeConv":false,"timeRangeConvWithWindow":false,"timeGrouping":"all","geoGrouping":"country","useNonPurchasesRevenue":false,"weekStartsOn":"monday","aggregateEpisodicBuysPerShow":false,"skipCampaignTransliteration":false,"campaignTags":["example"],"campaignTagsExclude":false,"modelPublicSpaceIps":true,"modelOffline":true}'
};

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/impressions"

payload = {
    "fields": ["Week", "Day", "Advertiser", "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", "Promo codes", "Clicks", "Campaign ID", "Campaign Internal ID", "Publisher ID", "Product", "Initiative", "Business Line", "Rumble Impressions", "Spotify Video Impressions", "Episode GUID", "Campaign & Initiative", "Campaign Promo", "Campaign Start Date", "Campaign Expected Date", "Campaign End Date"],
    "fieldMapping": {
        "Day": "timestamp",
        "Publish Date": "episode_upload"
    },
    "formatting": {
        "numberFormatting": True,
        "summary": True
    },
    "name": "example",
    "startDate": "example",
    "endDate": "example",
    "advertiser": [],
    "ytSimulcastConv": True,
    "rSimulcastConv": True,
    "svSimulcastConv": True,
    "ytSimulcastConvWeight": 1,
    "rSimulcastConvWeight": 0.7,
    "svSimulcastConvWeight": 0.7,
    "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",
    "incCiCertainty": 95,
    "timeRangeConv": False,
    "timeRangeConvWithWindow": False,
    "timeGrouping": "all",
    "geoGrouping": "country",
    "useNonPurchasesRevenue": False,
    "weekStartsOn": "monday",
    "aggregateEpisodicBuysPerShow": False,
    "skipCampaignTransliteration": False,
    "campaignTags": ["example"],
    "campaignTagsExclude": False,
    "modelPublicSpaceIps": True,
    "modelOffline": True
}
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/impressions \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "fields": [ "Week", "Day", "Advertiser", "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", "Promo codes", "Clicks", "Campaign ID", "Campaign Internal ID", "Publisher ID", "Product", "Initiative", "Business Line", "Rumble Impressions", "Spotify Video Impressions", "Episode GUID", "Campaign & Initiative", "Campaign Promo", "Campaign Start Date", "Campaign Expected Date", "Campaign End Date" ], "fieldMapping": { "Day": "timestamp", "Publish Date": "episode_upload" }, "formatting": { "numberFormatting": true, "summary": true }, "name": "example", "startDate": "example", "endDate": "example", "advertiser": [], "ytSimulcastConv": true, "rSimulcastConv": true, "svSimulcastConv": true, "ytSimulcastConvWeight": 1, "rSimulcastConvWeight": 0.7, "svSimulcastConvWeight": 0.7, "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", "incCiCertainty": 95, "timeRangeConv": false, "timeRangeConvWithWindow": false, "timeGrouping": "all", "geoGrouping": "country", "useNonPurchasesRevenue": false, "weekStartsOn": "monday", "aggregateEpisodicBuysPerShow": false, "skipCampaignTransliteration": false, "campaignTags": [ "example" ], "campaignTagsExclude": false, "modelPublicSpaceIps": true, "modelOffline": true }'

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 Source is not available with geoGrouping. 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. “Incrementality Source” is excluded by default, must be explicitly requested, and is not available when geoGrouping is provided. Advertiser-specific custom action columns (<custom_action> and <custom_action> Modeled) may also be available, including when geoGrouping is set. Mapped custom actions are excluded by default unless listed here. Custom-action incrementality columns follow showIncrementalResults and incrementalDisplayType. “Geo” is available when geoGrouping is provided. “Country” is available when geoGrouping is provided. “DMA Code” is available when geoGrouping is "DMA".

Array

Week Day Advertiser 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 Promo codes Clicks Campaign ID Campaign Internal ID Publisher ID Product Initiative Business Line Rumble Impressions Spotify Video Impressions Episode GUID Campaign & Initiative Campaign Promo Campaign Start Date Campaign Expected Date Campaign End Date

40 moreLess

Visitors Visitors % Visits Visits % Leads Leads % Installs Installs % Signups Signups % Purchases Purchases % Downloads New Downloads New Subscriber Downloads New Subscribers Converted Devices New Conversions Visitors Modeled Visitors Modeled % Visits Modeled Visits Modeled % Leads Modeled Leads Modeled % Installs Modeled Installs Modeled % Signups Modeled Signups Modeled % Purchases Modeled Purchases Modeled % Downloads Modeled New Downloads Modeled New Subscriber Downloads Modeled New Subscribers Modeled Converted Devices Modeled New Conversions Modeled 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 Week Day Month Advertiser Media Type Type Tags Spend eCPM CPM CPA Publisher Campaign 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 Revenue Revenue Modeled Promo codes 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 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 YouTube Engaged Views Geo Country DMA Code

185 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 timestamp (e.g., “2023-10-10”). Default is 3 months ago.

string

endDate

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

string

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

ytSimulcastConvWeight

Model Conversions For YouTube weight. When useSettingsProfiles is true, can be overridden by the advertiser’s settings profile.

number

rSimulcastConvWeight

Model Conversions For Rumble weight. When useSettingsProfiles is true, can be overridden by the advertiser’s settings profile.

number

0.7

svSimulcastConvWeight

Model Conversions For Spotify Video weight. When useSettingsProfiles is true, can be overridden by the advertiser’s settings profile.

number

0.7

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 per advertiser. 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

incCiCertainty

Confidence interval certainty percent for incrementality confidence-interval columns. Higher certainty produces a wider interval; lower certainty produces a narrower one. Omitted default is 95. Requires showIncrementalResults.

integer

(1–99)

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

geoGrouping

Group impressions by geo. Options: “country”, “zip”, “region”, “DMA”. Note: When “geoGrouping” is used, YouTube modeling will be disabled. “Incrementality Source” is not available for geo-grouped reports.

country zip region DMA

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

aggregateEpisodicBuysPerShow

If true, aggregate episodic buy rows per show (one row per show instead of per episode).

boolean

false

skipCampaignTransliteration

If true, keep original Unicode characters in the Campaign and Campaign & Initiative columns (no ASCII transliteration). Other text columns still transliterate.

boolean

false

campaignTags

Filter campaigns by tags (same as UI reporting campaign tags filter).

Array<string>

campaignTagsExclude

If true, exclude campaigns matching campaignTags instead of including them.

boolean

false

modelPublicSpaceIps

If false, disable public/public-space IP modeling so results are based on YouTube only. Matches the “Model Public Space IPs” toggle in the advertiser dashboard. If useSettingsProfiles is true and a single advertiser is given, the advertiser’s settings profile can override the default.

boolean

true

modelOffline

If true, include offline modeling. If useSettingsProfiles is true and a single advertiser is given, the advertiser’s settings profile can override the default.

boolean

true

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.
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.
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.
Publish Date	string	2023-12-18	Date when the media content was published, in the format YYYY-mm-DD.
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.
<custom_action>	number	123	Count of an advertiser-defined custom event. Header is the action name (e.g. “order_complete”). Also included when `geoGrouping` is set. Mapped actions are excluded by default unless listed in `fields`.
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.
<custom_action> Modeled	number	123	Modeled count of the custom event. Header is “ Modeled” (e.g. “order_complete Modeled”). Also included when `geoGrouping` is set.
Promo codes	number	123	Number of times promo codes associated with the ad were used, 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 GUID	string	episode-guid	Guid of the episode
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`. Not available with `geoGrouping`.
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`. Not available with `geoGrouping`.
Visits Channel Confidence Interval (+/- range)	number	0.02	Channel-level visits incrementality confidence interval. Requires `showIncrementalResults`. Excluded by default; request via `fields`. Not available with `geoGrouping`.
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`. Not available with `geoGrouping`.
Visitors Channel Confidence Interval (+/- range)	number	0.02	Channel-level visitors incrementality confidence interval. Requires `showIncrementalResults`. Excluded by default; request via `fields`. Not available with `geoGrouping`.
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`. Not available with `geoGrouping`.
Signups Channel Confidence Interval (+/- range)	number	0.02	Channel-level signups incrementality confidence interval. Requires `showIncrementalResults`. Excluded by default; request via `fields`. Not available with `geoGrouping`.
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`. Not available with `geoGrouping`.
Purchases Channel Confidence Interval (+/- range)	number	0.02	Channel-level purchases incrementality confidence interval. Requires `showIncrementalResults`. Excluded by default; request via `fields`. Not available with `geoGrouping`.
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`. Not available with `geoGrouping`.
Installs Channel Confidence Interval (+/- range)	number	0.02	Channel-level installs incrementality confidence interval. Requires `showIncrementalResults`. Excluded by default; request via `fields`. Not available with `geoGrouping`.
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`. Not available with `geoGrouping`.
Leads Channel Confidence Interval (+/- range)	number	0.02	Channel-level leads incrementality confidence interval. Requires `showIncrementalResults`. Excluded by default; request via `fields`. Not available with `geoGrouping`.
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`. Not available with `geoGrouping`.
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`. Not available with `geoGrouping`.
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`. Not available with `geoGrouping`.
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`. Not available with `geoGrouping`.
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
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`.
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`.
CPA	number	15	Cost per acquisition. Available only for advertisers with CPA billing enabled.
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`.
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`.
Downloads	number	123	Download count. Smart promo reports only.
New Downloads	number	123	New download count. Smart promo reports only.
New Subscriber Downloads	number	123	New subscriber download count. Smart promo reports only.
New Subscribers	number	123	New subscriber count. Smart promo reports only.
Converted Devices	number	123	Converted device count. Smart promo reports only.
New Conversions	number	123	New conversion count. Smart promo reports only.
Downloads Modeled	number	123	Modeled download count. Smart promo reports only.
New Downloads Modeled	number	123	Modeled new download count. Smart promo reports only.
New Subscriber Downloads Modeled	number	123	Modeled new subscriber download count. Smart promo reports only.
New Subscribers Modeled	number	123	Modeled new subscriber count. Smart promo reports only.
Converted Devices Modeled	number	123	Modeled converted device count. Smart promo reports only.
New Conversions Modeled	number	123	Modeled new conversion count. Smart promo reports only.
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`.
Campaign & Initiative	string	Campaign / Initiative	Combined campaign and initiative label.
Campaign Unit	string	Mid	Booked campaign unit. 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`.
Geo	string	US	Geographic grouping value. Available when `geoGrouping` is provided.
Country	string	US	Country. Available when `geoGrouping` is provided. Excluded by default; request via `fields`.
DMA Code	string	501	DMA code. Available when `geoGrouping` is `"DMA"`. Excluded by default; request via `fields`.

By Campaign

Request Bodyrequired

Example

Example

Response Body

Result file

Request Body^required