> ## Documentation Index > Fetch the complete documentation index at: https://docs.yousonder.com/llms.txt > Use this file to discover all available pages before exploring further. # Get a video ## OpenAPI ````yaml /api-reference/openapi.json get /videos/{id} openapi: 3.1.0 info: title: Sonder API version: 1.0.0 description: >- Read an author's Sonder videos, views, viral days and view milestones. Every request uses an API key the author creates in Sonder, and sees that author's data only. servers: - url: https://api.yousonder.com/v1 description: Production - url: https://sonder-server-production.up.railway.app/v1 description: Production (direct address) security: - bearerAuth: [] tags: - name: Account description: Who the key belongs to. - name: Books description: The author's books. - name: Videos description: Posted videos with views, viral status and milestones. - name: Stats description: Day-by-day views. - name: Events description: Viral and milestone moments, for polling. - name: Connect description: One-click connect (OAuth 2.0). paths: /videos/{id}: get: tags: - Videos summary: Get a video operationId: getVideo parameters: - name: id in: path required: true description: The video ID. schema: type: string format: uuid responses: '200': description: The video. content: application/json: schema: type: object required: - success - data properties: success: type: boolean const: true data: $ref: '#/components/schemas/Video' example: success: true data: id: 9f3c2a71-4b6e-4d8a-a1c5-7e2b9d0f3a64 title: Your kid isn't lazy. They're exhausted. thumbnail_url: https://example.com/thumbnails/9f3c2a71.jpg book: id: 5b1d7c2e-8f0a-4c1b-9d3e-2a6f4b8c9e01 title: The Quiet Hours posted_at: '2026-09-14T17:02:11.000Z' views: 48213 likes: 3120 comments: 187 shares: 402 saves: 911 views_updated_at: '2026-09-16T09:07:44.000Z' views_final: false platforms: - platform: instagram url: https://www.instagram.com/reel/C9xYz123abc/ views: 30211 likes: 2204 comments: 131 shares: 350 saves: 802 posted_at: '2026-09-14T17:02:11.000Z' views_updated_at: '2026-09-16T09:07:44.000Z' - platform: youtube url: https://www.youtube.com/shorts/aB3dE5fG7hI views: 18002 likes: 916 comments: 56 shares: 52 saves: 109 posted_at: '2026-09-14T17:02:12.000Z' views_updated_at: '2026-09-16T09:05:10.000Z' viral: is_viral: true went_viral_at: '2026-09-15T14:00:00.000Z' views_when_viral: 12840 threshold: 12000 author_median_views: 1200 compared_videos: 23 milestones: - views: 1000 reached_at: '2026-09-14T21:00:00.000Z' - views: 10000 reached_at: '2026-09-15T12:00:00.000Z' '401': description: The API key is missing, malformed or revoked. content: application/json: schema: $ref: '#/components/schemas/Error' example: success: false error: code: invalid_api_key message: >- That API key is not valid. Check it was copied in full, or create a new one in Sonder under Settings → API keys. '403': description: The author's Sonder plan isn't active. content: application/json: schema: $ref: '#/components/schemas/Error' example: success: false error: code: plan_inactive message: >- This Sonder account doesn't have an active plan, so its data isn't shared. The key works again as soon as the plan is active. '404': description: No posted video with that ID belongs to this account. content: application/json: schema: $ref: '#/components/schemas/Error' example: success: false error: code: not_found message: No posted video with that ID belongs to this account. '429': description: >- More than 60 requests in a minute with this key. Wait for the seconds in `Retry-After`. content: application/json: schema: $ref: '#/components/schemas/Error' example: success: false error: code: rate_limited message: >- Too many requests. Each key allows 60 a minute; try again after the time in the Retry-After header. components: schemas: Video: type: object required: - id - title - thumbnail_url - book - posted_at - views - likes - comments - shares - saves - views_updated_at - views_final - platforms - viral - milestones properties: id: type: string format: uuid title: type: string description: The video's title; the book title when the video has none. thumbnail_url: type: - string - 'null' format: uri book: oneOf: - $ref: '#/components/schemas/BookRef' - type: 'null' posted_at: type: string format: date-time description: When it first went out on any platform. views: type: integer description: Total across every platform it was posted to through Sonder. likes: type: integer comments: type: integer shares: type: integer saves: type: integer views_updated_at: type: - string - 'null' format: date-time views_final: type: boolean description: >- True once the video is past 30 days old: Sonder stops refreshing its views. platforms: type: array items: $ref: '#/components/schemas/PlatformPost' viral: $ref: '#/components/schemas/Viral' milestones: type: array items: $ref: '#/components/schemas/Milestone' description: Milestones reached, lowest first. Error: type: object required: - success - error properties: success: type: boolean const: false error: type: object required: - code - message properties: code: type: string description: Stable, machine-readable reason. enum: - missing_api_key - invalid_api_key - api_key_revoked - plan_inactive - rate_limited - invalid_parameter - range_too_long - not_found - internal_error message: type: string description: What went wrong and what to do, in plain English. BookRef: type: object required: - id - title properties: id: type: string format: uuid title: type: string PlatformPost: type: object required: - platform - url - views - likes - comments - shares - saves - posted_at - views_updated_at properties: platform: type: string enum: - tiktok - instagram - youtube - facebook - pinterest url: type: - string - 'null' format: uri description: The post on the platform. views: type: integer likes: type: integer comments: type: integer shares: type: integer saves: type: integer posted_at: type: string format: date-time views_updated_at: type: - string - 'null' format: date-time Viral: type: object required: - is_viral - went_viral_at - views_when_viral - threshold - author_median_views - compared_videos description: See "How Sonder decides a video went viral" in the guides. properties: is_viral: type: boolean description: Once true, stays true. went_viral_at: type: - string - 'null' format: date-time description: The hour the video crossed its line. views_when_viral: type: - integer - 'null' threshold: type: integer description: >- The line it crossed, or (not yet viral) the line it has to reach now. author_median_views: type: - integer - 'null' description: >- The author's typical video. Null when there are fewer than 5 videos to compare. compared_videos: type: integer description: How many of the author’s videos made up the median. Milestone: type: object required: - views - reached_at properties: views: type: integer description: >- 1,000 · 10,000 · 50,000 · 100,000 · 250,000 · 500,000 · 1M · 2M · 5M · 10M · 20M… reached_at: type: string format: date-time securitySchemes: bearerAuth: type: http scheme: bearer description: An API key from Sonder → Settings → API keys, like `sonder_live_…`. ````