# Particle Pro Episode Lookup

> Particle Pro Episode Lookup is a paid API for AI agents from api.particle.pro, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-14).

Resolves one or more external episode identifiers (Apple Podcasts, YouTube, RSS GUID, PodcastIndex, Megaphone, Omny, Acast, Art19) to Particle Pro podcast episodes

## Facts

- Endpoint: GET https://api.particle.pro/v1/podcasts/episodes/lookup
- Price: $0.01/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-episode-lookup-64be5c10
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_GsNlvq8jNud3VaFH5PjDU

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-episode-lookup-64be5c10
```

Example prompt: Look up the podcast episode with Apple Podcasts episode ID 1000672345678 on Particle Pro and give me the matching episode details.

## When to prefer this

Use this endpoint when you have an external episode identifier from a major podcast platform or RSS feed and need to map it to a Particle Pro episode record — especially for cross-platform episode resolution, batch lookups of up to 100 episodes at once, or when integrating with Apple Podcasts, YouTube, or RSS-based tooling. Prefer this over generic podcast search when you have a precise identifier rather than a keyword query.

## Known failure modes

- Unrecognized platform slug returns an error — only supported platforms (apple, itunes, youtube, guid, podcastindex, megaphone, omny, acast, art19) are accepted
- Identifier not found in Particle's index returns an empty or null match for that entry
- Exceeding 100 identifiers per call results in an error
- Using 'rss' as the platform is explicitly not accepted since feed URLs identify shows, not episodes
- Malformed YouTube URL may fail to parse the video ID
- Payment failure (x402 protocol) if USDC balance is insufficient

## How this service works

Look up episodes by external identifier. Resolves one or more external episode identifiers to Particle episodes.

## Output

A list of Particle episode records corresponding to the supplied external identifiers, echoing back the original identifiers as supplied alongside any matched Particle episode data.

## 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",
     "required": [
      "identifier",
      "platform"
     ],
     "properties": {
      "platform": {
       "type": "string",
       "description": "What kind of identifier you are resolving. 'apple' (alias 'itunes') resolves Apple Podcasts episode IDs — the ?i= value in an Apple Podcasts URL. 'youtube' resolves YouTube video IDs against the videos discovered for each episode. 'guid' resolves the episode's RSS guid, the identifier carried in the publisher's own feed and the one most podcast tooling keys on. 'podcastindex' resolves a PodcastIndex episode ID. 'megaphone', 'omny', 'acast' and 'art19' resolve a hosting platform's own episode ID, read from the episode's audio URL. Platform slugs must be ones reported on external-links responses; 'rss' is not accepted here because a feed URL identifies a show, not an episode."
      },
      "identifier": {
       "type": "array",
       "items": {
        "type": "string"
       },
       "description": "One or more episode identifiers to resolve. Pass a comma-separated list to look up many at once (max 100 per call). A full platform URL is accepted in place of a bare identifier and the ID is parsed out of it: for apple/itunes an Apple Podcasts episode URL (the ?i= value); for youtube a watch?v=, youtu.be/, /live/, /shorts/ or /embed/ URL. guid, podcastindex and hosting-platform values are used as given — a guid is whatever string the feed carries, which is often itself a URL, so it is never parsed. The identifier is echoed back exactly as supplied, not normalized."
      }
     }
    }
   },
   "additionalProperties": false
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/particle-pro-episode-lookup-64be5c10/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)