FeedIndexResponse

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/bidclub-ai/json-schema/bidclub-ai-feed-index-response-schema.json",
  "title": "FeedIndexResponse",
  "x-generated": "2026-11-02",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/bidclub-ai-openapi.json#/components/schemas/FeedIndexResponse",
  "type": "object",
  "required": [
    "count",
    "episodes"
  ],
  "properties": {
    "count": {
      "type": "integer"
    },
    "episodes": {
      "type": "array",
      "items": {
        "$ref": "#/$defs/FeedIndexItem"
      }
    }
  },
  "$defs": {
    "FeedIndexItem": {
      "type": "object",
      "required": [
        "slug",
        "show_id",
        "show",
        "title"
      ],
      "properties": {
        "slug": {
          "type": "string",
          "description": "Stable public identifier."
        },
        "show_id": {
          "type": "string",
          "description": "Foreign key into /api/v1/shows."
        },
        "show": {
          "type": "string",
          "description": "Show display name, flattened."
        },
        "title": {
          "type": "string",
          "description": "Complete canonical publisher title."
        },
        "display_title": {
          "type": [
            "string",
            "null"
          ],
          "description": "Feed-only compression of an overlength title; null when unneeded."
        },
        "title_alt": {
          "type": [
            "string",
            "null"
          ],
          "description": "Title in the alternate language (lang_alt)."
        },
        "display_title_alt": {
          "type": [
            "string",
            "null"
          ]
        },
        "title_orig": {
          "type": [
            "string",
            "null"
          ],
          "description": "Source-platform title when it differs."
        },
        "dek": {
          "type": [
            "string",
            "null"
          ],
          "description": "One-line editorial standfirst."
        },
        "dek_alt": {
          "type": [
            "string",
            "null"
          ]
        },
        "chips": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "description": "Participant tags, each prefixed \"person:\" (e.g. \"person:Jensen Huang\")."
        },
        "lang": {
          "type": [
            "string",
            "null"
          ],
          "enum": [
            "EN",
            "ZH",
            null
          ],
          "description": "Language of the primary editorial fields."
        },
        "date": {
          "type": [
            "string",
            "null"
          ],
          "description": "Publication calendar date, YYYY-MM-DD."
        },
        "published_at": {
          "type": [
            "string",
            "null"
          ],
          "description": "Exact publication timestamp (RFC 3339); null for date-only archives."
        },
        "duration_min": {
          "type": [
            "number",
            "null"
          ],
          "description": "Episode length in minutes."
        },
        "youtube_id": {
          "type": [
            "string",
            "null"
          ]
        },
        "thumbnail_url": {
          "type": [
            "string",
            "null"
          ]
        },
        "source_url": {
          "type": [
            "string",
            "null"
          ]
        },
        "source_label": {
          "type": [
            "string",
            "null"
          ]
        },
        "tag_assets": {
          "type": "array",
          "maxItems": 2,
          "uniqueItems": true,
          "items": {
            "type": "string",
            "enum": [
              "equities",
              "crypto",
              "vc_pe",
              "other"
            ]
          },
          "description": "Zero to two closed asset taxonomy ids, primary first. Empty is valid even after classification."
        },
        "tag_sectors": {
          "type": "array",
          "maxItems": 2,
          "uniqueItems": true,
          "items": {
            "type": "string",
            "enum": [
              "ai_software",
              "semis",
              "robotics",
              "biotech",
              "consumer",
              "finance",
              "blockchain",
              "energy",
              "space_defense"
            ]
          },
          "description": "Zero to two closed sector taxonomy ids, primary first. Empty is valid even after classification."
        },
        "tag_focus": {
          "type": "array",
          "maxItems": 2,
          "uniqueItems": true,
          "items": {
            "type": "string",
            "enum": [
              "investing",
              "company_building",
              "technical",
              "macro",
              "policy"
            ]
          },
          "description": "Zero to two closed editorial-focus taxonomy ids, primary first. Empty is valid even after classification."
        },
        "tagging_status": {
          "type": "string",
          "enum": [
            "pending",
            "classified",
            "failed",
            "skipped"
          ],
          "description": "Classification state. Non-classified episodes have empty tag arrays; classified does not require a tag in every facet."
        },
        "tagging_version": {
          "type": [
            "string",
            "null"
          ],
          "description": "Taxonomy version used for classification; nonblank when tagging_status is classified, otherwise it may be null."
        }
      }
    }
  }
}