---
title: "Find a podcast RSS feed by name"
method: GET
path: "/api/v1/podcasts/feeds"
---

# Find a podcast RSS feed by name

`GET /api/v1/podcasts/feeds`

## Request

- Base URL: `https://podcaststotext.com`
- URL: `https://podcaststotext.com/api/v1/podcasts/feeds`
- Auth: HTTP bearer

The entry point when you have a show's name and nothing else. Returns ranked candidates rather than one match: show names collide, so check `author` before choosing.

## Query parameters

- `q` string
- `url` string
- `limit` integer

## Response `200`

Matching podcasts

- object
  - `data` object[]
    - `title` string
    - `author` string, nullable
    - `rss_url` string
    - `artwork_url` string, nullable
    - `genre` string, nullable
    - `episode_count` integer, nullable
  - `next_actions` string[]

## Other responses

- `400`: Unsupported link
- `401`: Missing or invalid API key
- `404`: No podcast matched

---

[API](https://skmtc.dev/podcaststotext/apis/podcaststotext-api.md) · [All operations](https://skmtc.dev/podcaststotext/apis/podcaststotext-api/llms.txt) · [OpenAPI document](https://skmtc.dev/podcaststotext/apis/podcaststotext-api/revisions/ef711acf4bc3?raw)