POST
/
youtube
/
video
/
metadata
YouTube Video Metadata
curl --request POST \
  --url https://mavi-backend.memories.ai/serve/api/v2/youtube/video/metadata \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "video_url": "https://www.youtube.com/watch?v=Y2y4OpzKIK4",
  "channel": "apify"
}
'
{
  "code": "0000",
  "msg": "success",
  "data": [
    {
      "original_url": "https://www.youtube.com/watch?v=Y2y4OpzKIK4",
      "requested_resolution": "720p",
      "title": "Close Encounter with a Siamese Crocodile | Saving Planet Earth: Crocodiles | BBC Earth",
      "channel": "BBC Earth",
      "duration": "2m 39s",
      "provided_resolution": "360p",
      "thumbnail": "https://i.ytimg.com/vi/Y2y4OpzKIK4/maxresdefault.jpg",
      "downloadable_video_link": "https://rr8---sn-bvvbaxivnuxq5uu-vgql.googlevideo.com/videoplayback?...",
      "downloadable_audio_link": "https://rr8---sn-bvvbaxivnuxq5uu-vgql.googlevideo.com/videoplayback?...",
      "merged_downloadable_link": "https://rr8---sn-bvvbaxivnuxq5uu-vgql.googlevideo.com/videoplayback?...",
      "view_count": "48.4K",
      "categories": ["Pets & Animals"],
      "description": "Radio DJ Edith Bowman has a close encounter with a young crocodile...",
      "availability": "public",
      "live_status": "not_live",
      "channel_subscribers": "14.2M",
      "video_filesize": "8.50MB",
      "audio_filesize": "950.39KB",
      "additional_metadata": {
        "view_count": "48.4K",
        "like_count": "223",
        "comment_count": "7",
        "video_type": "long",
        "hashtags": [],
        "keywords": ["Close encounter with a Siamese Crocodile", "saving siamese crocodile", ...],
        "categories": ["Pets & Animals"],
        "language": "en",
        "channel_name": "BBC Earth",
        "channel_id": "UCwmZiChSryoWQCZMIQezgTg",
        "channel_url": "https://www.youtube.com/channel/UCwmZiChSryoWQCZMIQezgTg",
        "channel_followers": "14.2M",
        "uploader_id": "@bbcearth",
        "uploader_url": "https://www.youtube.com/@bbcearth",
        "upload_date": "2009-08-29",
        "video_format": {
          "ext": "mp4",
          "format_note": "360p",
          "height": 360,
          "width": 636,
          "fps": 25,
          "vcodec": "avc1.4d401e",
          "acodec": "none",
          "filesize": "8.50MB"
        },
        "audio_format": {
          "ext": "m4a",
          "format_note": "low",
          "acodec": "mp4a.40.5",
          "abr": 48.82,
          "filesize": "950.39KB"
        },
        "source_platform": "youtube",
        "webpage_url": "https://www.youtube.com/watch?v=Y2y4OpzKIK4"
      }
    }
  ],
  "failed": false,
  "success": true
}
This endpoint allows you to retrieve metadata for a YouTube video.

​
Code Example

import requests

BASE_URL = "https://mavi-backend.memories.ai/serve/api/v2"
API_KEY = "sk-8483027fe3abfe535f6ae01a9979b4f7"
HEADERS = {
    "Authorization": f"{API_KEY}"
}

def youtube_video_metadata(video_url: str, channel: str):
    url = f"{BASE_URL}/youtube/video/metadata"
    data = {"video_url": video_url, "channel": channel}
    resp = requests.post(url, headers=HEADERS, json=data)
    return resp.json()

# Usage example
result = youtube_video_metadata("https://www.youtube.com/watch?v=Y2y4OpzKIK4", "apify")
print(result)

​
Request Body

FieldTypeRequiredDescription
video_urlstringYesThe YouTube video URL
channelstringYesThe channel name. Supported values: apify, rapid, memories.ai

​
Response

Returns the video metadata information. 
{
  "code": "0000",
  "msg": "success",
  "data": [
    {
      "original_url": "https://www.youtube.com/watch?v=Y2y4OpzKIK4",
      "requested_resolution": "720p",
      "title": "Close Encounter with a Siamese Crocodile | Saving Planet Earth: Crocodiles | BBC Earth",
      "channel": "BBC Earth",
      "duration": "2m 39s",
      "provided_resolution": "360p",
      "thumbnail": "https://i.ytimg.com/vi/Y2y4OpzKIK4/maxresdefault.jpg",
      "downloadable_video_link": "https://rr8---sn-bvvbaxivnuxq5uu-vgql.googlevideo.com/videoplayback?...",
      "downloadable_audio_link": "https://rr8---sn-bvvbaxivnuxq5uu-vgql.googlevideo.com/videoplayback?...",
      "merged_downloadable_link": "https://rr8---sn-bvvbaxivnuxq5uu-vgql.googlevideo.com/videoplayback?...",
      "view_count": "48.4K",
      "categories": ["Pets & Animals"],
      "description": "Radio DJ Edith Bowman has a close encounter with a young crocodile...",
      "availability": "public",
      "live_status": "not_live",
      "channel_subscribers": "14.2M",
      "video_filesize": "8.50MB",
      "audio_filesize": "950.39KB",
      "additional_metadata": {
        "view_count": "48.4K",
        "like_count": "223",
        "comment_count": "7",
        "video_type": "long",
        "hashtags": [],
        "keywords": ["Close encounter with a Siamese Crocodile", "saving siamese crocodile", ...],
        "categories": ["Pets & Animals"],
        "language": "en",
        "channel_name": "BBC Earth",
        "channel_id": "UCwmZiChSryoWQCZMIQezgTg",
        "channel_url": "https://www.youtube.com/channel/UCwmZiChSryoWQCZMIQezgTg",
        "channel_followers": "14.2M",
        "uploader_id": "@bbcearth",
        "uploader_url": "https://www.youtube.com/@bbcearth",
        "upload_date": "2009-08-29",
        "video_format": {
          "ext": "mp4",
          "format_note": "360p",
          "height": 360,
          "width": 636,
          "fps": 25,
          "vcodec": "avc1.4d401e",
          "acodec": "none",
          "filesize": "8.50MB"
        },
        "audio_format": {
          "ext": "m4a",
          "format_note": "low",
          "acodec": "mp4a.40.5",
          "abr": 48.82,
          "filesize": "950.39KB"
        },
        "source_platform": "youtube",
        "webpage_url": "https://www.youtube.com/watch?v=Y2y4OpzKIK4"
      }
    }
  ],
  "failed": false,
  "success": true
}

​
Response Parameters

ParameterTypeDescription
codestringResponse code indicating the result status
msgstringResponse message describing the operation result
dataarray[object]Array of video metadata objects
data[].original_urlstringThe original YouTube video URL
data[].requested_resolutionstringThe requested video resolution (e.g., “720p”)
data[].titlestringVideo title
data[].channelstringYouTube channel name
data[].durationstringVideo duration in human-readable format (e.g., “2m 39s”)
data[].provided_resolutionstringThe actual video resolution provided
data[].thumbnailstringThumbnail image URL
data[].downloadable_video_linkstringDirect download link for video file
data[].downloadable_audio_linkstringDirect download link for audio file
data[].merged_downloadable_linkstringMerged video and audio download link
data[].view_countstringNumber of views
data[].categoriesarray[string]Video categories
data[].descriptionstringVideo description
data[].availabilitystringVideo availability status
data[].live_statusstringLive streaming status
data[].channel_subscribersstringNumber of channel subscribers
data[].video_filesizestringVideo file size
data[].audio_filesizestringAudio file size
data[].additional_metadataobjectAdditional metadata including format details, keywords, etc.
successbooleanIndicates whether the operation was successful
failedbooleanIndicates whether the operation failed

Authorizations

​
Authorization
string
header
required

Body

application/json
​
video_url
string
required

The YouTube video URL

Example:

"https://www.youtube.com/watch?v=Y2y4OpzKIK4"

​
channel
enum<string>
required

The channel name. Supported values: apify, rapid, memories.ai

Available options:
apify,
rapid,
memories.ai
Example:

"apify"

Response

200 - application/json

Video metadata information

​
code
string

Response code indicating the result status

Example:

"0000"

​
msg
string

Response message describing the operation result

Example:

"success"

​
data
object[]

Array of video metadata objects

​
success
boolean

Indicates whether the operation was successful

Example:

true

​
failed
boolean

Indicates whether the operation failed

Example:

false