--- name: z87:podcast description: 1M+ podcasts from PodcastIndex with categories, language, episode counts, popularity scores, and cadence estimates. Field-qualified search across title, author, description, category, language, and explicit. --- Anonymous: 600 tok/min. Key: `GET https://z87.ai/api/use` → `X-Api-Key` header, 6000 tok/min. On `429`, wait 1s. Start with /stats to see available categories, languages, and their counts. Field-qualified search. Every token must be prefixed with a field name. Fields: title, author, description, category, language, explicit. Examples: /search?q=title:true crime — search titles for "true crime" /search?q=category:comedy language:en — English comedy podcasts /search?q=title:science category:education language:de — German science education podcasts /search?q=author:joe rogan — search by author /search?q=description:murder mystery category:true crime — description search + category filter /search?q=category:comedy explicit:false — clean comedy Search returns full data including feed_url, website, image_url, apple_url, days_since_last, expected_in_days. Ranking: BM25 relevance + popularity + freshness + episode depth. Freshness: published today +3, this week ~+2, this month ~+1, older fades to 0. Episode depth: logarithmic boost for established shows (ln(episodes) * 0.3). Stale feeds sink naturally. Browse without text: /search?max_stale=30 returns all podcasts updated in the last 30 days. Omit q to browse with filters only. Freshness filter: &max_stale=30 excludes podcasts that haven't published in 30+ days. Coming up: &coming=today (or week, month, or a number of days) — only shows with an expected episode within that window. Autocomplete: /suggest?q=serial — prefix completion on titles. Detail: /details/{id} — same fields as search, for direct ID lookup. Random: /random — random podcast. All endpoints accept both **GET with query parameters** and **POST with JSON body**. ## Endpoints ### `https://z87.ai/api/podcast/search` Field-qualified search. Fields: title, author, description, category, language, explicit. Filters: max_stale (days since last episode), coming (today/week/month/N days until next) | Param | Type | Required | Default | |-------|------|----------|---------| | q | string | no | — | | max_stale | u32 | no | — | | coming | string | no | — | | limit | u32 | no | 20 | | offset | u32 | no | 0 | **Example:** `GET https://z87.ai/api/podcast/search?q=title:coin+category:technology&limit=1` **Response:** ```json { "podcasts": [ { "id": 131978, "title": "Insert Coin", "author": "Xataka", "description": "... es una sección en la que entrevistamos a invitados super especialistas técnicos en materias que n...", "language": "es", "categories": ["technology"], "episode_count": 14, "explicit": false } ], "total": 8, "limit": 1, "offset": 0 } ``` ### `https://z87.ai/api/podcast/suggest` Autocomplete podcast titles by prefix | Param | Type | Required | Default | |-------|------|----------|---------| | q | string | **yes** | — | | limit | u32 | no | 20 | **Example:** `GET https://z87.ai/api/podcast/suggest?q=serial&limit=5` **Response:** ```json {"podcasts": [{"id": 8519, "name": "Serial Killers: Real Life Documentaries"}, "...4 more"]} ``` ### `https://z87.ai/api/podcast/details/{id}` Podcast detail by ID — same fields as search results No parameters. **Example:** `GET https://z87.ai/api/podcast/details/0` **Response:** ```json { "podcast": { "id": 0, "title": "VGT TV - Việt Giải Trí", "author": "VGT TV", "description": "...re-up) dưới mọi hình thức▶ Các vấn đề liên quan đến bản quyền, nội dung, k...", "language": "vi", "categories": ["news", "...1 more"], "episode_count": 7461, "explicit": false } } ``` ### `https://z87.ai/api/podcast/random` Random podcast No parameters. **Example:** `GET https://z87.ai/api/podcast/random` **Response:** ```json { "podcast": { "id": 80640, "title": "Beyond Compassion Fatigue: Make Your Passion for Helping Animals Sustainable!", "author": "Jen Blough", "description": "...nable. If you're involved in animal caregiving, rescue, trap-neuter return (TNR), sheltering, animal...", "language": "en", "categories": ["health", "...6 more"], "episode_count": 45, "explicit": false } } ``` ### `https://z87.ai/api/podcast/stats` Dataset statistics — category and language distributions No parameters. **Example:** `GET https://z87.ai/api/podcast/stats` **Response:** ```json { "total": 1057392, "fields": { "category": [ ["society", 195101], ["culture", 193898], ["education", 164230], ["business", 141009], ["religion", 121821], ["spirituality", 121209], ["news", 101265], ["arts", 100493], ["health", 93973], ["fitness", 90079], ["sports", 76177], ["comedy", 75984], ["self improvement", 70287], ["music", 64978], ["christianity", 63937], ["leisure", 61834], ["tv", 49589], ["film", 49306], ["entrepreneurship", 38064], ["technology", 36390], ["science", 36244], ["kids", 33684], ["family", 33228], ["mental", 33032], ["personal", 32942], ["journals", 31506], ["history", 30233], ["politics", 25352], ["books", 25142], ["fiction", 24502], ["games", 22488], ["careers", 19939], ["relationships", 19842], ["hobbies", 19776], ["interviews", 19493], ["commentary", 19094], ["marketing", 17169], ["management", 15884], ["investing", 14786], ["performing", 13978], ["places", 13080], ["travel", 12620], ["medicine", 12430], ["government", 12356], ["documentary", 12151], ["philosophy", 12119], ["reviews", 12055], ["entertainment", 11842], ["how to", 11727], ["true crime", 11609], "...57 more" ], "language": [ ["en", 697071], ["es", 86735], ["de", 37532], ["pt", 31964], ["fr", 29781], ["zh", 27907], ["ja", 17210], ["it", 15949], ["ru", 10536], ["nl", 9462], ["sv", 6482], ["ar", 6418], ["pl", 5309], ["da", 4292], ["tr", 3770], ["he", 3662], ["hi", 3323], ["vi", 3044], ["cs", 2998], ["fa", 2981], ["no", 2941], ["id", 2543], ["fi", 2509], ["ca", 2214], ["ko", 2141], ["hu", 1578], ["th", 1388], ["el", 1288], ["sk", 1211], ["ta", 1183], ["uk", 1071], ["nb", 994], ["bg", 984], ["ro", 918], ["et", 609], ["is", 597], ["sl", 572], ["te", 437], ["ms", 428], ["af", 378], ["ml", 378], ["sr", 377], ["lv", 364], ["lt", 351], ["bn", 275], ["mr", 264], ["hr", 258], ["sw", 198], ["eu", 191], ["my", 185], "...12 more" ], "explicit": [["false", 891172], ["true", 166220]] } } ``` ## License The z87 API code is MIT licensed. Each dataset carries its upstream license: - **podcast**: PodcastIndex database is MIT licensed (https://github.com/Podcastindex-org/database). Feed metadata (titles, descriptions, URLs) originates from podcast publishers via RSS. z87 API code is MIT. --- ## Other z87 Datasets - [chess](https://z87.ai/api/chess/SKILL.md) — 1B+ Lichess games (2000+ Elo, 2013-2026) - [colors](https://z87.ai/api/colors/SKILL.md) — Unified paint color database: ~30K colors across 20+ brands with cross-brand matching via CIEDE2000 perceptual distance, color harmony generation, coordinating color strips, and palette suggestions. - [companies_uk](https://z87.ai/api/companies_uk/SKILL.md) — 5.7M UK companies from Companies House - [countries](https://z87.ai/api/countries/SKILL.md) — 247 countries with 282 indicators (57 static, 225 timeseries) across economics, health, demographics, energy, environment, education, and more - [design](https://z87.ai/api/design/SKILL.md) — 1,003 production-grade frontend designs with HTML, screenshots, prompts, and structured metadata (26 categories, 40 styles, 4K+ tags) - [food](https://z87.ai/api/food/SKILL.md) — Recipes, FDC ingredients, and food products: 13.5K recipes with nutrition, 8K+ FDC ingredients, curated products with Nutri-Score and NOVA ratings. - [gbif](https://z87.ai/api/gbif/SKILL.md) — GBIF Backbone Taxonomy: 7.7 million taxa with full taxonomic hierarchy, synonym resolution, tree navigation, and full-text search across the tree of life. - [gutenberg](https://z87.ai/api/gutenberg/SKILL.md) — 60,000 Project Gutenberg books with chapter-level access, BM25 full-text search, cover art, illustrations, and AI-generated tags (genre, mood, era, locations, five-word summaries). - [holidays](https://z87.ai/api/holidays/SKILL.md) — 3,391 public holidays across 121 countries (2026–2027) - [home](https://z87.ai/api/home/SKILL.md) — Unified smart home device database - [jokes](https://z87.ai/api/jokes/SKILL.md) — 41,000 jokes from three sources, AI-tagged with category, rating, topics, and offensive score - [manpages](https://z87.ai/api/manpages/SKILL.md) — 142K Linux man pages with AI-generated cheat cards, category tags, use-frequency scores, and plain-english descriptions - [movies](https://z87.ai/api/movies/SKILL.md) — 360K+ movies with 40-axis taste profiles, cast, themes, ratings, and soundtrack data - [mtg](https://z87.ai/api/mtg/SKILL.md) — 29K Magic: The Gathering cards with synergy graph engine, combo detection, and Commander deck builder. - [music](https://z87.ai/api/music/SKILL.md) — 651K artists, 500K+ albums, 1M+ songs from MusicBrainz with genre, country, and member data - [osm](https://z87.ai/api/osm/SKILL.md) — 46M+ OpenStreetMap POIs with Hilbert-curve spatial index and BM25 text search - [restaurants](https://z87.ai/api/restaurants/SKILL.md) — 10K London restaurants with menus, Michelin stars, ingredient category scores (seafood, meat, game, etc.), and capacity data - [solve](https://z87.ai/api/solve/SKILL.md) — Computation engine: symbolic algebra, statistics, regression, finance, graph algorithms, Monte Carlo simulation - [wikipedia](https://z87.ai/api/wikipedia/SKILL.md) — 7.2 million English Wikipedia articles with full markdown content, infoboxes, inter-article links, and geographic coordinates. - [wiktionary](https://z87.ai/api/wiktionary/SKILL.md) — 8M+ Wiktionary entries across 4,000+ languages Full index: [https://z87.ai/api/SKILL.md](https://z87.ai/api/SKILL.md)