# Particle Pro – List Guest Podcast Appearances

> Particle Pro – List Guest Podcast Appearances is a paid API for AI agents from api.particle.pro, paid per call via x402, $0.03/call, status unknown (last checked 2026-09-14).

Returns a chronological, most-recent-first list of podcast episodes a specific guest has appeared on, with optional filtering by topic, podcast, date range, speaking time, and brand-safety tier.

## Facts

- Endpoint: GET https://api.particle.pro/v1/podcasts/guests/:id/appearances
- Price: $0.03/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/particle-pro-list-guest-podcast-appearances-ebc7557e
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_oisvBvgFwJIXX1HvCSSLa

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-list-guest-podcast-appearances-ebc7557e
```

Example prompt: Pull up all the podcast episodes that Lex Fridman has appeared on in the last year — use his person slug 'lex-fridman', limit to 20 results, and only include appearances on SAFE-rated podcasts.

## When to prefer this

Use this endpoint when you need structured, filterable episode-level appearance data for a specific podcast guest — especially when you need brand-safety filtering, topic scoping, or minimum speaking time thresholds. Prefer this over general podcast search when you already know the guest's identity and want their chronological appearance history across all podcasts in the Particle Pro index.

## Known failure modes

- Unknown guest ID returns 404 not found
- Invalid suitability_tier_max enum value returns 400 bad request
- Malformed ISO 8601 date strings for published_after/published_before return 400
- No appearances matching filters returns empty results list
- Expired or invalid pagination cursor returns 400 or empty results
- Payment failure (x402) if USDC balance is insufficient

## How this service works

List appearances for a podcast guest. Returns the chronological list of episodes a guest has appeared on, most recent first.

## Output

A paginated list of podcast episode appearance records for the specified guest, ordered most-recent-first. Each record includes episode and podcast identifiers, publication date, speaking time in seconds, and the podcast's brand-safety suitability tier. A pagination cursor is returned when more results are available.

## 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"
    },
    "pathParams": {
     "type": "object",
     "required": [
      "id"
     ],
     "properties": {
      "id": {
       "type": "string",
       "description": "Person identifier — person slug (recommended), knowledge-graph entity slug, or encoded UUID"
      }
     }
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "limit": {
       "type": "integer",
       "format": "int64",
       "description": "Results per page"
      },
      "cursor": {
       "type": "string",
       "description": "Opaque pagination cursor from previous response"
      },
      "topic_id": {
       "type": "string",
       "description": "Restrict to appearances on episodes classified under this topic"
      },
      "podcast_id": {
       "type": "string",
       "description": "Restrict to appearances on a single podcast (slug or ID)"
      },
      "published_after": {
       "type": "string",
       "description": "Only appearances published after this ISO 8601 date"
      },
      "published_before": {
       "type": "string",
       "description": "Only appearances published before this ISO 8601 date"
      },
      "min_speaking_seconds": {
       "type": "integer",
       "format": "int64",
       "description": "Restrict to appearances with identified speaking time above this threshold"
      },
      "suitability_tier_max": {
       "enum": [
        "SAFE",
        "LIMITED",
        "SENSITIVE",
        "UNSAFE"
       ],
       "type": "string",
       "description": "Restrict to appearances on podcasts at or below this IAB Tech Lab brand-safety tier"
      }
     }
    }
   },
   "additionalProperties": false
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/particle-pro-list-guest-podcast-appearances-ebc7557e/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)