Estimated Spend by Day

POST

/api/public/advertisers/estimated-spend-by-day

Estimated ad spend per advertiser and day, split by host-read and producer-read ads.

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/advertisers/estimated-spend-by-day';
const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: '{"name":"example","advertisers":["example"],"startDate":"2026-04-15","endDate":"2026-04-15"}'
};

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/advertisers/estimated-spend-by-day"

payload = {
    "name": "example",
    "advertisers": ["example"],
    "startDate": "2026-04-15",
    "endDate": "2026-04-15"
}
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/advertisers/estimated-spend-by-day \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "name": "example", "advertisers": [ "example" ], "startDate": "2026-04-15", "endDate": "2026-04-15" }'

Request Body^required

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)

advertisers

required

An array containing the advertiser names.

Array<string>

startDate

Start date timestamp, e.g., 2023-10-10, default is 12 months ago.

string<date>

endDate

End date timestamp, e.g., 2023-10-10, default is one week from today.

string<date>

Example^generated

{
  "name": "example",
  "advertisers": [
    "example"
  ],
  "startDate": "2026-04-15",
  "endDate": "2026-04-15"
}

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
Day	string	2023-12-23T00:00:00.000Z	Date of the day as an ISO 8601 timestamp.
Advertiser	string	demoAdvertiser	Name of the advertiser for the media content.
Estimated Spend	number	123	Estimated spend
Read By	string	Host	Read by, can be Host or Producer.

Estimated Spend by Day

Request Bodyrequired

Examplegenerated

Response Body

Result file

Request Body^required

Example^generated