List episodes

List episodes. Returns a paginated list of podcast episodes across all podcasts.

Paid test badge: not yet. The checks above are free: we call the tool without paying and read the payment request it sends back. The Verified badge needs paid calls whose answers match the promised output, and nobody can buy a badge.

Endpoint

GET https://api.particle.pro/v1/podcasts/episodes

Our checks, last 30 days

Example input (from the provider)

{
  "method": "GET",
  "queryParams": {
    "language": "fr"
  },
  "type": "http"
}

Promised output schema (from the provider)

{
  "$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 \u2014 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"
}

This page as JSON