/api/v2/socials/youtube/overviewReturn YouTube social citation overview. WatchLLM extension, not confirmed Promptwatch public REST parity.
Return YouTube 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
Successful JSON response.
application/json{
"type": "object",
"additionalProperties": false,
"properties": {
"platform": {
"type": "string",
"enum": [
"youtube"
]
},
"overview": {
"type": "object",
"additionalProperties": false,
"properties": {
"totalCitations": {
"type": "integer"
},
"uniqueVideos": {
"type": "integer"
},
"channels": {
"type": "integer"
}
},
"required": [
"totalCitations",
"uniqueVideos",
"channels"
]
},
"topVideos": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"properties": {
"title": {
"type": "string"
},
"channelName": {
"type": "string"
},
"viewsLabel": {
"type": "string"
},
"viewsCount": {
"type": "integer"
},
"likesCount": {
"type": "integer"
},
"commentsCount": {
"type": "integer"
},
"citationsCount": {
"type": "integer"
},
"url": {
"type": "string"
}
},
"required": [
"title",
"channelName",
"viewsLabel",
"viewsCount",
"likesCount",
"commentsCount",
"citationsCount",
"url"
]
}
},
"topChannels": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"properties": {
"channelName": {
"type": "string"
},
"videoCount": {
"type": "integer"
},
"citationsCount": {
"type": "integer"
},
"viewsLabel": {
"type": "string"
},
"subscribersCount": {
"type": "integer"
},
"channelVideosCount": {
"type": "integer"
}
},
"required": [
"channelName",
"videoCount",
"citationsCount",
"viewsLabel",
"subscribersCount",
"channelVideosCount"
]
}
}
},
"required": [
"platform",
"overview",
"topVideos",
"topChannels"
]
}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.