Particle Pro

Admitted input schema

{
  "type": "object",
  "properties": {
    "company_id": {
      "type": "string",
      "minLength": 0,
      "maxLength": 4096,
      "description": "Company slug (e.g., 'nvidia'), domain (e.g., 'nvidia.com'), or ID. Resolves to the company's linked entity."
    },
    "cursor": {
      "type": "string",
      "minLength": 0,
      "maxLength": 4096,
      "description": "Opaque pagination cursor from previous response"
    },
    "entity_id": {
      "type": "string",
      "minLength": 0,
      "maxLength": 4096,
      "description": "Entity slug (e.g., 'elon-musk', 'openai') or ID. Returns episodes featuring this entity as a speaker or mentioned entity."
    },
    "fully_ingested": {
      "type": "boolean",
      "description": "Only episodes that have reached the terminal ingestion milestone (the highest stage exposed by the episode firehose)"
    },
    "has_transcript": {
      "type": "boolean",
      "description": "Only episodes with completed transcripts"
    },
    "language": {
      "type": "string",
      "minLength": 0,
      "maxLength": 4096,
      "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'."
    },
    "limit": {
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991,
      "description": "Results per page"
    },
    "max_duration": {
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991,
      "description": "Maximum episode duration in seconds"
    },
    "min_duration": {
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991,
      "description": "Minimum episode duration in seconds"
    },
    "person_id": {
      "type": "string",
      "minLength": 0,
      "maxLength": 4096,
      "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."
    },
    "podcast_id": {
      "type": "string",
      "minLength": 0,
      "maxLength": 4096,
      "description": "Podcast slug (e.g., 'all-in'), internal ID, or numeric iTunes ID"
    },
    "published_after": {
      "type": "string",
      "minLength": 0,
      "maxLength": 4096,
      "description": "Only episodes published after this ISO 8601 date or date-time (e.g. 2024-01-01 or 2024-01-01T00:00:00Z)"
    },
    "published_before": {
      "type": "string",
      "minLength": 0,
      "maxLength": 4096,
      "description": "Only episodes published before this ISO 8601 date or date-time (e.g. 2024-01-01 or 2024-01-01T00:00:00Z)"
    },
    "role": {
      "type": "string",
      "minLength": 0,
      "maxLength": 4096,
      "enum": [
        "guest",
        "host",
        "panelist",
        "correspondent",
        "speaker",
        "mention"
      ],
      "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."
    }
  },
  "required": [],
  "additionalProperties": false
}