List episodes

[
  {
    "scheme": "exact",
    "network": "eip155:8453",
    "payTo": "0x59f3a6dcb6f482c53872dd8f8f9e1f9161a1c5f7",
    "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "amount": "10000",
    "maxTimeoutSeconds": 300
  }
]

{
  "bazaar": {
    "info": {
      "input": {
        "method": "GET",
        "queryParams": {
          "language": "fr"
        },
        "type": "http"
      }
    },
    "schema": {
      "$schema": "https://json-schema.org/draft/2020-12/schema",
      "properties": {
        "input": {
          "additionalProperties": false,
          "properties": {
            "method": {
              "enum": [
                "GET"
              ],
              "type": "string"
            },
            "queryParams": {
              "properties": {
                "company_id": {
                  "description": "Company slug (e.g., 'nvidia'), domain (e.g., 'nvidia.com'), or ID. Resolves to the company's linked entity.",
                  "type": "string"
                },
                "cursor": {
                  "description": "Opaque pagination cursor from previous response",
                  "type": "string"
                },
                "entity_id": {
                  "description": "Entity slug (e.g., 'elon-musk', 'openai') or ID. Returns episodes featuring this entity as a speaker or mentioned entity.",
                  "type": "string"
                },
                "fully_ingested": {
                  "description": "Only episodes that have reached the terminal ingestion milestone (the highest stage exposed by the episode firehose)",
                  "type": "boolean"
                },
                "has_transcript": {
                  "description": "Only episodes with completed transcripts",
                  "type": "boolean"
                },
                "language": {
                  "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'.",
                  "type": "string"
                },
                "limit": {
                  "description": "Results per page",
                  "format": "int64",
                  "type": "integer"
                },
                "max_duration": {
                  "description": "Maximum episode duration in seconds",
                  "format": "int64",
                  "type": "integer"
                },
                "min_duration": {
                  "description": "Minimum episode duration in seconds",
                  "format": "int64",
                  "type": "integer"
                },
                "person_id": {
                  "description": "Person slug (e.g., 'dick-costolo'), knowledge-graph entity slug for the same person, or ID. Returns episodes featuring this person as a speaker — works even when the speaker has no knowledge-graph entity linked. When the value itself matches a knowledge-graph entity slug (corroborated to the same person), the default and 'mention' roles also include episodes that merely mention the person, matching entity_id semantics; pass a speaker role (guest, host, panelist, correspondent) for speaker-only results.",
                  "type": "string"
                },
                "podcast_id": {
                  "description": "Podcast slug (e.g., 'all-in'), internal ID, or numeric iTunes ID",
                  "type": "string"
                },
                "published_after": {
                  "description": "Only episodes published after this ISO 8601 date or date-time (e.g. 2024-01-01 or 2024-01-01T00:00:00Z)",
                  "type": "string"
                },
                "published_before": {
                  "description": "Only episodes published before this ISO 8601 date or date-time (e.g. 2024-01-01 or 2024-01-01T00:00:00Z)",
                  "type": "string"
                },
                "role": {
                  "description": "Entity role filter. Constrains which episodes match the entity_id, person_id, or company_id. 'speaker' matches any speaking role (host, co-host, guest, panelist, correspondent) without including mention-only episodes.",
                  "enum": [
                    "guest",
                    "host",
                    "panelist",
                    "correspondent",
                    "speaker",
                    "mention"
                  ],
                  "type": "string"
                }
              },
              "type": "object"
            },
            "type": {
              "const": "http",
              "type": "string"
            }
          },
          "required": [
            "type",
            "method"
          ],
          "type": "object"
        }
      },
      "required": [
        "input"
      ],
      "type": "object"
    }
  }
}

curl "https://api.particle.pro/v1/podcasts/episodes"
# -> 402 Payment Required, accepts[] lists how to pay
# retry with a PAYMENT-SIGNATURE (or PAYMENT header) once paid

const res = await fetch("https://api.particle.pro/v1/podcasts/episodes");
if (res.status === 402) {
  const { accepts } = await res.json();
  // pay one of accepts[] via an x402 client, then retry with the payment header
}

import httpx
res = httpx.get("https://api.particle.pro/v1/podcasts/episodes")
if res.status_code == 402:
    accepts = res.json()["accepts"]
    # pay one of accepts[] via an x402 client, then retry with the payment header