Advertiser Overview

POST

/api/public/advertisers/overview

Returns the advertiser summary shown at the top of the advertiser page, plus the estimated spend per month for the advertiser and for each of its competitors, the same data as the advertiser page “Similar” tab. The response is returned directly, without the task system.

Any advertiser tracked by Podscribe can be requested; it does not need to be linked to your account.

This endpoint is available for Pro users with API access.

Rules:

One advertiser per request. A value holding more than one name returns 400.
advertiser is at most 200 characters.
startDate and endDate go together. Sending one without the other returns 400.
Spend is bucketed by calendar month, but the range is honoured to the day: the first and last buckets hold only the days inside the range, and the summary counters cover the same days.
A range touching more than 36 calendar months returns 400. A range whose start month is later than the current one covers no full month and returns 400 as well.
30 requests per minute per user. Beyond that the endpoint returns 429 with Retry-After.

Advertiser Overview

const url = 'https://backend.podscribe.ai/api/public/advertisers/overview';
const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: '{"advertiser":"example","startDate":"example","endDate":"example","countryCode":"example"}'
};

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

payload = {
    "advertiser": "example",
    "startDate": "example",
    "endDate": "example",
    "countryCode": "example"
}
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/overview \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "advertiser": "example", "startDate": "example", "endDate": "example", "countryCode": "example" }'

Request Body^required

application/json

advertiser

required

The advertiser to get the overview for.

string

startDate

First day of the range, e.g., 2023-10-10, included. Its month is reported from this day on, not from the first of the month. Requires endDate. Omit both for the 12 complete months before the current one.

string

endDate

Last day of the range, e.g., 2023-10-10, included. Its month is reported up to this day only, and a date in the future is cut back to today. Requires startDate.

string

countryCode

Two-letter country code, e.g., us. Default is all countries.

string

Example^generated

{
  "advertiser": "example",
  "startDate": "example",
  "endDate": "example",
  "countryCode": "example"
}

Response Body

application/json

advertiser

Summary and monthly spend of the requested advertiser.

{lookupName,name,estSpend,7 more}

lookupName

Podscribe lookup name of the advertiser.

string

name

Display name of the advertiser.

string

estSpend

Estimated spend, $, over the requested range.

number nullable

prevEstSpend

Estimated spend, $, over the preceding range of equal length.

number nullable

episodeCount

Episodes with ads over the requested range.

number nullable

prevEpisodeCount

Episodes with ads over the preceding range of equal length.

number nullable

seriesCount

Shows with ads over the requested range.

number nullable

prevSeriesCount

Shows with ads over the preceding range of equal length.

number nullable

seriesWithHostReadsCount

Shows with host-read ads over the requested range.

number nullable

spendByMonth

One entry per calendar month the requested range touches.

Array<{month,estSpend,episodeCount,1 more}>

month

Month in the format YYYY-mm.

string

estSpend

Estimated spend, $, for the part of the month inside the range.

number

episodeCount

Episodes with ads in that part of the month.

number

seriesCount

Shows with ads in that part of the month.

number

competitors

Brands configured as competitors of the advertiser, with their monthly spend.

Array<{lookupName,name,spendByMonth}>

lookupName

Podscribe lookup name of the competitor.

string

name

Display name of the competitor.

string

spendByMonth

Estimated spend per month, one entry per calendar month the requested range touches.

Array<{month,estSpend}>

month

Month in the format YYYY-mm.

string

estSpend

Estimated spend, $, for the part of the month inside the range.

number

Response example

{
  "advertiser": {
    "lookupName": "betterhelp",
    "name": "BetterHelp",
    "estSpend": 12345678,
    "prevEstSpend": 11000000,
    "episodeCount": 4321,
    "prevEpisodeCount": 4000,
    "seriesCount": 812,
    "prevSeriesCount": 790,
    "seriesWithHostReadsCount": 500,
    "spendByMonth": [
      {
        "month": "2026-08",
        "estSpend": 120000,
        "episodeCount": 300,
        "seriesCount": 90
      }
    ]
  },
  "competitors": [
    {
      "lookupName": "talkspace",
      "name": "Talkspace",
      "spendByMonth": [
        {
          "month": "2026-08",
          "estSpend": 45000
        }
      ]
    }
  ]
}

Advertiser Overview

Request Bodyrequired

Examplegenerated

Response Body

Request Body^required

Example^generated