social media video downloader: A comprehensive API for extracting video details, metadata, and.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
Retrieves media and metadata for a given Facebook post URL. Group: Facebook-Posts. Billing per call: 1 Credits.
The URL of the Facebook post.
A comma-separated list of quality formats to generate server-rendered video links for. Allowed values: 144p, 240p, 360p, 480p, 720p, 1080p, highres, midres, lowres, all, all_highres.
This tool isn't marked read-only, so it may change something on the server or in an account you connected.
Retrieves media and metadata for a given Facebook post URL. Group: Facebook-Posts. Billing per call: 1 Credits.
| Argument | Type | Description |
|---|---|---|
| url* | string | The URL of the Facebook post. |
| renderableFormats | string | A comma-separated list of quality formats to generate server-rendered video links for. Allowed values: 144p, 240p, 360p, 480p, 720p, 1080p, highres, midres, lowres, all, all_highres. |
{
"type": "object",
"required": [
"url"
],
"properties": {
"url": {
"type": "string",
"example": "https://www.facebook.com/share/r/14GFChzicox/",
"description": "The URL of the Facebook post."
},
"renderableFormats": {
"type": "string",
"example": "720p,highres",
"description": "A comma-separated list of quality formats to generate server-rendered video links for. Allowed values: 144p, 240p, 360p, 480p, 720p, 1080p, highres, midres, lowres, all, all_highres."
}
},
"additionalProperties": false
}Retrieves the 'about' information for a given Facebook profile URL. Group: Facebook-Profile. Billing per call: 1 Credits.
| Argument | Type | Description |
|---|---|---|
| url* | string | The URL of the Facebook profile. |
{
"type": "object",
"required": [
"url"
],
"properties": {
"url": {
"type": "string",
"example": "https://www.facebook.com/zuck",
"description": "The URL of the Facebook profile."
}
},
"additionalProperties": false
}Retrieves the profile details for a given Facebook profile URL. Group: Facebook-Profile. Billing per call: 1 Credits.
| Argument | Type | Description |
|---|---|---|
| url* | string | The URL of the Facebook profile. |
{
"type": "object",
"required": [
"url"
],
"properties": {
"url": {
"type": "string",
"example": "https://www.facebook.com/zuck",
"description": "The URL of the Facebook profile."
}
},
"additionalProperties": false
}Retrieves the profile ID for a given Facebook profile URL. Group: Facebook-Profile. Billing per call: 1 Credits.
| Argument | Type | Description |
|---|---|---|
| url* | string | The URL of the Facebook profile. |
{
"type": "object",
"required": [
"url"
],
"properties": {
"url": {
"type": "string",
"example": "https://www.facebook.com/zuck",
"description": "The URL of the Facebook profile."
}
},
"additionalProperties": false
}Retrieves the photos from a given Facebook profile URL. Group: Facebook-Profile. Billing per call: 1 Credits.
| Argument | Type | Description |
|---|---|---|
| url* | string | The URL of the Facebook profile. |
{
"type": "object",
"required": [
"url"
],
"properties": {
"url": {
"type": "string",
"example": "https://www.facebook.com/zuck",
"description": "The URL of the Facebook profile."
}
},
"additionalProperties": false
}Retrieves the reels from a given Facebook profile URL. Group: Facebook-Profile. Billing per call: 1 Credits.
| Argument | Type | Description |
|---|---|---|
| url* | string | The URL of the Facebook profile. |
{
"type": "object",
"required": [
"url"
],
"properties": {
"url": {
"type": "string",
"example": "https://www.facebook.com/zuck",
"description": "The URL of the Facebook profile."
}
},
"additionalProperties": false
}Retrieves the media post for a given Instagram shortcode. Group: Instagram-Media. Billing per call: 1 Credits.
| Argument | Type | Description |
|---|---|---|
| shortcode* | string | The Instagram shortcode to look up. |
| renderableFormats | string | A comma-separated list of quality formats to generate server-rendered video links for. The number of formats that can be rendered depends on your subscription plan. Allowed values: 144p, 144p60 HDR, 240p, 240p60 HDR, 360p, 360p60 HDR, 480p, 480p60 HDR, 720p, 720p60, 720p60 HDR, 1080p, 1080p60, 1080p60 HDR, 1440p, 1440p60, 1440p60 HDR, 2160p, 2160p60, 2160p60 HDR, highres, midres, lowres, all, all_highres. |
{
"type": "object",
"required": [
"shortcode"
],
"properties": {
"shortcode": {
"type": "string",
"example": "DH6N2p3R6WU",
"description": "The Instagram shortcode to look up."
},
"renderableFormats": {
"type": "string",
"example": "720p,highres",
"description": "A comma-separated list of quality formats to generate server-rendered video links for. The number of formats that can be rendered depends on your subscription plan. Allowed values: 144p, 144p60 HDR, 240p, 240p60 HDR, 360p, 360p60 HDR, 480p, 480p60 HDR, 720p, 720p60, 720p60 HDR, 1080p, 1080p60, 1080p60 HDR, 1440p, 1440p60, 1440p60 HDR, 2160p, 2160p60, 2160p60 HDR, highres, midres, lowres, all, all_highres."
}
},
"additionalProperties": false
}Retrieves the profile details for a given Instagram username. Group: Instagram-User. Billing per call: 5 Credits.
| Argument | Type | Description |
|---|---|---|
| username* | string | The Instagram username to look up. |
{
"type": "object",
"required": [
"username"
],
"properties": {
"username": {
"type": "string",
"example": "instagram",
"description": "The Instagram username to look up."
}
},
"additionalProperties": false
}Retrieves the user ID for a given Instagram username. Group: Instagram-User. Billing per call: 5 Credits.
| Argument | Type | Description |
|---|---|---|
| username* | string | The Instagram username to look up. |
{
"type": "object",
"required": [
"username"
],
"properties": {
"username": {
"type": "string",
"example": "instagram",
"description": "The Instagram username to look up."
}
},
"additionalProperties": false
}Retrieves every image size and video stream of a Pinterest pin (including each page of an idea/story pin), along with its title, creator and metadata. Group: Pinterest-Pin. Billing per call: 1 Credits.
| Argument | Type | Description |
|---|---|---|
| pinId* | string | The numeric Pinterest pin ID, as in pinterest.com/pin/{pinId}/. |
| countryCode | string | ISO 3166-1 alpha-2 country code (case-insensitive) or 'worldwide'. Fetches the content as if from that country. |
{
"type": "object",
"required": [
"pinId"
],
"properties": {
"pinId": {
"type": "string",
"title": "pinId",
"description": "The numeric Pinterest pin ID, as in pinterest.com/pin/{pinId}/."
},
"countryCode": {
"type": "string",
"title": "countryCode",
"description": "ISO 3166-1 alpha-2 country code (case-insensitive) or 'worldwide'. Fetches the content as if from that country."
}
},
"additionalProperties": false
}Retrieves media and metadata for a given TikTok post URL. Group: TikTok-Post. Billing per call: 1 Credits.
| Argument | Type | Description |
|---|---|---|
| url* | string | The URL of the TikTok post. |
{
"type": "object",
"required": [
"url"
],
"properties": {
"url": {
"type": "string",
"example": "https://www.tiktok.com/@username/video/1234567890",
"description": "The URL of the TikTok post."
}
},
"additionalProperties": false
}Retrieves the profile details for a given TikTok user URL. Group: TikTok-User. Billing per call: 1 Credits.
| Argument | Type | Description |
|---|---|---|
| url* | string | The URL of the TikTok user profile. |
{
"type": "object",
"required": [
"url"
],
"properties": {
"url": {
"type": "string",
"example": "https://www.tiktok.com/@username",
"description": "The URL of the TikTok user profile."
}
},
"additionalProperties": false
}Retrieves detailed information about a specific YouTube channel. Group: YouTube-Channel. Billing per call: 1 Credits.
| Argument | Type | Description |
|---|---|---|
| lang | string | Language code for localized content. |
| channelId* | string | The ID of the YouTube channel. |
{
"type": "object",
"required": [
"channelId"
],
"properties": {
"lang": {
"type": "string",
"description": "Language code for localized content."
},
"channelId": {
"type": "string",
"example": "UCmq1iHmomVRCf2APufQZkCQ",
"description": "The ID of the YouTube channel."
}
},
"additionalProperties": false
}Retrieves the channel ID for a given YouTube handle (e.g., '@MrBeast'). Group: YouTube-Channel. Billing per call: 1 Credits.
| Argument | Type | Description |
|---|---|---|
| handle* | string | The handle of the YouTube channel. |
{
"type": "object",
"required": [
"handle"
],
"properties": {
"handle": {
"type": "string",
"example": "@MrBeast",
"description": "The handle of the YouTube channel."
}
},
"additionalProperties": false
}Retrieves playlists, releases, or podcasts from a specific YouTube channel. Group: YouTube-Channel. Billing per call: 1 Credits.
| Argument | Type | Description |
|---|---|---|
| lang | string | Language code for localized content. |
| channelId* | string | The ID of the YouTube channel. |
| nextToken | string | A token for paginating to the next set of results. |
| contentType* | string | The type of content to retrieve. Allowed values: playlists, releases, podcasts. |
{
"type": "object",
"required": [
"channelId",
"contentType"
],
"properties": {
"lang": {
"type": "string",
"description": "Language code for localized content."
},
"channelId": {
"type": "string",
"example": "UCmq1iHmomVRCf2APufQZkCQ",
"description": "The ID of the YouTube channel."
},
"nextToken": {
"type": "string",
"description": "A token for paginating to the next set of results."
},
"contentType": {
"enum": [
"playlists",
"releases",
"podcasts"
],
"type": "string",
"example": "playlists",
"description": "The type of content to retrieve. Allowed values: playlists, releases, podcasts."
}
},
"additionalProperties": false
}Retrieves posts from a specific YouTube channel. Use `nextToken` to paginate. Group: YouTube-Channel. Billing per call: 1 Credits.
| Argument | Type | Description |
|---|---|---|
| lang | string | Language code for localized content. |
| channelId* | string | The ID of the YouTube channel. |
| nextToken | string | A token for paginating to the next set of results. |
{
"type": "object",
"required": [
"channelId"
],
"properties": {
"lang": {
"type": "string",
"description": "Language code for localized content."
},
"channelId": {
"type": "string",
"example": "UCmq1iHmomVRCf2APufQZkCQ",
"description": "The ID of the YouTube channel."
},
"nextToken": {
"type": "string",
"description": "A token for paginating to the next set of results."
}
},
"additionalProperties": false
}Retrieves videos, shorts, or livestreams from a specific YouTube channel. Group: YouTube-Channel. Billing per call: 1 Credits.
| Argument | Type | Description |
|---|---|---|
| lang | string | Language code for localized content. |
| channelId* | string | The ID of the YouTube channel. |
| nextToken | string | A token for paginating to the next set of results. |
| contentType* | string | The type of content to retrieve. Allowed values: videos, shorts, livestreams. |
{
"type": "object",
"required": [
"channelId",
"contentType"
],
"properties": {
"lang": {
"type": "string",
"description": "Language code for localized content."
},
"channelId": {
"type": "string",
"example": "UCmq1iHmomVRCf2APufQZkCQ",
"description": "The ID of the YouTube channel."
},
"nextToken": {
"type": "string",
"description": "A token for paginating to the next set of results."
},
"contentType": {
"enum": [
"videos",
"shorts",
"livestreams"
],
"type": "string",
"example": "videos",
"description": "The type of content to retrieve. Allowed values: videos, shorts, livestreams."
}
},
"additionalProperties": false
}Retrieves videos for a given hashtag. Group: YouTube-Hashtag. Billing per call: 1 Credits.
| Argument | Type | Description |
|---|---|---|
| tag* | string | The hashtag to search for (without the '#'). |
| lang | string | Language code for localized content. |
| nextToken | string | A token for paginating to the next set of results. |
{
"type": "object",
"required": [
"tag"
],
"properties": {
"tag": {
"type": "string",
"example": "HowToCook",
"description": "The hashtag to search for (without the '#')."
},
"lang": {
"type": "string",
"description": "Language code for localized content."
},
"nextToken": {
"type": "string",
"description": "A token for paginating to the next set of results."
}
},
"additionalProperties": false
}Extracts playlist information and a paginated list of its videos. Group: YouTube-Playlist. Billing per call: 1 Credits.
| Argument | Type | Description |
|---|---|---|
| lang | string | Language code for localized content. |
| nextToken | string | A token for paginating to the next set of results. |
| playlistId* | string | The ID of the YouTube playlist. |
| countryCode | string | ISO 3166-1 alpha-2 country code for geo-specific results. |
{
"type": "object",
"required": [
"playlistId"
],
"properties": {
"lang": {
"type": "string",
"description": "Language code for localized content."
},
"nextToken": {
"type": "string",
"description": "A token for paginating to the next set of results."
},
"playlistId": {
"type": "string",
"example": "PLihHLoNkOpqb_G4up_u_It9Lauz519kZf",
"description": "The ID of the YouTube playlist."
},
"countryCode": {
"type": "string",
"description": "ISO 3166-1 alpha-2 country code for geo-specific results."
}
},
"additionalProperties": false
}Retrieves comments for a YouTube post with sorting options and pagination. Group: YouTube-Post. Billing per call: 1 Credits.
| Argument | Type | Description |
|---|---|---|
| lang | string | Language code for localized content. |
| postId* | string | The ID of the YouTube post. |
| sortBy | string | The sort order for comments. Allowed values: TOP_COMMENTS, NEWEST_FIRST. |
| channelId* | string | The ID of the channel that created the post. |
| nextToken | string | A token for paginating to the next set of results. |
{
"type": "object",
"required": [
"postId",
"channelId"
],
"properties": {
"lang": {
"type": "string",
"description": "Language code for localized content."
},
"postId": {
"type": "string",
"example": "UgkxxbGT-ChKuVaZ0-HlTt4PwA1y3MgLIVkH",
"description": "The ID of the YouTube post."
},
"sortBy": {
"enum": [
"TOP_COMMENTS",
"NEWEST_FIRST"
],
"type": "string",
"default": "TOP_COMMENTS",
"description": "The sort order for comments. Allowed values: TOP_COMMENTS, NEWEST_FIRST."
},
"channelId": {
"type": "string",
"example": "UCmq1iHmomVRCf2APufQZkCQ",
"description": "The ID of the channel that created the post."
},
"nextToken": {
"type": "string",
"description": "A token for paginating to the next set of results."
}
},
"additionalProperties": false
}Retrieves detailed information about a specific YouTube community post. Group: YouTube-Post. Billing per call: 1 Credits.
| Argument | Type | Description |
|---|---|---|
| lang | string | Language code for localized content. |
| postId* | string | The ID of the YouTube post. |
| channelId* | string | The ID of the channel that created the post. |
{
"type": "object",
"required": [
"postId",
"channelId"
],
"properties": {
"lang": {
"type": "string",
"description": "Language code for localized content."
},
"postId": {
"type": "string",
"example": "UgkxxbGT-ChKuVaZ0-HlTt4PwA1y3MgLIVkH",
"description": "The ID of the YouTube post."
},
"channelId": {
"type": "string",
"example": "UCmq1iHmomVRCf2APufQZkCQ",
"description": "The ID of the channel that created the post."
}
},
"additionalProperties": false
}Search across all YouTube content types (videos, channels, playlists). Group: YouTube-Search. Billing per call: 1 Credits.
| Argument | Type | Description |
|---|---|---|
| lang | string | Language code for localized content. |
| query* | string | The search query. |
| sortBy | string | DEPRECATED: The sort order for search results. Please use 'prioritize' and 'uploadDate' instead. Allowed values: relevance, rating, upload_date, view_count. |
| duration | string | Filter results by video duration. |
| features | string | A comma-separated list of video features to filter by. Allowed values: 360, 3d, 4k, creative_commons, hd, hdr, live, location, purchased, subtitles, vr180. |
| nextToken | string | A token for paginating to the next set of results. |
| prioritize | string | Prioritize results by relevance or popularity. |
| uploadDate | string | Filter results by upload date. |
{
"type": "object",
"required": [
"query"
],
"properties": {
"lang": {
"type": "string",
"description": "Language code for localized content."
},
"query": {
"type": "string",
"example": "autocad",
"description": "The search query."
},
"sortBy": {
"enum": [
"relevance",
"rating",
"upload_date",
"view_count"
],
"type": "string",
"default": "relevance",
"description": "DEPRECATED: The sort order for search results. Please use 'prioritize' and 'uploadDate' instead. Allowed values: relevance, rating, upload_date, view_count."
},
"duration": {
"enum": [
"all",
"over_twenty_mins",
"three_to_twenty_mins",
"under_three_mins"
],
"type": "string",
"default": "all",
"description": "Filter results by video duration."
},
"features": {
"type": "string",
"description": "A comma-separated list of video features to filter by. Allowed values: 360, 3d, 4k, creative_commons, hd, hdr, live, location, purchased, subtitles, vr180."
},
"nextToken": {
"type": "string",
"description": "A token for paginating to the next set of results."
},
"prioritize": {
"enum": [
"relevance",
"popularity"
],
"type": "string",
"default": "relevance",
"description": "Prioritize results by relevance or popularity."
},
"uploadDate": {
"enum": [
"all",
"month",
"week",
"year",
"today"
],
"type": "string",
"default": "all",
"description": "Filter results by upload date."
}
},
"additionalProperties": false
}Searches for channels on YouTube. Group: YouTube-Search. Billing per call: 1 Credits.
| Argument | Type | Description |
|---|---|---|
| lang | string | Language code for localized content. |
| query* | string | The search query. |
| sortBy | string | DEPRECATED: The sort order for search results. Please use 'prioritize' and 'uploadDate' instead. Allowed values: relevance, rating, upload_date, view_count. |
| duration | string | Filter results by video duration. |
| features | string | A comma-separated list of video features to filter by. Allowed values: 360, 3d, 4k, creative_commons, hd, hdr, live, location, purchased, subtitles, vr180. |
| nextToken | string | A token for paginating to the next set of results. |
| prioritize | string | Prioritize results by relevance or popularity. |
| uploadDate | string | Filter results by upload date. |
{
"type": "object",
"required": [
"query"
],
"properties": {
"lang": {
"type": "string",
"description": "Language code for localized content."
},
"query": {
"type": "string",
"example": "autocad",
"description": "The search query."
},
"sortBy": {
"enum": [
"relevance",
"rating",
"upload_date",
"view_count"
],
"type": "string",
"default": "relevance",
"description": "DEPRECATED: The sort order for search results. Please use 'prioritize' and 'uploadDate' instead. Allowed values: relevance, rating, upload_date, view_count."
},
"duration": {
"enum": [
"all",
"over_twenty_mins",
"three_to_twenty_mins",
"under_three_mins"
],
"type": "string",
"default": "all",
"description": "Filter results by video duration."
},
"features": {
"type": "string",
"description": "A comma-separated list of video features to filter by. Allowed values: 360, 3d, 4k, creative_commons, hd, hdr, live, location, purchased, subtitles, vr180."
},
"nextToken": {
"type": "string",
"description": "A token for paginating to the next set of results."
},
"prioritize": {
"enum": [
"relevance",
"popularity"
],
"type": "string",
"default": "relevance",
"description": "Prioritize results by relevance or popularity."
},
"uploadDate": {
"enum": [
"all",
"month",
"week",
"year",
"today"
],
"type": "string",
"default": "all",
"description": "Filter results by upload date."
}
},
"additionalProperties": false
}Searches for movies on YouTube. Group: YouTube-Search. Billing per call: 1 Credits.
| Argument | Type | Description |
|---|---|---|
| lang | string | Language code for localized content. |
| query* | string | The search query. |
| sortBy | string | DEPRECATED: The sort order for search results. Please use 'prioritize' and 'uploadDate' instead. Allowed values: relevance, rating, upload_date, view_count. |
| duration | string | Filter results by video duration. |
| features | string | A comma-separated list of video features to filter by. Allowed values: 360, 3d, 4k, creative_commons, hd, hdr, live, location, purchased, subtitles, vr180. |
| nextToken | string | A token for paginating to the next set of results. |
| prioritize | string | Prioritize results by relevance or popularity. |
| uploadDate | string | Filter results by upload date. |
{
"type": "object",
"required": [
"query"
],
"properties": {
"lang": {
"type": "string",
"description": "Language code for localized content."
},
"query": {
"type": "string",
"example": "man of steel",
"description": "The search query."
},
"sortBy": {
"enum": [
"relevance",
"rating",
"upload_date",
"view_count"
],
"type": "string",
"default": "relevance",
"description": "DEPRECATED: The sort order for search results. Please use 'prioritize' and 'uploadDate' instead. Allowed values: relevance, rating, upload_date, view_count."
},
"duration": {
"enum": [
"all",
"over_twenty_mins",
"three_to_twenty_mins",
"under_three_mins"
],
"type": "string",
"default": "all",
"description": "Filter results by video duration."
},
"features": {
"type": "string",
"description": "A comma-separated list of video features to filter by. Allowed values: 360, 3d, 4k, creative_commons, hd, hdr, live, location, purchased, subtitles, vr180."
},
"nextToken": {
"type": "string",
"description": "A token for paginating to the next set of results."
},
"prioritize": {
"enum": [
"relevance",
"popularity"
],
"type": "string",
"default": "relevance",
"description": "Prioritize results by relevance or popularity."
},
"uploadDate": {
"enum": [
"all",
"month",
"week",
"year",
"today"
],
"type": "string",
"default": "all",
"description": "Filter results by upload date."
}
},
"additionalProperties": false
}Searches for playlists on YouTube. Group: YouTube-Search. Billing per call: 1 Credits.
| Argument | Type | Description |
|---|---|---|
| lang | string | Language code for localized content. |
| query* | string | The search query. |
| sortBy | string | DEPRECATED: The sort order for search results. Please use 'prioritize' and 'uploadDate' instead. Allowed values: relevance, rating, upload_date, view_count. |
| duration | string | Filter results by video duration. |
| features | string | A comma-separated list of video features to filter by. Allowed values: 360, 3d, 4k, creative_commons, hd, hdr, live, location, purchased, subtitles, vr180. |
| nextToken | string | A token for paginating to the next set of results. |
| prioritize | string | Prioritize results by relevance or popularity. |
| uploadDate | string | Filter results by upload date. |
{
"type": "object",
"required": [
"query"
],
"properties": {
"lang": {
"type": "string",
"description": "Language code for localized content."
},
"query": {
"type": "string",
"example": "autocad",
"description": "The search query."
},
"sortBy": {
"enum": [
"relevance",
"rating",
"upload_date",
"view_count"
],
"type": "string",
"default": "relevance",
"description": "DEPRECATED: The sort order for search results. Please use 'prioritize' and 'uploadDate' instead. Allowed values: relevance, rating, upload_date, view_count."
},
"duration": {
"enum": [
"all",
"over_twenty_mins",
"three_to_twenty_mins",
"under_three_mins"
],
"type": "string",
"default": "all",
"description": "Filter results by video duration."
},
"features": {
"type": "string",
"description": "A comma-separated list of video features to filter by. Allowed values: 360, 3d, 4k, creative_commons, hd, hdr, live, location, purchased, subtitles, vr180."
},
"nextToken": {
"type": "string",
"description": "A token for paginating to the next set of results."
},
"prioritize": {
"enum": [
"relevance",
"popularity"
],
"type": "string",
"default": "relevance",
"description": "Prioritize results by relevance or popularity."
},
"uploadDate": {
"enum": [
"all",
"month",
"week",
"year",
"today"
],
"type": "string",
"default": "all",
"description": "Filter results by upload date."
}
},
"additionalProperties": false
}Retrieves search suggestions from YouTube based on a query. Group: YouTube-Search. Billing per call: 1 Credits.
| Argument | Type | Description |
|---|---|---|
| lang | string | Language code for the suggestions. |
| query* | string | The search query to get suggestions for. |
| previousQuery | string | The previous search query, if any. |
{
"type": "object",
"required": [
"query"
],
"properties": {
"lang": {
"type": "string",
"description": "Language code for the suggestions."
},
"query": {
"type": "string",
"example": "how to c",
"description": "The search query to get suggestions for."
},
"previousQuery": {
"type": "string",
"example": "how",
"description": "The previous search query, if any."
}
},
"additionalProperties": false
}Searches for videos on YouTube. Group: YouTube-Search. Billing per call: 1 Credits.
| Argument | Type | Description |
|---|---|---|
| lang | string | Language code for localized content. |
| query* | string | The search query. |
| sortBy | string | DEPRECATED: The sort order for search results. Please use 'prioritize' and 'uploadDate' instead. Allowed values: relevance, rating, upload_date, view_count. |
| duration | string | Filter results by video duration. |
| features | string | A comma-separated list of video features to filter by. Allowed values: 360, 3d, 4k, creative_commons, hd, hdr, live, location, purchased, subtitles, vr180. |
| nextToken | string | A token for paginating to the next set of results. |
| prioritize | string | Prioritize results by relevance or popularity. |
| uploadDate | string | Filter results by upload date. |
{
"type": "object",
"required": [
"query"
],
"properties": {
"lang": {
"type": "string",
"description": "Language code for localized content."
},
"query": {
"type": "string",
"example": "autocad",
"description": "The search query."
},
"sortBy": {
"enum": [
"relevance",
"rating",
"upload_date",
"view_count"
],
"type": "string",
"default": "relevance",
"description": "DEPRECATED: The sort order for search results. Please use 'prioritize' and 'uploadDate' instead. Allowed values: relevance, rating, upload_date, view_count."
},
"duration": {
"enum": [
"all",
"over_twenty_mins",
"three_to_twenty_mins",
"under_three_mins"
],
"type": "string",
"default": "all",
"description": "Filter results by video duration."
},
"features": {
"type": "string",
"description": "A comma-separated list of video features to filter by. Allowed values: 360, 3d, 4k, creative_commons, hd, hdr, live, location, purchased, subtitles, vr180."
},
"nextToken": {
"type": "string",
"description": "A token for paginating to the next set of results."
},
"prioritize": {
"enum": [
"relevance",
"popularity"
],
"type": "string",
"default": "relevance",
"description": "Prioritize results by relevance or popularity."
},
"uploadDate": {
"enum": [
"all",
"month",
"week",
"year",
"today"
],
"type": "string",
"default": "all",
"description": "Filter results by upload date."
}
},
"additionalProperties": false
}Retrieves comments for a YouTube video with sorting options and pagination. Group: YouTube-Video. Billing per call: 1 Credits.
| Argument | Type | Description |
|---|---|---|
| lang | string | Language code for localized content. |
| sortBy | string | The sort order for comments. Allowed values: TOP_COMMENTS, NEWEST_FIRST. |
| videoId* | string | The ID of the YouTube video. |
| commentId | string | The ID of a specific comment to retrieve replies for. |
| nextToken | string | A token for paginating to the next set of results. |
{
"type": "object",
"required": [
"videoId"
],
"properties": {
"lang": {
"type": "string",
"description": "Language code for localized content."
},
"sortBy": {
"enum": [
"TOP_COMMENTS",
"NEWEST_FIRST"
],
"type": "string",
"default": "TOP_COMMENTS",
"description": "The sort order for comments. Allowed values: TOP_COMMENTS, NEWEST_FIRST."
},
"videoId": {
"type": "string",
"example": "U7_eELfviAE",
"description": "The ID of the YouTube video."
},
"commentId": {
"type": "string",
"description": "The ID of a specific comment to retrieve replies for."
},
"nextToken": {
"type": "string",
"description": "A token for paginating to the next set of results."
}
},
"additionalProperties": false
}Extracts comprehensive information about a YouTube video including metadata, available formats, download links, and server-rendered video options with audio merging capabilities. Group: YouTube-Video. Billing per call: 2 Credits.
| Argument | Type | Description |
|---|---|---|
| lang | string | Language code for localized content (e.g., 'en-US', 'es'). Defaults to 'en-US'. |
| fields | string | A comma-separated list of fields to include in the response. This can be used to limit the amount of data returned. Allowed values: `contents`, `contents.videos`, `contents.audios`, `contents.images`, `contents.renderableVideos`, `contents.renderableAudios`, `metadata`, `metadata.author`, `metadata.comments`, `metadata.playlist`, `metadata.channel`, `metadata.post`, `metadata.hashtag`, `metadata.transcript`, `metadata.additionalData`. For exclusion, prefix the field with a dash; e.g. `-metadata… |
| videoId* | string | The ID of the YouTube video. |
| urlAccess | string | When set to 'proxied', the API uses its own proxies to prevent 403 errors, which can sometimes occur with 'normal' URLs. This comes at the cost of slower download speeds. Allowed values: normal, proxied. When set to 'proxied' the request will be `billed as 2 requests`. Note: If both this parameter and `renderableFormats` are used, the total cost remains 2 requests (charges do not stack). |
| countryCode | string | ISO 3166-1 alpha-2 country code for geo-specific results (e.g., 'US', 'GB'). |
| getTranscript |
| string |
| Set to true to retrieve the video transcript. Allowed values: false, true. |
| renderableFormats | string | A comma-separated list of quality formats to generate server-rendered video links for. If any videos are rendered, this request will be `billed as 2 requests`. Note: If both this parameter and `urlAccess='proxied'` are used, the total cost remains 2 requests (charges do not stack). The number of formats that can be rendered depends on your subscription plan. Allowed values: 144p, 144p60 HDR, 240p, 240p60 HDR, 360p, 360p60 HDR, 480p, 480p60 HDR, 720p, 720p60, 720p60 HDR, 1080p, 1080p60, 1080p60… |
| transcriptLanguage | string | The language to use for the transcript. This must be one of the languages returned in the `metadata.transcript.languages` array. If not provided, the default transcript is returned. |
{
"type": "object",
"required": [
"videoId"
],
"properties": {
"lang": {
"type": "string",
"description": "Language code for localized content (e.g., 'en-US', 'es'). Defaults to 'en-US'."
},
"fields": {
"type": "string",
"description": "A comma-separated list of fields to include in the response. This can be used to limit the amount of data returned. Allowed values: `contents`, `contents.videos`, `contents.audios`, `contents.images`, `contents.renderableVideos`, `contents.renderableAudios`, `metadata`, `metadata.author`, `metadata.comments`, `metadata.playlist`, `metadata.channel`, `metadata.post`, `metadata.hashtag`, `metadata.transcript`, `metadata.additionalData`. For exclusion, prefix the field with a dash; e.g. `-metadata…"
},
"videoId": {
"type": "string",
"example": "dQw4w9WgXcQ",
"description": "The ID of the YouTube video."
},
"urlAccess": {
"enum": [
"proxied",
"normal"
],
"type": "string",
"default": "proxied",
"description": "When set to 'proxied', the API uses its own proxies to prevent 403 errors, which can sometimes occur with 'normal' URLs. This comes at the cost of slower download speeds. Allowed values: normal, proxied. When set to 'proxied' the request will be `billed as 2 requests`. Note: If both this parameter and `renderableFormats` are used, the total cost remains 2 requests (charges do not stack)."
},
"countryCode": {
"type": "string",
"description": "ISO 3166-1 alpha-2 country code for geo-specific results (e.g., 'US', 'GB')."
},
"getTranscript": {
"enum": [
"false",
"true"
],
"type": "string",
"default": "false",
"description": "Set to true to retrieve the video transcript. Allowed values: false, true."
},
"renderableFormats": {
"type": "string",
"example": "720p,highres",
"description": "A comma-separated list of quality formats to generate server-rendered video links for. If any videos are rendered, this request will be `billed as 2 requests`. Note: If both this parameter and `urlAccess='proxied'` are used, the total cost remains 2 requests (charges do not stack). The number of formats that can be rendered depends on your subscription plan. Allowed values: 144p, 144p60 HDR, 240p, 240p60 HDR, 360p, 360p60 HDR, 480p, 480p60 HDR, 720p, 720p60, 720p60 HDR, 1080p, 1080p60, 1080p60…"
},
"transcriptLanguage": {
"type": "string",
"description": "The language to use for the transcript. This must be one of the languages returned in the `metadata.transcript.languages` array. If not provided, the default transcript is returned."
}
},
"additionalProperties": false
}