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

# List Reddit watch events



## OpenAPI

````yaml /openapi.json get /v1/reddit/watches/{id}/events
openapi: 3.1.0
info:
  title: Nephia API
  description: >-
    B2B API for structured data from live Sources (Vinted, X, Reddit).
    Authenticate with an API key on your Account. Pull endpoints charge credits
    per request. Watches poll on an interval and deliver webhook events. Product
    request quota is per Account (all API keys share one bucket), by Plan: Free
    60/min, Starter 350/min, Growth 700/min, Pro 1,200/min. Credit packs do not
    raise the quota.
  version: 1.0.0
servers:
  - url: https://api.nephia.cc
    description: Production
  - url: http://localhost:3000
    description: Local
security:
  - ApiKeyAuth: []
tags:
  - name: Account
    description: Account balance
  - name: Vinted — Search
    description: Vinted catalog search
  - name: Vinted — Items
    description: Vinted listing detail
  - name: Vinted — Users
    description: Vinted sellers and wardrobes
  - name: Vinted — Reference
    description: Vinted filter metadata
  - name: Vinted — Watches
    description: Vinted watches, events, and activity
  - name: X — Tweets
    description: Tweet lookup, replies, thread, quotes, and engagers
  - name: X — Users
    description: X profiles, timelines, and social graphs
  - name: X — Search
    description: Tweet search
  - name: X — Lists
    description: X list timelines
  - name: X — Trends
    description: Trend places and snapshots
  - name: X — Watches
    description: X watches, events, and activity
  - name: Reddit — Search
    description: Reddit post, subreddit, and user search
  - name: Reddit — Posts
    description: Reddit posts, comments, duplicates, and trending
  - name: Reddit — Subreddits
    description: Subreddit profiles, listings, and rules
  - name: Reddit — Users
    description: Reddit user profiles and activity
  - name: Reddit — Watches
    description: Reddit watches, events, and activity
paths:
  /v1/reddit/watches/{id}/events:
    get:
      tags:
        - Reddit — Watches
      summary: List Reddit watch events
      operationId: getV1RedditWatchesByIdEvents
      parameters:
        - in: path
          name: id
          schema:
            type: string
          required: true
        - in: query
          name: since
          schema:
            type: string
        - in: query
          name: limit
          schema:
            type: integer
            minimum: 1
            maximum: 500
      responses:
        '200':
          description: Watch events
          content:
            application/json:
              schema:
                type: object
                properties:
                  events:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                        watchId:
                          type: string
                        type:
                          type: string
                          enum:
                            - listing.created
                            - listing.delisted
                            - listing.price_changed
                            - tweet.created
                            - post.created
                        listing:
                          type:
                            - object
                            - 'null'
                          properties:
                            id:
                              type: string
                            source:
                              type: string
                              const: vinted
                            market:
                              type: string
                            title:
                              type: string
                            price:
                              type: number
                            currency:
                              type: string
                            brand:
                              type:
                                - string
                                - 'null'
                            size:
                              type:
                                - string
                                - 'null'
                            status:
                              type:
                                - string
                                - 'null'
                            color1:
                              type:
                                - string
                                - 'null'
                            color2:
                              type:
                                - string
                                - 'null'
                            description:
                              type:
                                - string
                                - 'null'
                            photos:
                              type: array
                              items:
                                type: object
                                properties:
                                  url:
                                    type: string
                                  width:
                                    type:
                                      - number
                                      - 'null'
                                  height:
                                    type:
                                      - number
                                      - 'null'
                                required:
                                  - url
                                  - width
                                  - height
                            url:
                              type: string
                            createdAt:
                              type:
                                - string
                                - 'null'
                            updatedAt:
                              type:
                                - string
                                - 'null'
                            isReserved:
                              type: boolean
                            favouriteCount:
                              type:
                                - number
                                - 'null'
                            viewCount:
                              type:
                                - number
                                - 'null'
                            seller:
                              type:
                                - object
                                - 'null'
                              properties:
                                id:
                                  type: string
                                login:
                                  type: string
                                feedbackScore:
                                  type:
                                    - number
                                    - 'null'
                                feedbackCount:
                                  type:
                                    - number
                                    - 'null'
                                photoUrl:
                                  type:
                                    - string
                                    - 'null'
                                business:
                                  type:
                                    - boolean
                                    - 'null'
                                countryCode:
                                  type:
                                    - string
                                    - 'null'
                                city:
                                  type:
                                    - string
                                    - 'null'
                                country:
                                  type:
                                    - string
                                    - 'null'
                                positiveFeedbackCount:
                                  type:
                                    - number
                                    - 'null'
                                neutralFeedbackCount:
                                  type:
                                    - number
                                    - 'null'
                                negativeFeedbackCount:
                                  type:
                                    - number
                                    - 'null'
                                itemCount:
                                  type:
                                    - number
                                    - 'null'
                                totalItemsCount:
                                  type:
                                    - number
                                    - 'null'
                                followersCount:
                                  type:
                                    - number
                                    - 'null'
                                followingCount:
                                  type:
                                    - number
                                    - 'null'
                                isOnline:
                                  type:
                                    - boolean
                                    - 'null'
                                isOnHoliday:
                                  type:
                                    - boolean
                                    - 'null'
                                lastLoggedOnAt:
                                  type:
                                    - string
                                    - 'null'
                                profileUrl:
                                  type:
                                    - string
                                    - 'null'
                                locale:
                                  type:
                                    - string
                                    - 'null'
                              required:
                                - id
                                - login
                                - feedbackScore
                                - feedbackCount
                                - photoUrl
                                - business
                                - countryCode
                                - city
                                - country
                                - positiveFeedbackCount
                                - neutralFeedbackCount
                                - negativeFeedbackCount
                                - itemCount
                                - totalItemsCount
                                - followersCount
                                - followingCount
                                - isOnline
                                - isOnHoliday
                                - lastLoggedOnAt
                                - profileUrl
                                - locale
                            sourceMetadata:
                              type: object
                              additionalProperties: {}
                          required:
                            - id
                            - source
                            - market
                            - title
                            - price
                            - currency
                            - brand
                            - size
                            - status
                            - color1
                            - color2
                            - description
                            - photos
                            - url
                            - createdAt
                            - updatedAt
                            - isReserved
                            - favouriteCount
                            - viewCount
                            - seller
                            - sourceMetadata
                        tweet:
                          oneOf:
                            - $ref: '#/components/schemas/XTweet'
                            - type: 'null'
                        post:
                          type:
                            - object
                            - 'null'
                          properties:
                            id:
                              type: string
                            fullname:
                              type: string
                            title:
                              type: string
                            selftext:
                              type: string
                            selftextHtml:
                              type:
                                - string
                                - 'null'
                            url:
                              type: string
                            permalink:
                              type: string
                            domain:
                              type: string
                            author:
                              type: object
                              properties:
                                id:
                                  type:
                                    - string
                                    - 'null'
                                username:
                                  type: string
                                fullname:
                                  type:
                                    - string
                                    - 'null'
                              required:
                                - id
                                - username
                            authorFlairText:
                              type:
                                - string
                                - 'null'
                            subreddit:
                              type: string
                            subredditPrefixed:
                              type: string
                            subredditId:
                              type:
                                - string
                                - 'null'
                            subredditSubscribers:
                              type:
                                - number
                                - 'null'
                            score:
                              type: number
                            ups:
                              type: number
                            upvoteRatio:
                              type:
                                - number
                                - 'null'
                            numComments:
                              type: number
                            numCrossposts:
                              type:
                                - number
                                - 'null'
                            gilded:
                              type:
                                - number
                                - 'null'
                            totalAwards:
                              type:
                                - number
                                - 'null'
                            awards:
                              type: array
                              items:
                                type: object
                                properties:
                                  id:
                                    type: string
                                  name:
                                    type: string
                                  count:
                                    type: number
                                  iconUrl:
                                    type:
                                      - string
                                      - 'null'
                                required:
                                  - id
                                  - name
                                  - count
                                  - iconUrl
                            createdAt:
                              type: string
                            editedAt:
                              type:
                                - string
                                - 'null'
                            isNsfw:
                              type: boolean
                            isSelf:
                              type: boolean
                            isSpoiler:
                              type: boolean
                            isLocked:
                              type: boolean
                            isStickied:
                              type: boolean
                            isArchived:
                              type: boolean
                            isOriginalContent:
                              type: boolean
                            isVideo:
                              type: boolean
                            isGallery:
                              type: boolean
                            distinguished:
                              type:
                                - string
                                - 'null'
                            removedByCategory:
                              type:
                                - string
                                - 'null'
                            linkFlairText:
                              type:
                                - string
                                - 'null'
                            linkFlairBackgroundColor:
                              type:
                                - string
                                - 'null'
                            linkFlairTextColor:
                              type:
                                - string
                                - 'null'
                            linkFlairTemplateId:
                              type:
                                - string
                                - 'null'
                            thumbnail:
                              type:
                                - string
                                - 'null'
                            previewImages:
                              type: array
                              items:
                                type: object
                                properties:
                                  url:
                                    type: string
                                  width:
                                    type: number
                                  height:
                                    type: number
                                required:
                                  - url
                                  - width
                                  - height
                            media:
                              type: 'null'
                            galleryData:
                              type: 'null'
                          required:
                            - id
                            - fullname
                            - title
                            - selftext
                            - selftextHtml
                            - url
                            - permalink
                            - domain
                            - author
                            - authorFlairText
                            - subreddit
                            - subredditPrefixed
                            - subredditId
                            - subredditSubscribers
                            - score
                            - ups
                            - upvoteRatio
                            - numComments
                            - numCrossposts
                            - gilded
                            - totalAwards
                            - awards
                            - createdAt
                            - editedAt
                            - isNsfw
                            - isSelf
                            - isSpoiler
                            - isLocked
                            - isStickied
                            - isArchived
                            - isOriginalContent
                            - isVideo
                            - isGallery
                            - distinguished
                            - removedByCategory
                            - linkFlairText
                            - linkFlairBackgroundColor
                            - linkFlairTextColor
                            - linkFlairTemplateId
                            - thumbnail
                            - previewImages
                        previousPrice:
                          type:
                            - number
                            - 'null'
                        occurredAt:
                          type: string
                      required:
                        - id
                        - watchId
                        - type
                        - listing
                        - previousPrice
                        - occurredAt
                required:
                  - events
        '404':
          description: Watch not found
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                  code:
                    type: string
                required:
                  - error
        '429':
          description: >-
            Request quota exceeded. Retry after the `Retry-After` header
            (seconds). Response includes `RateLimit-*` headers (IETF draft-7).
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                  code:
                    type: string
                required:
                  - error
              example:
                error: Rate limit exceeded
                code: TOO_MANY_REQUESTS
components:
  schemas:
    XTweet:
      type: object
      properties:
        id:
          type: string
        text:
          type: string
        createdAt:
          type: string
        lang:
          type:
            - string
            - 'null'
        url:
          type: string
        author:
          type: object
          properties:
            id:
              type: string
            username:
              type: string
            displayName:
              type: string
            profileImageUrl:
              type:
                - string
                - 'null'
            verified:
              type: boolean
            isBlueVerified:
              type: boolean
          required:
            - id
            - username
            - displayName
            - profileImageUrl
            - verified
            - isBlueVerified
        metrics:
          type: object
          properties:
            likes:
              type: number
            replies:
              type: number
            retweets:
              type: number
            quotes:
              type: number
            views:
              type:
                - number
                - 'null'
            bookmarks:
              type:
                - number
                - 'null'
          required:
            - likes
            - replies
            - retweets
            - quotes
            - views
            - bookmarks
        media:
          type: array
          items:
            type: object
            properties:
              type:
                type: string
                enum:
                  - photo
                  - video
                  - animated_gif
              url:
                type: string
              previewUrl:
                type:
                  - string
                  - 'null'
              width:
                type:
                  - number
                  - 'null'
              height:
                type:
                  - number
                  - 'null'
              durationMs:
                type:
                  - number
                  - 'null'
              variants:
                type: array
                items:
                  type: object
                  properties:
                    url:
                      type: string
                    contentType:
                      type:
                        - string
                        - 'null'
                    bitrate:
                      type:
                        - number
                        - 'null'
                  required:
                    - url
                    - contentType
                    - bitrate
            required:
              - type
              - url
              - previewUrl
              - width
              - height
              - durationMs
              - variants
        entities:
          type: object
          properties:
            urls:
              type: array
              items:
                type: object
                properties:
                  url:
                    type: string
                  expandedUrl:
                    type:
                      - string
                      - 'null'
                  displayUrl:
                    type:
                      - string
                      - 'null'
                required:
                  - url
                  - expandedUrl
                  - displayUrl
            mentions:
              type: array
              items:
                type: object
                properties:
                  id:
                    type:
                      - string
                      - 'null'
                  username:
                    type: string
                  name:
                    type:
                      - string
                      - 'null'
                required:
                  - id
                  - username
                  - name
            hashtags:
              type: array
              items:
                type: object
                properties:
                  text:
                    type: string
                required:
                  - text
            cashtags:
              type: array
              items:
                type: object
                properties:
                  text:
                    type: string
                required:
                  - text
          required:
            - urls
            - mentions
            - hashtags
            - cashtags
        quotedTweet:
          oneOf:
            - $ref: '#/components/schemas/XTweet'
            - type: 'null'
        retweetedTweet:
          oneOf:
            - $ref: '#/components/schemas/XTweet'
            - type: 'null'
        inReplyToTweetId:
          type:
            - string
            - 'null'
        inReplyToUserId:
          type:
            - string
            - 'null'
        inReplyToUsername:
          type:
            - string
            - 'null'
        conversationId:
          type:
            - string
            - 'null'
        displayTextRange:
          type:
            - array
            - 'null'
          maxItems: 2
          minItems: 2
          prefixItems:
            - type: number
            - type: number
        source:
          type:
            - string
            - 'null'
        possiblySensitive:
          type: boolean
        poll:
          type:
            - object
            - 'null'
          properties:
            choices:
              type: array
              items:
                type: object
                properties:
                  label:
                    type: string
                  votes:
                    type:
                      - number
                      - 'null'
                required:
                  - label
                  - votes
            endAt:
              type:
                - string
                - 'null'
            countsAreFinal:
              type:
                - boolean
                - 'null'
          required:
            - choices
            - endAt
            - countsAreFinal
        card:
          type:
            - object
            - 'null'
          properties:
            type:
              type:
                - string
                - 'null'
            url:
              type:
                - string
                - 'null'
            title:
              type:
                - string
                - 'null'
            description:
              type:
                - string
                - 'null'
            imageUrl:
              type:
                - string
                - 'null'
          required:
            - type
            - url
            - title
            - description
            - imageUrl
        communityNote:
          type:
            - object
            - 'null'
          properties:
            text:
              type:
                - string
                - 'null'
            title:
              type:
                - string
                - 'null'
          required:
            - text
            - title
        editControl:
          type:
            - object
            - 'null'
          properties:
            editTweetIds:
              type: array
              items:
                type: string
            editableUntilMs:
              type:
                - number
                - 'null'
            editsRemaining:
              type:
                - number
                - 'null'
            isEditEligible:
              type:
                - boolean
                - 'null'
          required:
            - editTweetIds
            - editableUntilMs
            - editsRemaining
            - isEditEligible
      required:
        - id
        - text
        - createdAt
        - lang
        - url
        - author
        - metrics
        - media
        - entities
        - quotedTweet
        - retweetedTweet
        - inReplyToTweetId
        - inReplyToUserId
        - inReplyToUsername
        - conversationId
        - displayTextRange
        - source
        - possiblySensitive
        - poll
        - card
        - communityNote
        - editControl
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
      description: API key created from the Nephia dashboard for your Account.

````