# Particle Pro Podcast Entity Mentions Search

> Particle Pro Podcast Entity Mentions Search is a paid API for AI agents from api.particle.pro, paid per call via x402, $0.04/call, status unknown (last checked 2026-10-15).

Search podcast dialogue for every line where a specific person or company is mentioned, grouped by episode and ordered by recency or popularity.

## Facts

- Endpoint: GET https://api.particle.pro/v1/podcasts/mentions?utm_source=zero.xyz
- Price: $0.04/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/particle-pro-podcast-entity-mentions-search-640096bc
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_VFkDhRJCyU_3TpJama-6V

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 particle-pro-podcast-entity-mentions-search-640096bc
```

Example prompt: Can you search Particle Pro for every podcast episode that mentions Sam Altman, limit it to the last 30 days, sort by popularity, and return the first 25 episodes?

## When to prefer this

Choose this endpoint when you need granular dialogue-level evidence of when and how a specific person or company was discussed across podcasts — not just episode titles or show-level metadata. It is ideal for media monitoring, PR research, competitive intelligence, and tracking how public figures are discussed over time. It outperforms generic podcast search when you need exact quote windows grouped by episode and sortable by popularity or recency.

## Known failure modes

- Unknown entity_id returns empty results or 404
- Invalid cursor value returns 400 bad request
- favorites sort without authenticated user session returns 401
- limit outside 1-100 range returns 400 validation error
- Unsupported language code returns empty results or 400
- since/until dates in wrong format return 400
- Rate limiting or quota exhaustion returns 429

## How this service works

Search podcast dialogue for entity mentions. Returns every line of dialogue that mentions a person or company, grouped by episode and ordered by recency.

## Output

A paginated list of episodes grouped by publication date, each containing the specific dialogue windows (lines of dialogue) where the queried entity is mentioned, along with episode metadata such as show name, publication date, and an opaque cursor for fetching the next page.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "role": {
       "enum": [
        "guest",
        "host",
        "panelist",
        "correspondent",
        "mention"
       ],
       "type": "string",
       "description": "Constrain how the entity participates: guest, host, panelist, correspondent, or mention."
      },
      "sort": {
       "enum": [
        "recency",
        "popularity",
        "favorites"
       ],
       "type": "string",
       "description": "Result ordering. recency (the default) returns the most recently published episodes first. popularity orders by the parent podcast's global popularity percentile — the biggest shows first, recency breaking ties within a show, non-charting podcasts last. favorites keeps the recency ordering but lifts the calling user's favorited shows to the top of each publication day; it requires an authenticated user session (401 for an API key or anonymous token) and falls back to plain recency for a user with no favorited podcasts. Pass the same sort alongside a cursor when paginating."
      },
      "limit": {
       "type": "integer",
       "format": "int64",
       "description": "Episodes per page (1-100, default 25). Each episode's full set of mention windows is returned in a single page; episodes never split across pages."
      },
      "since": {
       "type": "string",
       "description": "Only episodes published after this date."
      },
      "until": {
       "type": "string",
       "description": "Only episodes published before this date."
      },
      "cursor": {
       "type": "string",
       "description": "Opaque cursor from a previous response."
      },
      "language": {
       "type": "string",
       "description": "Restrict to episodes of podcasts in this language (ISO 639-1 code, e.g. 'fr'). Matches the podcast's primary language subtag, so 'fr' covers 'fr-FR'."
      },
      "entity_id": {
       "type": "string",
       "description": "Entity slug (e.g., 'sam-altman') or ID. A person slug or ID resolves via the person's linked knowledge graph entity; a person with no linke
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/particle-pro-podcast-entity-mentions-search-640096bc/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.particle.pro](https://www.zero.xyz/host/api.particle.pro/llms.txt)