> Parel documentation. Index of every page: https://parel.si/docs/llms.txt. This page in HTML: https://parel.si/docs/tools/search_podcasts

# search_podcasts

> Podcast episodes found by what was said in them, with the show, hosts, guests and the passage that matches. ₹0.79 per call; no matches is ₹0.

## What it does

Finds podcast episodes by what was said in them, not only by title: describe a show, a guest, a topic or a claim. Each row of `data.results[]` has `title`, `publishedDate`, `text` (the episode header: show, duration, language, hosts and guests, then the start of the transcript) and `highlights[]` (the passage of the transcript that matches).

It does not return a whole transcript, and there is no link to an episode page. For news on the same subject use [`search_news`](https://parel.si/docs/tools/search_news.md).

India: Indian shows are covered, in English and Hindi. Name the show or the guest for the best results.

## Inputs

Generated from the contract captured from staging on 2026-11-05.

| Field | Type | Required | Description |
|---|---|---|---|
| `query` | string | yes | The episode or what was said: a show, a guest, a topic, a claim ("what Nithin Kamath said about raising venture capital"). |
| `numResults` | integer | no | How many episodes, 1 to 10. Default 10.; min 1, max 10 |
| `endPublishedDate` | string | no | Latest air date, ISO 8601. |
| `startPublishedDate` | string | no | Earliest air date, ISO 8601 ("2026-01-01"). |

## What drives the cost

Nothing you can turn: flat per call for up to ten results, so ask for ten (`numResults` above 10 is refused, free). No matches is `class: "ok_free"`, ₹0.

## Price today

| | |
|---|---|
| Price today | **₹0.79** per call (`cost_paise: 79`) at ₹93.93 per US dollar on 17 November 2026 |
| Hold before the call | ₹1.19 (`hold_paise: 119`); when the call settles the real price is charged and the unused part is released |
| ₹0 when | it fails, or the provider answers but there is nothing in it (an empty list, no email, no page): `class: "ok_free"`, ₹0 |
| Timeout | 30 s, then `upstream_timeout` (₹0, retryable) |
| Over MCP | `run_tool` with `tool: "search_podcasts"` |
| Over REST | `POST https://api.parel.si/v1/run` with `"tool": "search_podcasts"` |
| Confirmation | not needed (the estimate is under the ₹200 threshold) |

## Request

```bash
curl https://api.parel.si/v1/run \
  -H "Authorization: Bearer $PAREL_KEY" \
  -H "Content-Type: application/json" \
  -d '{"tool":"search_podcasts","input":{"query":"what Nithin Kamath said about building Zerodha without venture capital","numResults":5}}'
```

## What comes back

`data.results[]`. A real answer recorded during the live check of 2026-11-05, trimmed to two rows:

```json
{
  "results": [
    {
      "title": "Can Stock Trading Make You Money? | Nithin Kamath | Paisa Vaisa (Archive) Part 2",
      "publishedDate": "2026-10-12T12:30:00.000Z",
      "text": "# Can Stock Trading Make You Money? | Nithin Kamath | Paisa Vaisa (Archive) Part 2\n\n- **Podcast:** Paisa Vaisa with Anupam Gupta\n- **Published:** 2026-10-12T12:30:00+00:00\n- **Duration:** 28:30.890\n- **Language:** en\n- **Episode:** 590\n- **Hosts:** Anupam Gupta\n- **Guests:** Nithin Kamath\n\n## Transcript\n\n**Anupam Gupta · 00:04.073–00:22.663**\n\nMarkets don't take a break and neither do conversations about money. Folks…",
      "highlights": [
        "Right. I think, I think firstly, I've spoken to, I don't know how good a trader I am, but I, I think one of the good things that has happened to me in my life is I've actually been able to speak to a lot of good traders as well. And good traders who actually make money, you know, and not really just…"
      ]
    },
    {
      "title": "Why Zero1 by Zerodha quietly stopped funding creators | ft. Prateek Singh",
      "publishedDate": "2026-08-26T13:38:54.000Z",
      "text": "# Why Zero1 by Zerodha quietly stopped funding creators | ft. Prateek Singh\n\n- **Podcast:** The Creator Room\n- **Published:** 2026-08-26T13:38:54+00:00\n- **Duration:** 65:58.622\n- **Language:** en\n- **Hosts:** Bijay Gautam\n- **Guests:** Prateek Singh\n\n## Transcript\n\n**Bijay Gautam · 00:00.120–00:04.180**\n\nZero1 partnered with creators. You have said [foreign language]. What is your take on that?\n\n**Prateek Singh · 00…",
      "highlights": [
        "So\n\n...\n\nSo at that time also Nithin was the, uh, like investor into it?\n\n**Prateek Singh · 04:44.340–04:46.060**\n\nYeah. So Nithin has been investor since day zero.\n\n...\n\nIn fact, short story, uh, one line story, Nithin gave us some money, 1.7 crores back then, and said, \"Figure out what you want to…"
      ]
    }
  ]
}
```

## Notes

- Flat price per call for up to ten results; numResults above 10 is refused as invalid_input (free).
- highlights[] holds about 1,500 characters and text about 700 per episode, so ten episodes stay small enough for an agent to read in one go.
- Results can include a show's own page as well as its episodes.

## Siblings

- [`search_news`](https://parel.si/docs/tools/search_news.md) for articles on the same subject.
- [`search_semantic`](https://parel.si/docs/tools/search_semantic.md) to describe a kind of web page.
- [`search_deep`](https://parel.si/docs/tools/search_deep.md) for a hard question across the web.
