ChannelSponsor

{
  "type": "object",
  "properties": {
    "entity": {
      "allOf": [
        {
          "$ref": "#/components/schemas/EntityRef"
        },
        {
          "description": "The sponsoring entity."
        }
      ]
    },
    "ad_reads": {
      "type": "integer",
      "description": "Number of ad_read recommendations for this sponsor on the channel."
    },
    "videos": {
      "type": "integer",
      "description": "Number of distinct videos containing those ad reads."
    },
    "first_seen": {
      "type": [
        "string",
        "null"
      ],
      "description": "Publish timestamp of the earliest video with an ad read. Null when unknown."
    },
    "last_seen": {
      "type": [
        "string",
        "null"
      ],
      "description": "Publish timestamp of the most recent video with an ad read. Null when unknown."
    },
    "sponsor_status": {
      "type": [
        "object",
        "null"
      ],
      "properties": {
        "status": {
          "type": "string",
          "description": "Curated sponsorship status from the known-advertisers dataset. Values: active (currently sponsoring), lapsed (no recent ad reads), ended (relationship known to have ended), uncertain (signal too weak to classify)."
        },
        "ad_count": {
          "type": [
            "integer",
            "null"
          ],
          "description": "Curated ad count from the known-advertisers dataset."
        },
        "first_ad_date": {
          "type": [
            "string",
            "null"
          ],
          "description": "Curated first-ad date. Null when not recorded."
        },
        "last_ad_date": {
          "type": [
            "string",
            "null"
          ],
          "description": "Curated last-ad date. Null when not recorded."
        }
      },
      "required": [
        "status",
        "ad_count",
        "first_ad_date",
        "last_ad_date"
      ],
      "description": "Curated known-advertiser record for this sponsor/channel pair. Null unless the pair exists in the curated dataset."
    }
  },
  "required": [
    "entity",
    "ad_reads",
    "videos",
    "first_seen",
    "last_seen",
    "sponsor_status"
  ]
}