Skip to main content
List the matches an alert has caught, newest first — the payoff of an alert. Read-only. Each match names the watched entity and the podcast episode it was detected on, with the mention count and (for PODCAST_SPEAKER alerts) the speaker roles. Backfilled matches — from the one-time past-week sweep at creation — are flagged and never triggered an email. The match results carry episode and podcast slugs that are edges into the podcast tools: pass an episode slug to particle_podcast_get_episode for the full episode overview, or a podcast slug to particle_podcast_resolve. Use view=detailed to include the transcript excerpt windows around each mention, and after/before to scope to a date range. Results are cursor-paginated.

​
Inputs

FieldTypeRequiredDefaultDescription
alert_idstringyes—Alert id whose matches to list.
viewenumnosummaryDetail level. summary returns each match’s entity, episode, and counts; detailed also includes the transcript excerpt windows around each mention.
afterstring (ISO date)no—Only matches detected on or after this date (e.g. 2026-05-01).
beforestring (ISO date)no—Only matches detected on or before this date.
limitinteger (1–100)no25Matches per page.
cursorstringno—Opaque pagination cursor from a previous response’s cursor field.

​
Output

A markdown ## Matches (N) heading followed by one bullet per match: Episode (Podcast) — N mentions (or — as <role> for speaker matches), flagged (backfilled) where applicable, with nested **Episode:** (the episode slug edge) and **Summary:** rows. With view=detailed, each match also lists the transcript lines from the excerpt windows as indented Speaker: text bullets. When more results remain, a trailing paragraph names the cursor for the next page. When there are no matches in the requested window, the output is a single line saying so. Sample (alert_id="dKxN6Ry2mL9pJ5qW"): 
## Matches (2)

- The AI Daily (Acme Network) — 3 mentions
  - **Episode:** the-ai-daily-2026-06-15
  - **Summary:** The hosts discuss OpenAI's latest model release and Sam Altman's keynote.
- Tech Roundup — 1 mention (backfilled)
  - **Episode:** tech-roundup-ep-204
Passing output_format: "json" returns matches, has_more, and cursor as compact JSON.

​
Example

Agent calls: particle_alert_list_matches {
  "alert_id": "dKxN6Ry2mL9pJ5qW",
  "view": "detailed",
  "after": "2026-06-01"
}
            → reads a match's "- **Episode:**" row → "the-ai-daily-2026-06-15"

Agent calls: particle_podcast_get_episode { "episode_slug": "the-ai-daily-2026-06-15" }