get/api/v2/socials/reddit

List Reddit social citation rows. WatchLLM extension, not confirmed Promptwatch public REST parity.

List Reddit social citation rows. WatchLLM extension, not confirmed Promptwatch public REST parity.

Requires bearer API key

Parameters

search

query

Filter by post/video title, subreddit, or channel.

Schema: string

model

query

Filter by persisted social citation model key.

Schema: string

range

query

Preset cited/published date range. When supplied, it takes precedence over startDate/endDate.

Schema: string (all, 7, 14, 30, 90)

startDate

query

Inclusive ISO date filter for cited/published dates.

Schema: string

endDate

query

Inclusive ISO date filter for cited/published dates.

Schema: string

sortBy

query

Sort field.

Schema: string (upvotes, comments, citations, position, views, publishedAt)

sortOrder

query

Sort direction.

Schema: string (asc, desc)

page

query

Page number.

Schema: integer

size

query

Page size.

Schema: integer

Responses

200

Successful JSON response.

application/json
{
  "type": "object",
  "additionalProperties": false,
  "properties": {
    "items": {
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "id": {
            "type": "string"
          },
          "url": {
            "type": "string"
          },
          "title": {
            "type": "string"
          },
          "subreddit": {
            "type": "string"
          },
          "upvotes": {
            "type": "integer"
          },
          "commentsCount": {
            "type": "integer"
          },
          "citationsCount": {
            "type": "integer"
          },
          "responseCount": {
            "type": "integer"
          },
          "citedInResponseIds": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "avgPosition": {
            "type": "integer"
          },
          "model": {
            "type": "string"
          },
          "state": {
            "type": "string"
          },
          "citedAt": {
            "type": "string",
            "format": "date-time"
          }
        },
        "required": [
          "id",
          "url",
          "title",
          "subreddit",
          "upvotes",
          "commentsCount",
          "citationsCount",
          "responseCount",
          "citedInResponseIds",
          "avgPosition",
          "model",
          "state",
          "citedAt"
        ]
      }
    },
    "total": {
      "type": "integer"
    },
    "page": {
      "type": "integer"
    },
    "size": {
      "type": "integer"
    },
    "totalPages": {
      "type": "integer"
    }
  },
  "required": [
    "items",
    "total",
    "page",
    "size",
    "totalPages"
  ]
}

Try it

Send this request to the local WatchLLM REST handler. Use a key from `/workspace/api`; organization keys can include `X-Project-Id` only when the endpoint documents that header.