> ## 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 podcast catalog statistics

> Returns live, catalog-wide statistics: how many podcasts the catalog covers, broken out by classification, and how many episodes were added within recent trailing windows. The figures update continuously as new podcasts and episodes are ingested, so they can drive real-time counters. This endpoint is free and requires no API key.



## OpenAPI

````yaml /openapi.json get /v1/podcasts/stats
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/stats:
    get:
      tags:
        - Podcasts
        - tier:free
      summary: Get podcast catalog statistics
      description: >-
        Returns live, catalog-wide statistics: how many podcasts the catalog
        covers, broken out by classification, and how many episodes were added
        within recent trailing windows. The figures update continuously as new
        podcasts and episodes are ingested, so they can drive real-time
        counters. This endpoint is free and requires no API key.
      operationId: get-podcast-stats
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PodcastStats'
          description: OK
        default:
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/PlatformError'
          description: Error
      security: []
      x-codeSamples:
        - label: cURL
          lang: curl
          source: curl "https://api.particle.pro/v1/podcasts/stats"
components:
  schemas:
    PodcastStats:
      additionalProperties: false
      properties:
        episodes:
          $ref: '#/components/schemas/EpisodeStats'
          description: Episode activity across the catalog.
        podcasts:
          $ref: '#/components/schemas/PodcastTotals'
          description: Catalog-wide podcast counts.
      required:
        - podcasts
        - episodes
      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
    EpisodeStats:
      additionalProperties: false
      properties:
        added:
          description: Episodes added to the catalog within each trailing window.
          items:
            $ref: '#/components/schemas/WindowCount'
          type:
            - array
            - 'null'
      required:
        - added
      type: object
    PodcastTotals:
      additionalProperties: false
      properties:
        totals:
          description: >-
            Podcast counts by classification. Sum the entries for the total
            catalog size.
          items:
            $ref: '#/components/schemas/ClassificationCount'
          type:
            - array
            - 'null'
      required:
        - totals
      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
    WindowCount:
      additionalProperties: false
      properties:
        count:
          description: Number of items within the window.
          format: int64
          type: integer
        window:
          description: Trailing time window the count covers.
          enum:
            - 24h
            - 7d
          type: string
      required:
        - window
        - count
      type: object
    ClassificationCount:
      additionalProperties: false
      properties:
        classification:
          description: >-
            Podcast classification the count covers. 'transcribed' podcasts have
            their episodes transcribed and analyzed.
          enum:
            - transcribed
          type: string
        count:
          description: Number of podcasts with this classification.
          format: int64
          type: integer
      required:
        - classification
        - count
      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

````