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

# Fetch feed events

> Returns the authenticated Pro user’s feed with cursor pagination and optional channel and event-type filters.



## OpenAPI

````yaml https://monitoryt.com/openapi.yml post /api/public/feed
openapi: 3.1.0
info:
  title: Monitor YT Public API
  version: 1.0.0
  description: Programmatic access to Monitor YT feed and tracked-video data.
servers:
  - url: https://monitoryt.com
    description: Production
security: []
paths:
  /api/public/feed:
    post:
      tags:
        - Public API
      summary: Fetch feed events
      description: >-
        Returns the authenticated Pro user’s feed with cursor pagination and
        optional channel and event-type filters.
      operationId: fetchFeed
      requestBody:
        description: JSON request body
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                cursor:
                  type:
                    - string
                    - 'null'
                  minLength: 24
                  maxLength: 24
                limit:
                  type: integer
                  minimum: 1
                  maximum: 200
                types:
                  type: array
                  items:
                    type: string
                    enum:
                      - video_published
                      - title_changed
                      - thumbnail_changed
                      - title_ab_test
                      - title_ab_test_concluded
                      - thumbnail_ab_test
                      - thumbnail_ab_test_concluded
                      - subscriber_change
                      - channel_renamed
                      - channel_avatar_changed
                      - members_only_changed
                  maxItems: 100
                channelIds:
                  type: array
                  items:
                    type: string
                    minLength: 24
                    maxLength: 24
                  maxItems: 100
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                type: object
                properties:
                  events:
                    type: array
                    items:
                      oneOf:
                        - type: object
                          properties:
                            id:
                              type: string
                            createdAt:
                              type: integer
                            channel:
                              type: object
                              properties:
                                id:
                                  type: string
                                youtubeChannelId:
                                  type: string
                                title:
                                  type: string
                                thumbnailUrl:
                                  type:
                                    - string
                                    - 'null'
                                  format: uri
                              required:
                                - id
                                - youtubeChannelId
                                - title
                                - thumbnailUrl
                            type:
                              type: string
                              enum:
                                - video_published
                            video:
                              type: object
                              properties:
                                youtubeVideoId:
                                  type: string
                                currentTitle:
                                  type: string
                                currentThumbnailUrl:
                                  type: string
                                  format: uri
                                publishedAt:
                                  type: integer
                                isMembersOnly:
                                  type: boolean
                                viewCount:
                                  type:
                                    - integer
                                    - 'null'
                                  minimum: 0
                                likeCount:
                                  type:
                                    - integer
                                    - 'null'
                                  minimum: 0
                                commentCount:
                                  type:
                                    - integer
                                    - 'null'
                                  minimum: 0
                              required:
                                - youtubeVideoId
                                - currentTitle
                                - currentThumbnailUrl
                                - publishedAt
                                - isMembersOnly
                                - viewCount
                                - likeCount
                                - commentCount
                          required:
                            - id
                            - createdAt
                            - channel
                            - type
                            - video
                        - type: object
                          properties:
                            id:
                              type: string
                            createdAt:
                              type: integer
                            channel:
                              type: object
                              properties:
                                id:
                                  type: string
                                youtubeChannelId:
                                  type: string
                                title:
                                  type: string
                                thumbnailUrl:
                                  type:
                                    - string
                                    - 'null'
                                  format: uri
                              required:
                                - id
                                - youtubeChannelId
                                - title
                                - thumbnailUrl
                            type:
                              type: string
                              enum:
                                - title_changed
                            video:
                              type: object
                              properties:
                                youtubeVideoId:
                                  type: string
                                currentTitle:
                                  type: string
                                currentThumbnailUrl:
                                  type: string
                                  format: uri
                                publishedAt:
                                  type: integer
                              required:
                                - youtubeVideoId
                                - currentTitle
                                - currentThumbnailUrl
                                - publishedAt
                            oldTitle:
                              type: string
                            newTitle:
                              type: string
                          required:
                            - id
                            - createdAt
                            - channel
                            - type
                            - video
                            - oldTitle
                            - newTitle
                        - type: object
                          properties:
                            id:
                              type: string
                            createdAt:
                              type: integer
                            channel:
                              type: object
                              properties:
                                id:
                                  type: string
                                youtubeChannelId:
                                  type: string
                                title:
                                  type: string
                                thumbnailUrl:
                                  type:
                                    - string
                                    - 'null'
                                  format: uri
                              required:
                                - id
                                - youtubeChannelId
                                - title
                                - thumbnailUrl
                            type:
                              type: string
                              enum:
                                - thumbnail_changed
                            video:
                              type: object
                              properties:
                                youtubeVideoId:
                                  type: string
                                currentTitle:
                                  type: string
                                currentThumbnailUrl:
                                  type: string
                                  format: uri
                                publishedAt:
                                  type: integer
                              required:
                                - youtubeVideoId
                                - currentTitle
                                - currentThumbnailUrl
                                - publishedAt
                            oldThumbnailUrl:
                              type: string
                              format: uri
                            newThumbnailUrl:
                              type: string
                              format: uri
                          required:
                            - id
                            - createdAt
                            - channel
                            - type
                            - video
                            - oldThumbnailUrl
                            - newThumbnailUrl
                        - type: object
                          properties:
                            id:
                              type: string
                            createdAt:
                              type: integer
                            channel:
                              type: object
                              properties:
                                id:
                                  type: string
                                youtubeChannelId:
                                  type: string
                                title:
                                  type: string
                                thumbnailUrl:
                                  type:
                                    - string
                                    - 'null'
                                  format: uri
                              required:
                                - id
                                - youtubeChannelId
                                - title
                                - thumbnailUrl
                            type:
                              type: string
                              enum:
                                - title_ab_test
                            video:
                              type: object
                              properties:
                                youtubeVideoId:
                                  type: string
                                currentTitle:
                                  type: string
                                currentThumbnailUrl:
                                  type: string
                                  format: uri
                                publishedAt:
                                  type: integer
                              required:
                                - youtubeVideoId
                                - currentTitle
                                - currentThumbnailUrl
                                - publishedAt
                            titles:
                              type: array
                              items:
                                type: string
                          required:
                            - id
                            - createdAt
                            - channel
                            - type
                            - video
                            - titles
                        - type: object
                          properties:
                            id:
                              type: string
                            createdAt:
                              type: integer
                            channel:
                              type: object
                              properties:
                                id:
                                  type: string
                                youtubeChannelId:
                                  type: string
                                title:
                                  type: string
                                thumbnailUrl:
                                  type:
                                    - string
                                    - 'null'
                                  format: uri
                              required:
                                - id
                                - youtubeChannelId
                                - title
                                - thumbnailUrl
                            type:
                              type: string
                              enum:
                                - title_ab_test_concluded
                            video:
                              type: object
                              properties:
                                youtubeVideoId:
                                  type: string
                                currentTitle:
                                  type: string
                                currentThumbnailUrl:
                                  type: string
                                  format: uri
                                publishedAt:
                                  type: integer
                              required:
                                - youtubeVideoId
                                - currentTitle
                                - currentThumbnailUrl
                                - publishedAt
                            titles:
                              type: array
                              items:
                                type: string
                            finalTitle:
                              type: string
                          required:
                            - id
                            - createdAt
                            - channel
                            - type
                            - video
                            - titles
                            - finalTitle
                        - type: object
                          properties:
                            id:
                              type: string
                            createdAt:
                              type: integer
                            channel:
                              type: object
                              properties:
                                id:
                                  type: string
                                youtubeChannelId:
                                  type: string
                                title:
                                  type: string
                                thumbnailUrl:
                                  type:
                                    - string
                                    - 'null'
                                  format: uri
                              required:
                                - id
                                - youtubeChannelId
                                - title
                                - thumbnailUrl
                            type:
                              type: string
                              enum:
                                - thumbnail_ab_test
                            video:
                              type: object
                              properties:
                                youtubeVideoId:
                                  type: string
                                currentTitle:
                                  type: string
                                currentThumbnailUrl:
                                  type: string
                                  format: uri
                                publishedAt:
                                  type: integer
                              required:
                                - youtubeVideoId
                                - currentTitle
                                - currentThumbnailUrl
                                - publishedAt
                            thumbnailUrls:
                              type: array
                              items:
                                type: string
                                format: uri
                          required:
                            - id
                            - createdAt
                            - channel
                            - type
                            - video
                            - thumbnailUrls
                        - type: object
                          properties:
                            id:
                              type: string
                            createdAt:
                              type: integer
                            channel:
                              type: object
                              properties:
                                id:
                                  type: string
                                youtubeChannelId:
                                  type: string
                                title:
                                  type: string
                                thumbnailUrl:
                                  type:
                                    - string
                                    - 'null'
                                  format: uri
                              required:
                                - id
                                - youtubeChannelId
                                - title
                                - thumbnailUrl
                            type:
                              type: string
                              enum:
                                - thumbnail_ab_test_concluded
                            video:
                              type: object
                              properties:
                                youtubeVideoId:
                                  type: string
                                currentTitle:
                                  type: string
                                currentThumbnailUrl:
                                  type: string
                                  format: uri
                                publishedAt:
                                  type: integer
                              required:
                                - youtubeVideoId
                                - currentTitle
                                - currentThumbnailUrl
                                - publishedAt
                            thumbnailUrls:
                              type: array
                              items:
                                type: string
                                format: uri
                            finalThumbnailUrl:
                              type: string
                              format: uri
                          required:
                            - id
                            - createdAt
                            - channel
                            - type
                            - video
                            - thumbnailUrls
                            - finalThumbnailUrl
                        - type: object
                          properties:
                            id:
                              type: string
                            createdAt:
                              type: integer
                            channel:
                              type: object
                              properties:
                                id:
                                  type: string
                                youtubeChannelId:
                                  type: string
                                title:
                                  type: string
                                thumbnailUrl:
                                  type:
                                    - string
                                    - 'null'
                                  format: uri
                              required:
                                - id
                                - youtubeChannelId
                                - title
                                - thumbnailUrl
                            type:
                              type: string
                              enum:
                                - members_only_changed
                            video:
                              type: object
                              properties:
                                youtubeVideoId:
                                  type: string
                                currentTitle:
                                  type: string
                                currentThumbnailUrl:
                                  type: string
                                  format: uri
                                publishedAt:
                                  type: integer
                              required:
                                - youtubeVideoId
                                - currentTitle
                                - currentThumbnailUrl
                                - publishedAt
                            isMembersOnly:
                              type: boolean
                          required:
                            - id
                            - createdAt
                            - channel
                            - type
                            - video
                            - isMembersOnly
                        - type: object
                          properties:
                            id:
                              type: string
                            createdAt:
                              type: integer
                            channel:
                              type: object
                              properties:
                                id:
                                  type: string
                                youtubeChannelId:
                                  type: string
                                title:
                                  type: string
                                thumbnailUrl:
                                  type:
                                    - string
                                    - 'null'
                                  format: uri
                              required:
                                - id
                                - youtubeChannelId
                                - title
                                - thumbnailUrl
                            type:
                              type: string
                              enum:
                                - subscriber_change
                            oldSubscriberCount:
                              type:
                                - integer
                                - 'null'
                              minimum: 0
                            newSubscriberCount:
                              type: integer
                              minimum: 0
                          required:
                            - id
                            - createdAt
                            - channel
                            - type
                            - oldSubscriberCount
                            - newSubscriberCount
                        - type: object
                          properties:
                            id:
                              type: string
                            createdAt:
                              type: integer
                            channel:
                              type: object
                              properties:
                                id:
                                  type: string
                                youtubeChannelId:
                                  type: string
                                title:
                                  type: string
                                thumbnailUrl:
                                  type:
                                    - string
                                    - 'null'
                                  format: uri
                              required:
                                - id
                                - youtubeChannelId
                                - title
                                - thumbnailUrl
                            type:
                              type: string
                              enum:
                                - channel_renamed
                            oldChannelTitle:
                              type: string
                            newChannelTitle:
                              type: string
                          required:
                            - id
                            - createdAt
                            - channel
                            - type
                            - oldChannelTitle
                            - newChannelTitle
                        - type: object
                          properties:
                            id:
                              type: string
                            createdAt:
                              type: integer
                            channel:
                              type: object
                              properties:
                                id:
                                  type: string
                                youtubeChannelId:
                                  type: string
                                title:
                                  type: string
                                thumbnailUrl:
                                  type:
                                    - string
                                    - 'null'
                                  format: uri
                              required:
                                - id
                                - youtubeChannelId
                                - title
                                - thumbnailUrl
                            type:
                              type: string
                              enum:
                                - channel_avatar_changed
                            oldAvatarUrl:
                              type: string
                              format: uri
                            newAvatarUrl:
                              type: string
                              format: uri
                          required:
                            - id
                            - createdAt
                            - channel
                            - type
                            - oldAvatarUrl
                            - newAvatarUrl
                  nextCursor:
                    type:
                      - string
                      - 'null'
                required:
                  - events
                  - nextCursor
        '400':
          description: Invalid request body
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                  message:
                    type: string
                  details: {}
                required:
                  - error
                  - message
        '401':
          description: Missing or invalid API key
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                  message:
                    type: string
                  details: {}
                required:
                  - error
                  - message
        '403':
          description: A Pro plan is required
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                  message:
                    type: string
                  details: {}
                required:
                  - error
                  - message
        '429':
          description: Rate limit exceeded
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                  message:
                    type: string
                  details: {}
                required:
                  - error
                  - message
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                  message:
                    type: string
                  details: {}
                required:
                  - error
                  - message
      security:
        - bearerAuth: []
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: Monitor YT API key

````