Lag

POST

/api/public/reports/lag

Attributed actions per day after the impression, for each action and groupKey value.

This endpoint utilizes a task system.

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

Lag

const url = 'https://backend.podscribe.ai/api/public/reports/lag';
const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: '{"name":"example","groupKey":"mediaType","actions":["example"],"startDate":"2026-04-15","endDate":"2026-04-15","advertiser":["example"],"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,"useNonPurchasesRevenue":false,"campaignTags":["example"],"campaignTagsExclude":false}'
};

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

payload = {
    "name": "example",
    "groupKey": "mediaType",
    "actions": ["example"],
    "startDate": "2026-04-15",
    "endDate": "2026-04-15",
    "advertiser": ["example"],
    "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,
    "useNonPurchasesRevenue": False,
    "campaignTags": ["example"],
    "campaignTagsExclude": False
}
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/lag \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "name": "example", "groupKey": "mediaType", "actions": [ "example" ], "startDate": "2026-04-15", "endDate": "2026-04-15", "advertiser": [ "example" ], "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, "useNonPurchasesRevenue": false, "campaignTags": [ "example" ], "campaignTagsExclude": false }'

Request Body

application/json

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)

groupKey

required

Specifies the field to group the results by.

mediaType publisher campaigns series genres country

1 moreLess

actions

List of target actions to include in the report. The most popular actions are: - purchase - visitor - signup - install - lead Other actions can be specified as well if they are sent by the advertiser. Empty list means all actions.

Array<string>

startDate

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

string<date>

endDate

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

string<date>

advertiser

required

List of advertiser names. Must contain exactly one advertiser.

Array<string>

ytSimulcastConv

Ignored by this report.

boolean

rSimulcastConv

Ignored by this report.

boolean

svSimulcastConv

Ignored by this report.

boolean

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, the Day columns will show incremental actions.

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

useNonPurchasesRevenue

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

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

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
Action	string	purchase	Target action, such as purchase/visitor/signup
Object ID	string	podcast	ID of the object as resulted by applying the provided groupKey
Day 1…N	number	3.5	How many of the total actions had a lag in the N-th 24-hour period after the impression (Day 1 = 0-24 h, Day 2 = 24-48 h). A window of W days has W + 1 day columns.