BidClub · Schema

Episode

CompanyInvestmentPodcastsResearch

Properties

Name Type Description
slug string Stable public identifier.
show_id string Foreign key into /api/v1/shows.
title string Complete canonical publisher title.
display_title stringnull Feed-only compression of an overlength title; null when unneeded.
title_orig stringnull Source-platform title when it differs.
dek stringnull One-line editorial standfirst.
lang stringnull Language of the primary editorial fields.
date stringnull Publication calendar date, YYYY-MM-DD.
published_at stringnull Exact publication timestamp (RFC 3339); null for date-only archives.
duration_min numbernull Episode length in minutes.
source_url stringnull
source_label stringnull
rss_url stringnull
youtube_id stringnull
youtube_url stringnull
provenance array Ordered [stage, tool] pairs recording how the episode was produced.
chips array Participant tags, each prefixed "person:" (e.g. "person:Jensen Huang").
tag_assets array Zero to two closed asset taxonomy ids, primary first. Empty is valid even after classification.
tag_sectors array Zero to two closed sector taxonomy ids, primary first. Empty is valid even after classification.
tag_focus array Zero to two closed editorial-focus taxonomy ids, primary first. Empty is valid even after classification.
tagging_status string Classification state. Non-classified episodes have empty tag arrays; classified does not require a tag in every facet.
tagging_version stringnull Taxonomy version used for classification; nonblank when tagging_status is classified, otherwise it may be null.
thumbnail_url stringnull
title_alt stringnull Title in the alternate language (lang_alt).
display_title_alt stringnull
dek_alt stringnull
lang_alt stringnull Language of every *_alt field.
tldr_md stringnull TL;DR bullets as Markdown.
digest_md stringnull Structured digest as Markdown.
transcript_md stringnull Full speaker-attributed transcript.
tldr_md_alt stringnull
digest_md_alt stringnull
shows objectnull
View JSON Schema on GitHub

JSON Schema

bidclub-ai-episode-schema.json Raw ↑
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/bidclub-ai/json-schema/bidclub-ai-episode-schema.json",
  "title": "Episode",
  "x-generated": "2026-11-02",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/bidclub-ai-openapi.json#/components/schemas/Episode",
  "type": "object",
  "required": [
    "slug",
    "show_id",
    "title"
  ],
  "properties": {
    "slug": {
      "type": "string",
      "description": "Stable public identifier."
    },
    "show_id": {
      "type": "string",
      "description": "Foreign key into /api/v1/shows."
    },
    "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_orig": {
      "type": [
        "string",
        "null"
      ],
      "description": "Source-platform title when it differs."
    },
    "dek": {
      "type": [
        "string",
        "null"
      ],
      "description": "One-line editorial standfirst."
    },
    "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."
    },
    "source_url": {
      "type": [
        "string",
        "null"
      ]
    },
    "source_label": {
      "type": [
        "string",
        "null"
      ]
    },
    "rss_url": {
      "type": [
        "string",
        "null"
      ]
    },
    "youtube_id": {
      "type": [
        "string",
        "null"
      ]
    },
    "youtube_url": {
      "type": [
        "string",
        "null"
      ]
    },
    "provenance": {
      "type": "array",
      "description": "Ordered [stage, tool] pairs recording how the episode was produced.",
      "items": {
        "type": "array",
        "items": {
          "type": "string"
        },
        "minItems": 2,
        "maxItems": 2
      }
    },
    "chips": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Participant tags, each prefixed \"person:\" (e.g. \"person:Jensen Huang\")."
    },
    "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."
    },
    "thumbnail_url": {
      "type": [
        "string",
        "null"
      ]
    },
    "title_alt": {
      "type": [
        "string",
        "null"
      ],
      "description": "Title in the alternate language (lang_alt)."
    },
    "display_title_alt": {
      "type": [
        "string",
        "null"
      ]
    },
    "dek_alt": {
      "type": [
        "string",
        "null"
      ]
    },
    "lang_alt": {
      "type": [
        "string",
        "null"
      ],
      "enum": [
        "EN",
        "ZH",
        null
      ],
      "description": "Language of every *_alt field."
    },
    "tldr_md": {
      "type": [
        "string",
        "null"
      ],
      "description": "TL;DR bullets as Markdown."
    },
    "digest_md": {
      "type": [
        "string",
        "null"
      ],
      "description": "Structured digest as Markdown."
    },
    "transcript_md": {
      "type": [
        "string",
        "null"
      ],
      "description": "Full speaker-attributed transcript."
    },
    "tldr_md_alt": {
      "type": [
        "string",
        "null"
      ]
    },
    "digest_md_alt": {
      "type": [
        "string",
        "null"
      ]
    },
    "shows": {
      "type": [
        "object",
        "null"
      ],
      "properties": {
        "name": {
          "type": "string"
        },
        "hosts": {
          "type": [
            "string",
            "null"
          ]
        }
      }
    }
  }
}

Work with this as data

Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for schemas

4 MCP tools reach this
  • find_json_schemasBrowse and filter every JSON Schema in the catalog.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This JSON Schema
curl "https://apis.io/api/v1/json-schemas/bidclub-ai-episode"
All schemas
curl "https://apis.io/api/v1/json-schemas?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.