Metadata
Retrieve a video's title, description, engagement counts, tags, and channel details.
Metadata returns the video's own published details — title, description, tags, engagement counts, and channel information. It requires no transcription or frame analysis, which makes it the cheapest and fastest capability.
curl -X POST https://api.netraflow.com/v1/jobs \
-H "Content-Type: application/json" \
-H "X-Api-Key: sk_live_your_key_here" \
-d '{
"url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
"capabilities": ["metadata"]
}'{
"data": {
"job_id": "job_abc123",
"status": "completed",
"results": {
"metadata": {
"title": "Rick Astley - Never Gonna Give You Up (Official Video)",
"description": "The official video for Never Gonna Give You Up...",
"duration_seconds": 212.0,
"view_count": 1547829301,
"like_count": 17204553,
"dislike_count": null,
"comment_count": 2401882,
"tags": ["rick astley", "never gonna give you up", "80s pop"],
"upload_date": "2009-10-25",
"channel_name": "Rick Astley",
"channel_follower_count": 4210000,
"thumbnail_url": "https://i.ytimg.com/vi/dQw4w9WgXcQ/maxresdefault.jpg"
}
}
}
}Response fields
Every field except title, duration_seconds, tags, and thumbnail_url is nullable — platforms differ in what they publish, and some counts are hidden by the creator.
| Prop | Type | Description |
|---|---|---|
| title | string | Video title. |
| description | string | null | Video description as published. |
| duration_seconds | number | Video duration in seconds. |
| view_count | integer | null | View count at the time of analysis. |
| like_count | integer | null | Like count at the time of analysis. |
| dislike_count | integer | null | Dislike count. Null on platforms that no longer publish it. |
| comment_count | integer | null | Comment count at the time of analysis. |
| tags | string[] | Creator-supplied tags. Empty when the platform has none. |
| upload_date | string | null | Publication date. |
| channel_name | string | null | Channel or account name. |
| channel_follower_count | integer | null | Follower or subscriber count. |
| thumbnail_url | string | URL of the video's thumbnail image. |
A metadata block may appear in results even when you didn't request the capability — it is included whenever the
data was already available. You are only charged for metadata when you request it.
Duration limits
Metadata requires no frame analysis, so it uses the higher audio-only ceiling: 10 minutes on Free, 30 on Starter, 90 on Pro, 120 on Scale. The same ceiling applies when it is combined with transcription only. Combining it with summary, brands, or custom queries drops the job to the standard video ceiling.
Metadata as a brand source
On jobs that also request brands, brands named in the title, description, or tags are surfaced as appearances with source: "metadata". These are timeless — they carry no timestamp, since a mention in a title isn't tied to a moment in the video. See Brands.