get/api/v2/socials/youtube/overview
Return YouTube social citation overview. WatchLLM extension, not confirmed reference REST parity.
Return YouTube social citation overview. WatchLLM extension, not confirmed reference REST parity.
Requires bearer API keyParameters
| Name | In | Description |
|---|---|---|
| search | query | Filter by post/video title, subreddit, or channel.string |
| model | query | Filter by persisted social citation model key.string |
| range | query | Preset cited/published date range. When supplied, it takes precedence over startDate/endDate.string (all, 7, 14, 30, 90) |
| startDate | query | Inclusive ISO date filter for cited/published dates.string |
| endDate | query | Inclusive ISO date filter for cited/published dates.string |
| sortBy | query | Sort field.string (upvotes, comments, citations, position, views, publishedAt) |
| sortOrder | query | Sort direction.string (asc, desc) |
Responses
200
application/jsonSuccessful JSON response.
{
"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.