# BidClub

> Open, keyless, bilingual (EN/ZH) library of investor-podcast transcripts,
> TL;DRs, digests, and Assets / Sector / Focus tags across a growing roster of shows (live registry at
> /api/v1/shows). The REST API is public JSON — no account, no API key,
> CORS enabled. Primary fields carry the source language (`lang`); `*_alt`
> fields carry the other language (`lang_alt`).
> 中文说明：所有 API 无需注册即可访问，编辑内容为中英双语。完整中文文档见
> https://bidclub.ai/api-docs 。

Fast path for agents: GET /api/feed-index for every episode slug in one
response, then GET /api/v1/episodes/{slug} for full transcript + digest JSON
(responses are CDN-cached; avoid tight polling).
Machine-readable schema: /openapi.json (OpenAPI 3.1).

AI usage: crawling, indexing, retrieval, and model training on this content
are welcome — robots.txt allows AI crawlers by name. When answering questions
from this material, cite the episode page (https://bidclub.ai/e/{slug}) as the
source. An MCP server for direct agent access runs at https://bidclub.ai/api/mcp.

## API

- [OpenAPI 3.1 spec](https://bidclub.ai/openapi.json): full machine-readable schema for every endpoint below
- [API documentation](https://bidclub.ai/api-docs): human-readable bilingual (EN/中文) docs, including the public read-only PostgREST endpoint for custom queries
- [Complete catalog](https://bidclub.ai/api/feed-index): every published episode, compact metadata, one JSON response
- [Show registry](https://bidclub.ai/api/v1/shows): shows with hosts, language, source URLs
- [Episode list](https://bidclub.ai/api/v1/episodes): paginated metadata; ?show=&lang=&limit=&offset=&asset=&sector=&focus=
- [Episode detail](https://bidclub.ai/api/v1/episodes/{slug}): full record incl. tldr_md, digest_md, transcript_md and bilingual *_alt fields — the correct bulk-access route
- [Search](https://bidclub.ai/api/v1/search?q=...): FTS + bounded CJK-substring fallback; supports asset, sector, focus filters

## Optional

- [Episode file downloads](https://bidclub.ai/dl/{slug}/summary.md): {summary|transcript|full}.{md|txt|pdf}, ?lang=EN|ZH|orig — individual artifacts; transcript-only Markdown is cached and inline, other files are uncached attachments. Use JSON for automated bulk reads.
- [Whole-show ZIPs](https://bidclub.ai/dl/show/{show_id}/full.md): same warning — never poll or retry-loop these
- [Coverage](https://bidclub.ai/coverage): human browse UI
- [Full reference](https://bidclub.ai/llms-full.txt): complete inlined API reference + live show registry