> ## Documentation Index
> Fetch the complete documentation index at: https://docs.punchplay.tv/llms.txt
> Use this file to discover all available pages before exploring further.

# Get the public community overview



## OpenAPI

````yaml /openapi.yaml get /api/public/v1/community/overview
openapi: 3.1.0
info:
  title: PunchPlay Platform API
  version: 1.0.0-beta.5
  description: >-
    Beta contract for the Platform API and stable v1 contract for the read-only
    Public API. OAuth access tokens use explicit per-operation scopes.
servers:
  - url: https://punchplay.tv
    description: Production
  - url: http://localhost:3000
    description: Local development
security: []
tags:
  - name: Authentication
  - name: Profile
  - name: Titles
  - name: History
  - name: Ratings
  - name: Lists
  - name: Collection
  - name: Playback
  - name: Calendar
  - name: Community
  - name: Notifications
  - name: Trophies
  - name: Sync
  - name: Public Catalog
  - name: Public Users
  - name: Public API
paths:
  /api/public/v1/community/overview:
    get:
      tags:
        - Public API
      summary: Get the public community overview
      operationId: getPublicCommunityOverview
      responses:
        '200':
          $ref: '#/components/responses/CommunityOverviewSuccess'
        '429':
          $ref: '#/components/responses/PublicErrorResponse'
      security: []
components:
  responses:
    CommunityOverviewSuccess:
      description: Public community overview
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/CommunityOverview'
    PublicErrorResponse:
      description: Public API error
      headers:
        Retry-After:
          schema:
            type: integer
            minimum: 0
          description: Seconds until the client should retry a rate-limited request.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/PublicError'
  schemas:
    CommunityOverview:
      type: object
      additionalProperties: false
      required:
        - siteStats
        - trending
        - hotDiscussions
        - fastestRising
        - topTrophyHunters
        - topLists
        - topGenres
      properties:
        siteStats:
          type: object
          additionalProperties: false
          required:
            - monthMovies
            - monthEpisodes
            - monthHours
            - monthRatings
            - monthReviews
            - monthReactions
            - onlineCount
          properties:
            monthMovies:
              type: integer
            monthEpisodes:
              type: integer
            monthHours:
              type: integer
            monthRatings:
              type: integer
            monthReviews:
              type: integer
            monthReactions:
              type: integer
            onlineCount:
              type: integer
        trending:
          type: object
          additionalProperties: false
          required:
            - items
          properties:
            items:
              type: array
              items:
                $ref: '#/components/schemas/CommunityTitle'
        hotDiscussions:
          type: object
          additionalProperties: false
          required:
            - items
          properties:
            items:
              type: array
              items:
                type: object
                additionalProperties: false
                required:
                  - tmdbId
                  - titleType
                  - titleName
                  - commentCount
                  - posterUrl
                  - latestSeason
                  - latestEpisode
                properties:
                  tmdbId:
                    type: integer
                    minimum: 1
                  titleType:
                    type: string
                    enum:
                      - movie
                      - show
                  titleName:
                    type: string
                  commentCount:
                    type: integer
                    minimum: 0
                  posterUrl:
                    type: string
                  latestSeason:
                    type: integer
                    minimum: 0
                  latestEpisode:
                    type: integer
                    minimum: 0
        fastestRising:
          type: object
          additionalProperties: false
          required:
            - items
          properties:
            items:
              type: array
              items:
                type: object
                additionalProperties: false
                required:
                  - tmdbId
                  - titleType
                  - titleName
                  - posterUrl
                  - watchesLast24h
                properties:
                  tmdbId:
                    type: integer
                    minimum: 1
                  titleType:
                    type: string
                    enum:
                      - movie
                      - show
                  titleName:
                    type: string
                  posterUrl:
                    type: string
                  watchesLast24h:
                    type: integer
                    minimum: 0
        topTrophyHunters:
          type: object
          additionalProperties: false
          required:
            - items
          properties:
            items:
              type: array
              items:
                type: object
                additionalProperties: false
                required:
                  - userId
                  - username
                  - displayName
                  - avatarUrl
                  - avatarInitials
                  - colorClass
                  - trophiesThisMonth
                  - usernameStyle
                  - usernameColor
                  - profileBadge
                  - isDonor
                  - isSubscriber
                properties:
                  userId:
                    type: string
                  username:
                    type:
                      - string
                      - 'null'
                  displayName:
                    type: string
                  avatarUrl:
                    type:
                      - string
                      - 'null'
                  avatarInitials:
                    type: string
                  colorClass:
                    type: string
                  trophiesThisMonth:
                    type: integer
                    minimum: 0
                  usernameStyle:
                    type:
                      - string
                      - 'null'
                  usernameColor:
                    type:
                      - string
                      - 'null'
                  profileBadge:
                    type:
                      - string
                      - 'null'
                  isDonor:
                    type: boolean
                  isSubscriber:
                    type: boolean
        topLists:
          type: object
          additionalProperties: false
          required:
            - items
          properties:
            items:
              type: array
              items:
                type: object
                additionalProperties: false
                required:
                  - listId
                  - listName
                  - ownerDisplayName
                  - itemsAddedThisMonth
                  - totalItems
                properties:
                  listId:
                    type: integer
                    minimum: 1
                  listName:
                    type: string
                  ownerDisplayName:
                    type: string
                  itemsAddedThisMonth:
                    type: integer
                    minimum: 0
                  totalItems:
                    type: integer
                    minimum: 0
        topGenres:
          type: object
          additionalProperties: false
          required:
            - items
          properties:
            items:
              type: array
              items:
                type: object
                additionalProperties: false
                required:
                  - name
                  - count
                  - share
                properties:
                  name:
                    type: string
                  count:
                    type: integer
                    minimum: 0
                  share:
                    type: integer
                    minimum: 0
                    maximum: 100
    PublicError:
      type: object
      required:
        - message
      properties:
        message:
          type: string
    CommunityTitle:
      type: object
      additionalProperties: false
      required:
        - id
        - tmdbId
        - type
        - name
        - year
        - overview
        - posterUrl
        - backdropUrl
        - communityRating
      properties:
        id:
          type: string
        tmdbId:
          type: integer
          minimum: 1
        type:
          type: string
          enum:
            - movie
            - show
        name:
          type: string
        year:
          type: integer
        releaseDate:
          type: string
        overview:
          type: string
        posterUrl:
          type: string
        backdropUrl:
          type: string
        posterPath:
          type:
            - string
            - 'null'
        backdropPath:
          type:
            - string
            - 'null'
        popularity:
          type:
            - number
            - 'null'
        communityRating:
          type: number
        runtimeMinutes:
          type: integer
        genres:
          type: array
          items:
            type: string
        ageRating:
          type: string
        originalLanguage:
          type: string
        posterColor:
          type: string
        posterColorIsDark:
          type: boolean

````