get/api/v2/socials/reddit/overview

Return Reddit social citation overview. WatchLLM extension, not confirmed Promptwatch public REST parity.

Return Reddit social citation overview. 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)

Responses

200

Successful JSON response.

application/json
{
  "type": "object",
  "additionalProperties": false,
  "properties": {
    "platform": {
      "type": "string",
      "enum": [
        "reddit"
      ]
    },
    "overview": {
      "type": "object",
      "additionalProperties": false,
      "properties": {
        "posts": {
          "type": "integer"
        },
        "totalCitations": {
          "type": "integer"
        },
        "upvotes": {
          "type": "integer"
        },
        "comments": {
          "type": "integer"
        }
      },
      "required": [
        "posts",
        "totalCitations",
        "upvotes",
        "comments"
      ]
    },
    "topPosts": {
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "title": {
            "type": "string"
          },
          "subreddit": {
            "type": "string"
          },
          "citationsCount": {
            "type": "integer"
          },
          "url": {
            "type": "string"
          }
        },
        "required": [
          "title",
          "subreddit",
          "citationsCount",
          "url"
        ]
      }
    }
  },
  "required": [
    "platform",
    "overview",
    "topPosts"
  ]
}

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.