YouTube Shorts video data API

What to build with it

Resolve the video URL to its stable platform ID and preserve both.
Store a timestamp with each metric snapshot; do not overwrite historical observations.
Use dedicated comment and transcript reads only when your task needs them.
Confirm that the supplied video is a Short when your analysis is short-form only; the direct video read does not validate the format.

Provider reference: Virlo documentation. Authentication uses a provider-issued Bearer token, stored on your server.

Endpoints and inputs

1 documented operation. Query and path fields are listed separately from JSON request-body fields.

GET/v1/raw/youtube/video

Send exactly one of url or id. The fields are individually optional in the schema, but omitting both or sending both does not satisfy the documented request contract.

Path and query parameters

url: string (query) · optional
id: string (query) · optional

Documented response fields

data: object · required
data.id: string · required
data.platform: string · required · values: tiktok, youtube, instagram
data.url: string · required
data.caption: string | null · required
data.hashtags: array · required
data.published_at: string | null · required
data.duration_seconds: number | null · required
data.thumbnail_url: string | null · required
data.author: object · required
data.author.id: string | null · required
data.author.handle: string | null · required
data.author.display_name: string | null · required
data.author.avatar_url: string | null · required
data.author.verified: boolean | null · required
data.stats: object · required
data.stats.views: number | null · required
data.stats.likes: number | null · required
data.stats.comments: number | null · required
data.stats.shares: number | null · required
data.stats.saves: number | null · required
data.sound: object | null · required
data.sound.id: string | null · required
data.sound.title: string | null · required
data.sound.artist: string | null · required
data.platform_data: object · required

Documented HTTP responses: 200, 400, 401, 402, 404, 429, 502, 503, 504. Handle each non-success response explicitly; do not silently convert a failed lookup to an empty result.

Before you integrate

Shorts research is not the same as a complete YouTube Data API replacement. Check the returned video format before combining this data with long-form channel statistics.
A missing metric is not zero. Videos can become private or disappear, and media URLs may expire independently of the post.

Check the provider's current price, allowed use and retention terms before sending requests. An optional field can be absent; the schema alone does not establish its completeness or accuracy.

For a deeper profile, compare the creator lookup with the ongoing tracking workflow.

Give this task to your coding agent

youtube-shorts-video-api agent prompt

Help me implement youtube shorts video data api using the documented Virlo API.

Reference: https://allthemapis.com/social-media-apis/youtube-shorts-video-api
Provider documentation: https://dev.virlo.ai/docs/raw
Base URL: https://api.virlo.ai
Starting operation: GET /v1/raw/youtube/video

Read the current provider docs and confirm the required inputs before writing code. Load VIRLO_API_KEY from a server-side environment variable and use Bearer authentication. Do not put the key in client code, logs, analytics, or the chat.

Ask me for any missing video URL, creator handle, research intent, or job ID. Do not invent a result. Ask for approval before starting billable lookups, recurring jobs, or destructive changes. For jobs, keep the returned ID and poll with the documented delay instead of starting the job twice. Handle pagination, rate limits, partial results, and missing fields explicitly.

Build the smallest integration for this task:
1. Resolve the video URL to its stable platform ID and preserve both.
2. Store a timestamp with each metric snapshot; do not overwrite historical observations.
3. Use dedicated comment and transcript reads only when your task needs them.
4. Confirm that the supplied video is a Short when your analysis is short-form only; the direct video read does not validate the format.

Return the code, the environment variables I need, and a short explanation of what was actually retrieved versus inferred. Do not execute paid requests until I approve.

Sources and review dates

Virlo's public documentation and OpenAPI schema reviewed October 27, 2026. Endpoint paths and field names below refer to that provider's API. This is an integration reference, not a measured performance ranking.

Corrections: email faizank@docsalot.dev with an official source.