> ## Documentation Index > Fetch the complete documentation index at: https://promptwatch.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # List YouTube Citations > Get a paginated list of YouTube videos cited in LLM responses, with sorting and filtering. Mirrors the YouTube table on the Socials dashboard. ## OpenAPI ````yaml /v2/openapi.json get /socials/youtube openapi: 3.0.0 info: title: Promptwatch API v2 description: >- API v2 for customer integrations with Promptwatch monitoring platform. This version provides improved structure, additional endpoints, and enhanced functionality. version: 2.0.0 contact: name: Promptwatch Support email: team@promptwatch.com url: https://promptwatch.com license: name: Commercial url: https://promptwatch.com/terms-and-conditions servers: - url: https://server.promptwatch.com/api/v2 description: Promptwatch API v2 security: [] tags: - name: Authentication description: API key validation and authentication - name: Content description: >- AI content generation and optimization. Create content asynchronously and poll for results. - name: Content Gap description: Content gap analysis and recommendations - name: Models description: Available LLM models - name: Monitors description: Monitor management and CRUD operations - name: Page Tracker description: Track URLs and inspect citation stats, responses, and prompts - name: Prompts description: Prompt management and operations - name: Query Fanouts description: ChatGPT query fanout keywords - name: Responses description: LLM response data and analytics - name: Tags description: Tag management for prompts - name: Topics description: Topic management for prompts - name: Actions description: Action items (GEO suggestions and tasks) - name: Personas description: Persona configuration for monitors - name: Brands description: Brand management for competitive analysis - name: Visibility description: Brand visibility time series and competitor heatmaps - name: Citations description: Citation analytics from AI responses - name: Analytics description: Visitor analytics, AI crawler logs, sentiment, and brand visibility trends - name: Projects description: Project management (organization-level keys only) - name: Sitemap description: Sitemap crawl progress and discovered URLs - name: Site Health description: >- Crawled pages with SEO issues (titles, meta descriptions, H1, thin content) - name: Socials description: >- Social media citations (Reddit posts and YouTube videos) found in LLM responses paths: /socials/youtube: get: tags: - Socials summary: List YouTube Citations description: >- Get a paginated list of YouTube videos cited in LLM responses, with sorting and filtering. Mirrors the YouTube table on the Socials dashboard. operationId: listYoutubeCitations parameters: - schema: type: integer default: 1 minimum: 1 in: query name: page required: false description: Page number (1-based) - schema: type: integer default: 25 minimum: 1 maximum: 100 in: query name: size required: false description: Page size - schema: type: string format: uuid in: query name: llmMonitorId required: false description: Filter by monitor - schema: type: string enum: - citationCount - avgPosition - viewCount - likeCount - commentCount - publishedAt default: citationCount in: query name: sortBy required: false description: Field to sort by - schema: type: string enum: - asc - desc default: desc in: query name: sortOrder required: false description: Sort order - schema: type: string format: date-time in: query name: from required: false description: Filter citations from this date (ISO 8601) - schema: type: string format: date-time in: query name: until required: false description: Filter citations until this date (ISO 8601) - schema: anyOf: - type: string description: Single model - type: array items: type: string description: Multiple models in: query name: models required: false description: 'Filter by LLM model IDs. Repeat for multiple: models=x&models=y' - schema: anyOf: - type: string enum: - ORGANIC - BRAND_SPECIFIC - COMPETITOR_COMPARISON - type: array items: type: string enum: - ORGANIC - BRAND_SPECIFIC - COMPETITOR_COMPARISON in: query name: promptTypes required: false description: Filter by prompt type. Repeat for multiple values. - schema: anyOf: - type: string format: uuid - type: array items: type: string format: uuid in: query name: tagIds required: false description: Filter by tag IDs. Repeat for multiple values. - schema: type: string in: query name: query required: false description: Search within video title/description or channel name - schema: type: string in: query name: channelName required: false description: >- Filter to a specific YouTube channel (case-insensitive partial match on title/handle) responses: '200': description: Default Response content: application/json: schema: type: object example: items: - id: 550e8400-e29b-41d4-a716-446655440001 externalId: dQw4w9WgXcQ title: AI Search Optimization Explained description: In this video we explore GEO strategies... viewCount: 98500 likeCount: 3200 commentCount: 411 durationMs: 742000 durationFormatted: '12:22' thumbnail: https://i.ytimg.com/vi/dQw4w9WgXcQ/hqdefault.jpg publishedAt: '2026-01-15T10:00:00.000Z' channel: id: 550e8400-e29b-41d4-a716-446655440002 externalId: UCxxxxxx handle: '@aiexplained' title: AI Explained url: https://www.youtube.com/@aiexplained avatar: null subscriberCount: 250000 url: https://www.youtube.com/watch?v=dQw4w9WgXcQ citationCount: 9 avgPosition: 1.8 minPosition: 1 maxPosition: 4 total: 18 page: 1 size: 25 totalPages: 1 properties: items: type: array items: type: object properties: id: type: string format: uuid description: YouTube video identifier externalId: type: string description: YouTube video ID (e.g. dQw4w9WgXcQ) title: type: string description: Video title description: type: string nullable: true description: Video description snippet viewCount: type: number description: View count likeCount: type: number description: Like count commentCount: type: number description: Comment count durationMs: type: number nullable: true description: Video duration in milliseconds durationFormatted: type: string nullable: true description: Human-readable duration (e.g. 12:34) thumbnail: type: string nullable: true description: Thumbnail URL publishedAt: type: string format: date-time nullable: true description: Video publish date channel: type: object properties: id: type: string format: uuid description: Channel identifier externalId: type: string description: YouTube channel ID (e.g. UCxxxxxx) handle: type: string nullable: true description: Channel handle (e.g. @channelname) title: type: string description: Channel display name url: type: string nullable: true description: Channel URL avatar: type: string nullable: true description: Channel avatar URL subscriberCount: type: number nullable: true description: Subscriber count required: - id - externalId - title additionalProperties: false url: type: string description: Full YouTube video URL citationCount: type: number description: >- Number of times this video was cited in LLM responses avgPosition: type: number nullable: true description: >- Average position of this citation in LLM responses (0-indexed) minPosition: type: number nullable: true description: Minimum citation position maxPosition: type: number nullable: true description: Maximum citation position required: - id - externalId - title - description - viewCount - likeCount - commentCount - durationMs - durationFormatted - thumbnail - publishedAt - channel - url - citationCount - avgPosition - minPosition - maxPosition additionalProperties: false description: YouTube citations for the current page total: type: integer description: Total items matching the request page: type: integer description: Page number (1-based) size: type: integer description: Page size totalPages: type: integer description: Total pages for this page size required: - items - total - page - size - totalPages additionalProperties: false '401': description: Default Response content: application/json: schema: type: object example: error: Unauthorized message: Missing or invalid X-API-Key header. properties: error: type: string description: Error category (often aligned with HTTP semantics) code: type: string description: Optional machine-readable code message: type: string description: Human-readable explanation details: type: object description: Optional structured detail (e.g. validation) additionalProperties: true required: - error - message additionalProperties: false '500': description: Default Response content: application/json: schema: type: object example: code: INTERNAL_ERROR message: An unexpected error occurred properties: code: type: string enum: - INTERNAL_ERROR description: Machine-readable error code message: type: string description: Human-readable error message required: - code - message additionalProperties: false security: - ApiKeyAuth: [] components: securitySchemes: ApiKeyAuth: type: apiKey in: header name: X-API-Key description: >- API key for authentication. Get yours from the Promptwatch dashboard under Settings > API Keys. ````