Video Metadata API

Retrieve a video's title, description, engagement counts, tags and channel details.

Metadata returns the post's own details: title, description, tags, engagement counts and channel. It is the cheapest and fastest capability, and counts as audio-only for the length limit.

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_abcdefghij123456",
    "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",
        "paid_promotion": false
      }
    }
  }
}

Response fields

Every field except title, duration_seconds and tags can be null: platforms differ in what they publish, and creators can hide counts. On an upload, title is the upload_filename, tags is empty and the rest is null.

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 \| null	URL of the video's thumbnail image. null for an uploaded file.
paid_promotion	boolean \| null	The platform's own paid label: true when the creator marked the video "Includes paid promotion" on YouTube or "Paid partnership" on TikTok. null on Instagram and uploads, or when the label could not be read.

A job on a link can return metadata without asking for it, at no extra cost. On a brands job, brands named in the title, description or tags come back as timeless source: "metadata" appearances: see Brands.

Metadata

Response fields

On this page