> For the complete documentation index, see [llms.txt](https://docs.podigee.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.podigee.com/documentation/start-here/ai-agents/manage-episodes/find-and-filter-episodes.md).

# Find and filter episodes

Find episodes by title, publication state, date range, sort order, and page.

Narrow the episode list before you inspect or change a back catalog.

## Before you start

* Find the target podcast and keep its numeric ID.
* Decide which title, state, or publication period defines the intended set.

## Find episodes

1. Ask your agent to list episodes for the podcast ID.
2. Add `query` to search episode titles.
3. Add `state` as `draft`, `scheduled`, or `published` when needed.
4. Add `published_from` and `published_to` as ISO 8601 timestamps for a date range.
5. Choose `sort` as `newest`, `oldest`, or `title`.
6. Review each episode ID, title, publication time, state indicators, and `has_media` value.
7. If `pagination.next_offset` is present, request the next page with that offset.

The default page contains 25 episodes. You can request up to 100 at once. The start of a date range must be before or equal to its end.

## Expected result

You have the exact episode IDs that match the intended podcast and filters.

## If no episodes match

Remove one filter at a time. Confirm the podcast ID, timestamp format, time zone offset, and title spelling. Do not switch to an unfiltered bulk change until you understand the empty result.

## Next step

[Inspect an episode](/documentation/start-here/ai-agents/manage-episodes/inspect-an-episode.md).


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.podigee.com/documentation/start-here/ai-agents/manage-episodes/find-and-filter-episodes.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.