> ## Documentation Index > Fetch the complete documentation index at: https://docs.particle.pro/llms.txt > Use this file to discover all available pages before exploring further. # Get a podcast's format profile > Returns the full format breakdown for a podcast: how often episodes feature guests, detected production formats (interview, panel, call_in, solo_narrated), advertiser and video presence, episode length distribution, publishing cadence, the publish-day histogram, and the sample sizes behind each attribute. The compact form of this data is embedded as the `format` field on podcast responses; use this endpoint for the exact rates and distributions. Returns 404 when the podcast is not found or its format profile has not been computed yet. ## OpenAPI ````yaml /openapi.json get /v1/podcasts/{id}/format openapi: 3.1.0 info: description: Public API for Particle — news intelligence, financial data, and analysis. title: Particle API version: 0.1.0 servers: - url: https://api.particle.pro security: - ApiKeyHeader: [] - BearerAuth: [] paths: /v1/podcasts/{id}/format: get: tags: - Podcasts - tier:standard summary: Get a podcast's format profile description: >- Returns the full format breakdown for a podcast: how often episodes feature guests, detected production formats (interview, panel, call_in, solo_narrated), advertiser and video presence, episode length distribution, publishing cadence, the publish-day histogram, and the sample sizes behind each attribute. The compact form of this data is embedded as the `format` field on podcast responses; use this endpoint for the exact rates and distributions. Returns 404 when the podcast is not found or its format profile has not been computed yet. operationId: get-podcast-format parameters: - description: Podcast slug (e.g., 'all-in'), internal ID, or numeric iTunes ID in: path name: id required: true schema: description: Podcast slug (e.g., 'all-in'), internal ID, or numeric iTunes ID type: string responses: '200': content: application/json: schema: $ref: '#/components/schemas/PodcastFormatProfile' description: OK default: content: application/problem+json: schema: $ref: '#/components/schemas/PlatformError' description: Error x-codeSamples: - label: cURL lang: curl source: |- curl -H "X-API-Key: $PARTICLE_API_KEY" \ "https://api.particle.pro/v1/podcasts/{id}/format" components: schemas: PodcastFormatProfile: additionalProperties: false properties: ad_episode_rate: description: Share of analyzed episodes carrying advertiser reads, in [0,1] format: double type: number analyzed_episodes: description: >- Number of episodes with speaker analysis — the sample behind guest_frequency, signals, has_ads, and the rates below format: int64 type: integer avg_episode_minutes: description: >- Average episode length in minutes. Omitted when no episode durations are known. format: int64 type: integer call_in_episode_rate: description: Share of analyzed episodes with listener callers, in [0,1] format: double type: number computed_at: description: When the profile was last recomputed format: date-time type: string episode_count: description: Total episodes tracked for this podcast format: int64 type: integer episode_minutes_median: description: Median episode length in minutes format: int64 type: integer episode_minutes_p25: description: 25th percentile episode length in minutes format: int64 type: integer episode_minutes_p75: description: 75th percentile episode length in minutes format: int64 type: integer episodes_per_week: description: >- Publishing cadence over the trailing 90 days, in episodes per week (e.g. 5.0 for a weekday daily, 0.5 for a fortnightly show). Omitted until the show has been tracked long enough to measure reliably. format: double type: number first_episode_published_at: description: Publish date of the earliest tracked episode format: date-time type: string guest_episode_rate: description: Share of analyzed episodes featuring at least one guest, in [0,1] format: double type: number guest_frequency: description: >- How often episodes feature a guest: never, rare, occasional, regular, or always. Derived from the share of analyzed episodes with at least one guest speaker. Omitted when too few episodes have been analyzed to judge. Filter the catalog with the guest_frequency query parameter on GET /v1/podcasts. type: string has_ads: description: >- Whether episodes carry advertiser reads. Omitted when too few episodes have been analyzed to judge. The full advertising profile (sponsors, read types, ad load) is served by GET /v1/podcasts/{id}/advertising. type: boolean has_video: description: >- Whether any episode has a discovered video version (e.g. a YouTube release). type: boolean latest_episode_published_at: description: Publish date of the most recent tracked episode format: date-time type: string panel_episode_rate: description: Share of analyzed episodes with panelists, in [0,1] format: double type: number publish_days: $ref: '#/components/schemas/PodcastFormatPublishDays' description: Histogram of episodes by publish day of week publishing_status: description: >- Whether the show is still releasing episodes: active (published within the last 90 days) or dormant. Omitted when no publish dates are known. type: string signals: description: >- Production formats detected from the show's speaker-role mix: interview, panel, call_in, and/or solo_narrated. A show can carry several (a panel show with call-in segments). Omitted when too few episodes have been analyzed to judge. items: type: string type: - array - 'null' required: - analyzed_episodes - episode_count - guest_episode_rate - ad_episode_rate - call_in_episode_rate - panel_episode_rate - publish_days - computed_at - has_video type: object PlatformError: additionalProperties: false properties: detail: description: >- A human-readable explanation specific to this occurrence of the problem. examples: - Property foo is required but is missing. type: string error_code: type: string errors: description: Optional list of individual error details items: $ref: '#/components/schemas/ErrorDetail' type: - array - 'null' instance: description: >- A URI reference that identifies the specific occurrence of the problem. examples: - https://example.com/error-log/abc123 format: uri type: string resolve: $ref: '#/components/schemas/ErrorResolve' status: description: HTTP status code examples: - 400 format: int64 type: integer title: description: >- A short, human-readable summary of the problem type. This value should not change between occurrences of the error. examples: - Bad Request type: string type: default: about:blank description: A URI reference to human-readable documentation for the error. examples: - https://example.com/errors/example format: uri type: string type: object PodcastFormatPublishDays: additionalProperties: false properties: friday: description: Episodes published on a Friday format: int64 type: integer monday: description: Episodes published on a Monday format: int64 type: integer saturday: description: Episodes published on a Saturday format: int64 type: integer sunday: description: Episodes published on a Sunday format: int64 type: integer thursday: description: Episodes published on a Thursday format: int64 type: integer tuesday: description: Episodes published on a Tuesday format: int64 type: integer wednesday: description: Episodes published on a Wednesday format: int64 type: integer required: - monday - tuesday - wednesday - thursday - friday - saturday - sunday type: object ErrorDetail: additionalProperties: false properties: location: description: >- Where the error occurred, e.g. 'body.items[3].tags' or 'path.thing-id' type: string message: description: Error message text type: string value: description: The value at the given location type: object ErrorResolve: additionalProperties: false properties: action: type: string endpoint: type: string message: type: string method: type: string url: type: string required: - message type: object securitySchemes: ApiKeyHeader: description: Pass your API key in the X-API-Key header (recommended). in: header name: X-API-Key type: apiKey BearerAuth: description: Pass your API key as a Bearer token in the Authorization header. scheme: bearer type: http ````