# Tanod Podcast Search

> Tanod Podcast Search is a paid API for AI agents from tanod.dev, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-28).

Searches Apple Podcasts for a show by name or Apple Podcasts link and returns metadata plus the latest episodes from the show's RSS feed

## Facts

- Endpoint: POST https://tanod.dev/v1/podcast/search?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-28
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/tanod-podcast-search-47a54b5c
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_4gMjacwn8DmjUcEYG4zY1

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability tanod-podcast-search-47a54b5c -d '<json body>'
```

Example prompt: Search Apple Podcasts for 'Lex Fridman Podcast' in the US storefront and give me the show details along with the 5 most recent episodes including their titles, summaries, and audio links.

## When to prefer this

Use this endpoint when you need to search the Apple Podcasts catalog by show name or Apple Podcasts URL and retrieve both show-level metadata and recent episode data in a single call. Prefer it over generic web scraping when you need structured data like the RSS feed URL, Apple Podcasts ID, artwork, and episode audio links directly. Not suitable for Spotify or YouTube podcast lookups.

## Known failure modes

- Podcast not found in Apple directory returns empty matches array
- Spotify or YouTube links are refused with an error
- RSS feed unreachable causes episodes_error to be non-null while show metadata still returns
- Country code not recognized defaults to US or returns no results
- Query exceeding 300 characters is rejected by schema validation
- Episode count outside 0-25 range is clamped or rejected

## How this service works

Podcast search: a podcast name or Apple Podcasts link to its RSS feed URL, show data and latest episodes (utilpeek by Tanod). Use when an agent must find a podcast's RSS feed URL and latest episodes from a show name or Apple link.

## Output

Returns a JSON object with the search query, source, country, and an array of matching podcast shows (name, genre, author, artwork URL, Apple ID, feed URL, episode count, latest release date, Apple Podcasts URL). For the top match, also returns an array of the latest episodes from the RSS feed, each with title, summary, audio enclosure URL and type, published date, duration in seconds, and episode type. Includes an episodes_error field if the feed could not be fetched.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "limit": {
   "type": "integer",
   "default": 3,
   "maximum": 10,
   "minimum": 1,
   "description": "Most shows to return, 1-10 (default 3); the first match is the best one and carries the episodes."
  },
  "query": {
   "type": "string",
   "maxLength": 300,
   "minLength": 1,
   "description": "A podcast name (such as Lex Fridman Podcast) or an Apple Podcasts show link (podcasts.apple.com/.../id<digits>). Spotify and YouTube links are refused."
  },
  "country": {
   "type": "string",
   "default": "us",
   "pattern": "^[a-zA-Z]{2}$",
   "description": "Apple storefront as a two-letter country code (default us)."
  },
  "episodes": {
   "type": "integer",
   "default": 5,
   "maximum": 25,
   "minimum": 0,
   "description": "Latest episodes of the first match to read from its feed, 0-25 (default 5; 0 skips the feed)."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "query": "Lex Fridman Podcast",
  "source": "Apple Podcasts directory (iTunes Search API)",
  "country": "us",
  "matches": [
   {
    "name": "Lex Fridman Podcast",
    "genre": "Technology",
    "author": "Lex Fridman",
    "artwork": "https://is1-ssl.mzstatic.com/image/thumb/Podcasts115/v4/3e/e3/9c/mza_16657851278549137484.png/600x600bb.jpg",
    "country": "USA",
    "apple_id": "1434243584",
    "explicit": false,
    "feed_url": "https://lexfridman.com/feed/podcast/",
    "apple_url": "https://podcasts.apple.com/us/podcast/lex-fridman-podcast/id1434243584?uo=4",
    "episode_count": 502,
    "latest_release": "2026-09-17T00:40:00Z"
   }
  ],
  "episodes": [
   {
    "guid": "https://lexfridman.com/?p=6506",
    "link": "https://lexfridman.com/dhh-2/",
    "title": "#501 – DHH: Future of Programming, AI, Agentic Engineering, Vibe Coding & Linux",
    "season": null,
    "episode": null,
    "summary": "DHH is the creator of Ruby on Rails, Omarchy Linux, CTO of 37signals, and a racecar driver.",
    "enclosure": {
     "url": "https://media.blubrry.com/takeituneasy/ins.blubrry.com/takeituneasy/lex_ai_dhh_2.mp3",
     "type": "audio/mpeg",
     "length": 249955445
    },
    "published": "2026-08-26T21:47:04Z",
    "duration_s": 19317,
    "episode_type": "full"
   }
  ],
  "operation": "podcast-search",
  "episodes_of": "https://lexfridman.com/feed/podcast/",
  "episodes_error": null,
  "untrusted_content": true,
  "episode_count_in_feed": 502
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/tanod-podcast-search-47a54b5c/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from tanod.dev](https://www.zero.xyz/host/tanod.dev/llms.txt)