PageResponse_CampaignDto_

A single page of results. nextCursor is an opaque token to pass back as ?cursor= to fetch the following page; null means there are no more results.

items object[]required

Array [

idstring

Unique identifier of the campaign

Example: 7Hb2Kp9QvL3mNx0R8tZ4

networkIdstring

Identifier of the network that owns the campaign

Example: 9Fc4Lm2RtN6pQx1S7wZ3

createdAtdate-time

Timestamp when the campaign was created

Example: 2026-01-15T09:30:00Z

updatedAtdate-time

Timestamp when the campaign was last updated

Example: 2026-01-15T09:30:00Z

platformstring

Ad-serving platform the campaign targets

Possible values: [adbridge, adswizz, megaphone]

Example: adswizz

adswizz objectnullable

Link to the campaign in Adswizz; present only when platform is adswizz

campaignIdstring

Identifier of the linked campaign in Adswizz

Example: az_8421907

advertiserIdstringnullable

Identifier of the advertiser this campaign runs for, if assigned

Example: 3Kd7Np5RvM9qWx2T8yZ6

advertiser objectnullable

The campaign's advertiser; present only when ?expand=advertiser was requested.

idstring

Unique identifier of the advertiser

Example: 3Kd7Np5RvM9qWx2T8yZ6

namestring

Name of the advertiser

Example: Acme Corp

namestring

Human-readable name of the campaign

Example: Spring Launch 2026

brandNamestring

Brand being advertised in the campaign

Example: Acme Corp

productNamestring

Product being advertised in the campaign

Example: Acme Pro Headphones

productCategorystring

Category the advertised product belongs to

Example: Consumer Electronics

startDatedate-timenullable

Date the campaign is scheduled to start running

Example: 2026-01-15T09:30:00Z

endDatedate-timenullable

Date the campaign is scheduled to stop running

Example: 2026-03-15T09:30:00Z

budgetdoublenullable

Total campaign budget in US dollars

Example: 50000

cpmdoublenullable

Cost per thousand impressions (CPM) in US dollars

Example: 25

categoriesstring[]

Content categories the campaign is eligible to run against

adVariants object[]

Ad variants (copy and configuration) defined for the campaign

Array [

idstring

Unique identifier of the ad-copy variant.

Example: 2Bx6Rk9LtN5mZq8Wv4G

namestring

Human-readable name of the variant.

Example: Holiday promo

adCopystring

The ad copy text for this variant.

Example: This episode is brought to you by Acme...

]

excludedPodcastIdsstring[]

Identifiers of podcasts explicitly excluded from this campaign

targeting objectnullable

Free-form targeting parameters for the campaign (e.g. geo). Structure is open and platform-defined.

property name*object

tracking objectnullable

Free-form tracking configuration for the campaign (e.g. a tracking pixel). Structure is open and platform-defined.

property name*object

targetingCsv objectnullable

CSV file listing the campaign's targeting, if uploaded

filenamestring

Original filename of the uploaded CSV

Example: spring-targets.csv

urlstring

URL where the stored CSV can be downloaded

Example: https://cdn.example.com/campaigns/7Hb2Kp9QvL3mNx0R8tZ4/targets.csv

sizeint64

Size of the CSV file in bytes

Example: 2048

uploadedAtstring

Timestamp when the CSV was uploaded (ISO-8601)

Example: 2026-01-15T09:30:00Z

trackingCsv objectnullable

CSV file listing the campaign's tracking, if uploaded

filenamestring

Original filename of the uploaded CSV

Example: spring-targets.csv

urlstring

URL where the stored CSV can be downloaded

Example: https://cdn.example.com/campaigns/7Hb2Kp9QvL3mNx0R8tZ4/targets.csv

sizeint64

Size of the CSV file in bytes

Example: 2048

uploadedAtstring

Timestamp when the CSV was uploaded (ISO-8601)

Example: 2026-01-15T09:30:00Z

statusstring

Campaign lifecycle status

Possible values: [pending, active, completed, cancelled, archived]

]

nextCursorstringnullable

PageResponse_CampaignDto_

{
  "items": [
    {
      "id": "7Hb2Kp9QvL3mNx0R8tZ4",
      "networkId": "9Fc4Lm2RtN6pQx1S7wZ3",
      "createdAt": "2026-01-15T09:30:00Z",
      "updatedAt": "2026-01-15T09:30:00Z",
      "platform": "adswizz",
      "adswizz": {
        "campaignId": "az_8421907"
      },
      "advertiserId": "3Kd7Np5RvM9qWx2T8yZ6",
      "advertiser": {
        "id": "3Kd7Np5RvM9qWx2T8yZ6",
        "name": "Acme Corp"
      },
      "name": "Spring Launch 2026",
      "brandName": "Acme Corp",
      "productName": "Acme Pro Headphones",
      "productCategory": "Consumer Electronics",
      "startDate": "2026-01-15T09:30:00Z",
      "endDate": "2026-03-15T09:30:00Z",
      "budget": 50000,
      "cpm": 25,
      "categories": [
        "string"
      ],
      "adVariants": [
        {
          "id": "2Bx6Rk9LtN5mZq8Wv4G",
          "name": "Holiday promo",
          "adCopy": "This episode is brought to you by Acme..."
        }
      ],
      "excludedPodcastIds": [
        "string"
      ],
      "targeting": {},
      "tracking": {},
      "targetingCsv": {
        "filename": "spring-targets.csv",
        "url": "https://cdn.example.com/campaigns/7Hb2Kp9QvL3mNx0R8tZ4/targets.csv",
        "size": 2048,
        "uploadedAt": "2026-01-15T09:30:00Z"
      },
      "trackingCsv": {
        "filename": "spring-targets.csv",
        "url": "https://cdn.example.com/campaigns/7Hb2Kp9QvL3mNx0R8tZ4/targets.csv",
        "size": 2048,
        "uploadedAt": "2026-01-15T09:30:00Z"
      },
      "status": "pending"
    }
  ],
  "nextCursor": "string"
}