Skip to main content
POST
/
youtube
/
video
/
detail
YouTube Video Detail
curl --request POST \
  --url https://mavi-backend.memories.ai/serve/api/v2/youtube/video/detail \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "video_id": "Y2y4OpzKIK4"
}
'
{
  "code": 200,
  "msg": "success",
  "data": {
    "id": "otECntwBTVU",
    "title": "Finding Empty Restaurants, Then Bringing 100 Customers",
    "url": "https://www.youtube.com/watch?v=otECntwBTVU",
    "author_id": "UCJv5T2W-D3K3fYO0prgv5uw",
    "author_url": "https://www.youtube.com/channel/UCJv5T2W-D3K3fYO0prgv5uw",
    "description": "FOLLOW ME ON SNAP TO WIN $: ...",
    "tags": ["viral", "kindness content", "tipping"],
    "publish_time": "2026-01-10T14:30:53Z",
    "view_count": "8797038",
    "like_count": "413902",
    "comment_count": "9489",
    "duration_seconds": "692"
  }
}

Documentation Index

Fetch the complete documentation index at: https://api-tools.memories.ai/llms.txt

Use this file to discover all available pages before exploring further.

Product: Visual Intelligence — Social Media Scraping Use case: Fetch video metadata, transcripts, captions, and comments from YouTube, Instagram, TikTok, and Twitter/X Host: https://mavi-backend.memories.ai/serve/api/v2 Auth: Authorization: sk-mavi-... (no Bearer prefix)
This API is used to get detailed information for YouTube videos.
Channel routing guide: see Social Media Scraping Overview. Endpoints with a channel request field let you choose apify, rapid, or memories.ai; endpoints without this field use managed routing.
Each API call costs $0.01 USD.

​
Channel Options

If your request supports a channel option, use it to control how scraper data is sourced:
ChannelWhat it meansTypical trade-off
apifyUses Apify, a dedicated web scraping platform with broad content coverage.Most stable and most complete results, but usually more expensive.
rapidUses RapidAPI, a lower-cost aggregation platform.Lower cost, but less stable and often narrower coverage.
memories.aiManaged routing by Memories.ai.Automatically selects the best price/performance path for your request.
Recommendation: Start with memories.ai unless you need to force a specific provider.

​
Code Example

import requests

BASE_URL = "https://mavi-backend.memories.ai/serve/api/v2"
API_KEY = "sk-mavi-..."
HEADERS = {
    "Authorization": f"{API_KEY}",
    "Content-Type": "application/json"
}

def youtube_video_detail(video_id: str):
    url = f"{BASE_URL}/youtube/video/detail"
    data = {"video_id": video_id}
    resp = requests.post(url, json=data, headers=HEADERS)
    return resp.json()

# Usage example
result = youtube_video_detail("your_youtube_video_id")
print(result)

​
Request Body

FieldTypeRequiredDescription
video_idstringYesYouTube video ID — the v parameter from the YouTube video URL
How to get the video_id: Extract the v parameter from a YouTube video URL.For example, from https://www.youtube.com/watch?v=Y2y4OpzKIK4, the video_id is Y2y4OpzKIK4.

​
Response

Returns detailed information for the YouTube video. 
{
  "code": 200,
  "msg": "success",
  "data": {
    "id": "otECntwBTVU",
    "title": "Finding Empty Restaurants, Then Bringing 100 Customers",
    "url": "https://www.youtube.com/watch?v=otECntwBTVU",
    "author_id": "UCJv5T2W-D3K3fYO0prgv5uw",
    "author_url": "https://www.youtube.com/channel/UCJv5T2W-D3K3fYO0prgv5uw",
    "description": "FOLLOW ME ON SNAP TO WIN $: ...",
    "tags": ["viral", "kindness content", "tipping"],
    "publish_time": "2026-01-10T14:30:53Z",
    "view_count": "8797038",
    "like_count": "413902",
    "comment_count": "9489",
    "duration_seconds": "692"
  }
}

​
Response Parameters

ParameterTypeDescription
codeintegerResponse code (200 on success)
msgstringResponse message
dataobjectVideo information
data.idstringYouTube video ID (the v parameter from the URL)
data.titlestringVideo title
data.urlstringCanonical YouTube watch URL. Note: this is the page URL, not a direct media stream — there is no mp4 download URL in the response. To download the file, use Visual Search /scraper_url followed by Visual Search /download.
data.author_idstringChannel ID (the UC... segment from the channel URL)
data.author_urlstringChannel page URL
data.descriptionstringVideo description
data.tagsarrayCreator-provided tags
data.publish_timestringPublish time, ISO 8601
data.view_countstringView count (returned as string)
data.like_countstringLike count (returned as string)
data.comment_countstringComment count (returned as string)
data.duration_secondsstringVideo duration in seconds (returned as string). Convert with int(...) for arithmetic.
Channel metadata is limited to author_id and author_url. To get the channel name, subscriber count, or per-channel statistics, follow up with a dedicated channel endpoint.

Authorizations

​
Authorization
string
header
required

Body

application/json
​
video_id
string
required

YouTube video ID

Example:

"Y2y4OpzKIK4"

Response

200 - application/json

Successfully returned video detailed information

​
code
string

Response code, indicates the operation result status

Example:

200

​
msg
string

Response message, describes the operation result

Example:

"success"

​
data
object

Response data object, contains video detailed information

​
success
boolean

Indicates whether the operation was successful

Example:

true

​
failed
boolean

Indicates whether the operation failed

Example:

false