YouTube General Search (Web V2, V2)

Name: YouTube General Search (Web V2, V2)
Price: 0.003 USD
Availability: InStock
Author: YouTube

https://api.sandbase.ai/v1/api/youtube/web-v2/general-search-v2

Returns YouTube search results matching a query keyword. Supports filtering by content type, upload date, duration, features, and sorting options, with pagination via tokens.

Try this API Get API key

Price: $0.003USD / callFirst 100 calls per day free (shared per organization)
Method: POST
Response: JSON
Parameters: 0 required · 7 optional

Production route

Try the model

Playground

Open playground

Input

Continuation Token

Pagination token (pass from previous response for next page)

Duration

Video duration filter - short(<4min)/medium(4-20min)/long(>20min)

Features

Feature filter (comma separated) - live/4k/hd/subtitles/creative_commons/360/vr180/3d/hdr

Keyword

Search keyword (required for first request)

Sort By

Sort by - relevance/upload_date/view_count/rating

Type

Result type filter - video/channel/playlist/movie

Upload Date

Upload date filter - last_hour/today/this_week/this_month/this_year

OutputExample

Responseoutputs · 21.6 KB · 469 lines

[
  {
    "data": {
      "channels": [],
      "completion_suggestions": [],
      "continuation_token": "EqEDEhBkZWVwc2VlayBoYXJuZXNzGowDQ0FBU0FoQUJTQlNDQVF0T1VFOHlRM2RJYm1adFNZSUJDM0ZuT1VWNVIwOWFaRGxWZ2dFTGRXRm5YMlp1UjNsb01UQ0NBUXRCY1c0M1JWQTRjMmhLZDRJQkN6VkhYMkZtYjFSQ01XZHpnZ0VMZVdsWVUwczNWM1pUZGpDQ0FRdHFXVVJXY2kxTE5raFpNSUlCQzA0NVJUQnZZMVZWV0RRNGdnRUxXV3R1TTJGUmFUZDROMi1DQVF0aU4ydHJOelk0U2tWM2M0SUJDM2QyWVZkblJuY3Rlamc0Z2dFTGVHVXRZVWhLVEVNMVZWV0NBUXRNYkhZeFYwbEhlV1ZuT0lJQkMzbDZVMGhuVkZCb2REWmpnZ0VMYXpKb2FURTJlVFkzU20tQ0FRdE5RMnh4ZVVsRWNHaGlZNElCQzBkYWMxVk1UWEV4V1RsRmdnRUxOblUxZDJGb01FSndRa1dDQVF0cE1XTXlhRUpxT0RCcFFZSUJDMWxCZFRSa05EWnViWHBOc2dFR0NnUUlGQkFDGIHg6BgiC3NlYXJjaC1mZWVk",
      "keyword": "deepseek harness",
      "playlists": [],
      "shorts": [],
      "videos": [
        {
          "author": "Prompt Engineering",
          "channel_id": "UCDq7SjbgRKty5TgGafW8Clg",
          "description_snippet": "DeepSeek V4 Pro (GA) is here along with the DeepSeek Harness (this is the important one!): https://deepseek.com/harness/en/ ...",
          "duration": "12:42",
          "published_time": "1 day ago",
          "thumbnails": [
            {
              "height": 202,
              "url": "https://i.ytimg.com/vi/NPO2CwHnfmI/hq720.jpg?sqp=-oaymwEjCOgCEMoBSFryq4qpAxUIARUAAAAAGAElAADIQj0AgKJDeAE=&rs=AOn4CLB2XOOWgUKHMZ6JxVIKEjCTg0BHfw",
              "width": 360
            },
            {
              "height": 404,
              "url": "https://i.ytimg.com/vi/NPO2CwHnfmI/hq720.jpg?sqp=-oaymwEXCNAFEJQDSFryq4qpAwkIARUAAIhCGAE=&rs=AOn4CLC0K2btZkYY3HaBqZ4RMHzmFS7tZg",
              "width": 720
            }
          ],
          "title": "DeepSeek Harness - Its a Big Deal!",
          "url": "https://www.youtube.com/watch?v=NPO2CwHnfmI",
          "video_id": "NPO2CwHnfmI",
          "view_count": "22,082 views"
        },
        {
          "author": "NeuralNine",
          "channel_id": "UC8wZnXYK_CGKlBcZp-GxYPA",
          "description_snippet": "Need some help with a project or some consulting? Contact me here: https://www.neuralnine.com/services The Python Bible ...",
          "duration": "13:32",
          "published_time": "1 day ago",
          "thumbnails": [
            {
              "height": 202,
              "url": "https://i.ytimg.com/vi/qg9EyGOZd9U/hq720.jpg?sqp=-oaymwEjCOgCEMoBSFryq4qpAxUIARUAAAAAGAElAADIQj0AgKJDeAE=&rs=AOn4CLCIEYH7L_5qcK-G_KNDnZ-hJNYsbA",
              "width": 360
            },
            {
              "height": 404,
              "url": "https://i.ytimg.com/vi/qg9EyGOZd9U/hq720.jpg?sqp=-oaymwEXCNAFEJQDSFryq4qpAwkIARUAAIhCGAE=&rs=AOn4CLBu2Ebu9Lrx1JM3OG0PFzRGmrPiDg",
              "width": 720
            }
          ],
          "title": "DeepSeek Harness: The End of Claude Code?",
          "url": "https://www.youtube.com/watch?v=qg9EyGOZd9U",
          "video_id": "qg9EyGOZd9U",
          "view_count": "51,704 views"
        },
        {
          "author": "Julian Goldie SEO",
          "channel_id": "UCGpsgNbzdF7BECCVbB1COHw",
          "description_snippet": "Get the Agent OS & DeepSeek Harness Masterclass https://www.skool.com/ai-profit-lab-7462/about Want to make money and ...",
          "duration": "12:23",
          "published_time": "11 hours ago",
          "thumbnails": [
            {
              "height": 202,
              "url": "https://i.ytimg.com/vi/uag_fnGyh10/hq720_custom_1.jpg?sqp=CNDFgdQG-oaymwEjCOgCEMoBSFryq4qpAxUIARUAAAAAGAElAADIQj0AgKJDeAE=&rs=AOn4CLBYL4uXeMQKzlJyTc8cw-vJPUevZg",
              "width": 360
            },
            {
              "height": 404,
              "url": "https://i.ytimg.com/vi/uag_fnGyh10/hq720_custom_1.jpg?sqp=CNDFgdQG-oaymwEXCNAFEJQDSFryq4qpAwkIARUAAIhCGAE=&rs=AOn4CLBN6N1LphgnTfaI8BmSWFE5Gu-_wQ",
              "width": 720
            }
          ],
          "title": "DeepSeek's New AI Harness Changes Everything",
          "url": "https://www.youtube.com/watch?v=uag_fnGyh10",
          "video_id": "uag_fnGyh10",
          "view_count": "7,587 views"
        },
        {
          "author": "AI超元域",
          "channel_id": "UCIomFkAj4Vq_rGX2Jot7D8A",
          "description_snippet": "视频简介： ✓DeepSeek突然开源Harness！一切皆插件+Web UI+多模型，我实测后发现它真可能挑战Claude Code和Codex ...",
          "duration": "12:54",
          "published_time": "1 day ago",
          "thumbnails": [
            {
              "height": 202,
              "url": "https://i.ytimg.com/vi/Aqn7EP8shJw/hq720.jpg?sqp=-oaymwEjCOgCEMoBSFryq4qpAxUIARUAAAAAGAElAADIQj0AgKJDeAE=&rs=AOn4CLDJNTHNgg6d_Kn1HCKEwu5iPZIWJA",
              "width": 360
            },
            {
              "height": 404,
              "url": "https://i.ytimg.com/vi/Aqn7EP8shJw/hq720.jpg?sqp=-oaymwEXCNAFEJQDSFryq4qpAwkIARUAAIhCGAE=&rs=AOn4CLCXLTuqp8gpOMIEmokULxkkkT525w",
              "width": 720
            }
          ],
          "title": "🚀实测DeepSeek Harness从基础到高级用法！WebUI远程控制、多模型接入、执行轨迹、插件系统、任务分支、游戏开发、代码仓库issues和pr分析！竟然比Claude Code更强？",
          "url": "https://www.youtube.com/watch?v=Aqn7EP8shJw",
          "video_id": "Aqn7EP8shJw",
          "view_count": "21,452 views"
        },
        {
          "author": "零度解说",
          "channel_id": "UCvijahEyGtvMpmMHBu4FS2w",
          "description_snippet": "【更多资源】▷https://bittly.cc/lingdu 【零度博客】▷https://www.freedidi.com 【会员提问】▷https://vip.freedidi.com ...",
          "duration": "12:12",
          "published_time": "1 day ago",
          "thumbnails": [
            {
              "height": 202,
              "url": "https://i.ytimg.com/vi/5G_afoTB1gs/hq720.jpg?sqp=-oaymwEjCOgCEMoBSFryq4qpAxUIARUAAAAAGAElAADIQj0AgKJDeAE=&rs=AOn4CLCLxtWUxXMzow3jsL3T2x2AFUvAJA",
              "width": 360
            },
            {
              "height": 404,
              "url": "https://i.ytimg.com/vi/5G_afoTB1gs/hq720.jpg?sqp=-oaymwEXCNAFEJQDSFryq4qpAwkIARUAAIhCGAE=&rs=AOn4CLAK7LGTKS2PU582TFcMGdYYaPDhpA",
              "width": 720
            }
          ],
          "title": "DeepSeek Harness 正式发布！ 开源一天狂揽 6.8 万星！V4 Pro 模型低调上线，AI Agent 部署与实测 | 零度解说",
          "url": "https://www.youtube.com/watch?v=5G_afoTB1gs",
          "video_id": "5G_afoTB1gs",
          "view_count": "43,730 views"
        },
        {
          "author": "Tech2WiLD",
          "channel_id": "UCOJIGngtr4zcPuuZX6dO8aQ",
          "description_snippet": "Download Harness Here. -https://github.com/deepseek-ai/deepseek-harness Here My Deepseek Harness Complete Tool Kit ...",
          "duration": "11:43",
          "published_time": "1 day ago",
          "thumbnails": [
            {
              "height": 202,
              "url": "https://i.ytimg.com/vi/yiXSK7WvSv0/hq720.jpg?sqp=-oaymwEjCOgCEMoBSFryq4qpAxUIARUAAAAAGAElAADIQj0AgKJDeAE=&rs=AOn4CLA08LMUP3kxPfMT6HTV2TebdOGmdg",
              "width": 360
            },
            {
              "height": 404,
              "url": "https://i.ytimg.com/vi/yiXSK7WvSv0/hq720.jpg?sqp=-oaymwEXCNAFEJQDSFryq4qpAwkIARUAAIhCGAE=&rs=AOn4CLDqIROqI7OM1VNNwvAs4lGW8hAxgg",
              "width": 720
            }
          ],
          "title": "DeepSeek Just Dropped Its Own Harness… And It’s FAST! | LOCAL ChatGPT",
          "url": "https://www.youtube.com/watch?v=yiXSK7WvSv0",
          "video_id": "yiXSK7WvSv0",
          "view_count": "5,368 views"
        },
        {
          "author": "Morgans Code",
          "channel_id": "UCetGP9xk9LYIxzYO9Id3o6g",
          "description_snippet": "DeepSeek Harness is DeepSeek's new MIT-licensed open-source coding agent — and it could become one of the most important ...",
          "duration": "9:53",
          "published_time": "13 hours ago",
          "thumbnails": [
            {
              "height": 202,
              "url": "https://i.ytimg.com/vi/jYDVr-K6HY0/hq720.jpg?sqp=-oaymwEjCOgCEMoBSFryq4qpAxUIARUAAAAAGAElAADIQj0AgKJDeAE=&rs=AOn4CLDsgb229aHtWbyvkBlzCwmMUgN00Q",
              "width": 360
            },
            {
              "height": 404,
              "url": "https://i.ytimg.com/vi/jYDVr-K6HY0/hq720.jpg?sqp=-oaymwEXCNAFEJQDSFryq4qpAwkIARUAAIhCGAE=&rs=AOn4CLB3ciF60aK9gDo2hQnRU14PrgLApw",
              "width": 720
            }
          ],
          "title": "The Black Whale Is Coming for Claude Code — DeepSeek Harness",
          "url": "https://www.youtube.com/watch?v=jYDVr-K6HY0",
          "video_id": "jYDVr-K6HY0",
          "view_count": "567 views"
        },
        {
          "author": "Kasra Dash",
          "channel_id": "UCG9dtL6WtTNYf12Iwv3zKAA",
          "description_snippet": "Get RankOS and the full AI search system https://www.skool.com/the-new-search/about More SEO frameworks and ...",
          "duration": "5:51",
          "published_time": "1 hour ago",
          "thumbnails": [
            {
              "height": 202,
              "url": "https://i.ytimg.com/vi/N9E0ocUUX48/hq720_custom_2.jpg?sqp=CNDFgdQG-oaymwEjCOgCEMoBSFryq4qpAxUIARUAAAAAGAElAADIQj0AgKJDeAE=&rs=AOn4CLBWBReiAnXliscY1oyH48dlHBsDlw",
              "width": 360
            },
            {
              "height": 404,
              "url": "https://i.ytimg.com/vi/N9E0ocUUX48/hq720_custom_2.jpg?sqp=CNDFgdQG-oaymwEXCNAFEJQDSFryq4qpAwkIARUAAIhCGAE=&rs=AOn4CLAe9WRYk8h14Qa_tHmSPETEjhF17w",
              "width": 720
            }
          ],
          "title": "DeepSeek Harness vs Claude Code: Which Wins?",
          "url": "https://www.youtube.com/watch?v=N9E0ocUUX48",
          "video_id": "N9E0ocUUX48",
          "view_count": "22 views"
        },
        {
          "author": "01Coder",
          "channel_id": "UCAVDRj14A9W2Zix1Y5EUm7Q",
          "description_snippet": "如果您想支持我的视频创作，可以考虑加入“SmallWoods” 油管会员，会员福利如下： - 忠实粉丝徽章- 表情符号- 会员贴和状态更新- ...",
          "duration": "7:00",
          "published_time": "22 hours ago",
          "thumbnails": [
            {
              "height": 202,
              "url": "https://i.ytimg.com/vi/Ykn3aQi7x7o/hq720.jpg?sqp=-oaymwEjCOgCEMoBSFryq4qpAxUIARUAAAAAGAElAADIQj0AgKJDeAE=&rs=AOn4CLDKNy9jJN8hymwoxwWwZl1ym7_cMQ",
              "width": 360
            },
            {
              "height": 404,
              "url": "https://i.ytimg.com/vi/Ykn3aQi7x7o/hq720.jpg?sqp=-oaymwEXCNAFEJQDSFryq4qpAwkIARUAAIhCGAE=&rs=AOn4CLAOo7AjEDC8dy-stMCaxprn5z6iGA",
              "width": 720
            }
          ],
          "title": "DeepSeek Harness 快速上手：本地安装与运行",
          "url": "https://www.youtube.com/watch?v=Ykn3aQi7x7o",
          "video_id": "Ykn3aQi7x7o",
          "view_count": "2,603 views"
        },
        {
          "author": "Ray Codes",
          "channel_id": "UCKm_g9j2tjtizrxrhMSVAww",
          "description_snippet": "This DeepSeek Harness GitHub tutorial reveals how to run the new open-source DeepSeek Harness agent locally with zero token ...",
          "duration": "9:09",
          "published_time": "1 day ago",
          "thumbnails": [
            {
              "height": 202,
              "url": "https://i.ytimg.com/vi/b7kk768JEws/hq720_custom_2.jpg?sqp=CNDFgdQG-oaymwEjCOgCEMoBSFryq4qpAxUIARUAAAAAGAElAADIQj0AgKJDeAE=&rs=AOn4CLBn7x_6BJt6_X37AwRqigryl4jfwQ",
              "width": 360
            },
            {
              "height": 404,
              "url": "https://i.ytimg.com/vi/b7kk768JEws/hq720_custom_2.jpg?sqp=CNDFgdQG-oaymwEXCNAFEJQDSFryq4qpAwkIARUAAIhCGAE=&rs=AOn4CLAx-p2r6RJsRTapJPjbqkmkYcgthg",
              "width": 720
            }
          ],
          "title": "DeepSeek Harness with Local Ollama: Complete Free Setup Guide",
          "url": "https://www.youtube.com/watch?v=b7kk768JEws",
          "video_id": "b7kk768JEws",
          "view_count": "1,602 views"
        },
        {
          "author": "Income stream surfers",
          "channel_id": "UCctL30i8tVgSS9A37Q532eg",
          "description_snippet": "DeepSeek just released their own coding agent — the DeepSeek Harness — and I gave it a full website to build. It cost me 10 ...",
          "duration": "8:38",
          "published_time": "1 day ago",
          "thumbnails": [
            {
              "height": 202,
              "url": "https://i.ytimg.com/vi/wvaWgFw-z88/hq720_custom_2.jpg?sqp=CNDFgdQG-oaymwEjCOgCEMoBSFryq4qpAxUIARUAAAAAGAElAADIQj0AgKJDeAE=&rs=AOn4CLAdWy06n7XheVgNMw6NTk40d-PusA",
              "width": 360
            },
            {
              "height": 404,
              "url": "https://i.ytimg.com/vi/wvaWgFw-z88/hq720_custom_2.jpg?sqp=CNDFgdQG-oaymwEXCNAFEJQDSFryq4qpAwkIARUAAIhCGAE=&rs=AOn4CLBof6bVpxWKDlZuGKl-jVyUWX3e_g",
              "width": 720
            }
          ],
          "title": "DeepSeek Harness + V4 Flash = The END of Claude Code?",
          "url": "https://www.youtube.com/watch?v=wvaWgFw-z88",
          "video_id": "wvaWgFw-z88",
          "view_count": "2,378 views"
        },
        {
          "author": "DevsKingdom",
          "channel_id": "UC8LbCdO57DhJsCmhUeL-DZA",
          "description_snippet": "DeepSeek Harness (dsh) is an open-source agent harness, It uses an architecture where everything is a plugin, and is powered ...",
          "duration": "12:21",
          "published_time": "1 day ago",
          "thumbnails": [
            {
              "height": 202,
              "url": "https://i.ytimg.com/vi/xe-aHJLC5UU/hq720.jpg?sqp=-oaymwEjCOgCEMoBSFryq4qpAxUIARUAAAAAGAElAADIQj0AgKJDeAE=&rs=AOn4CLCozNGHjGhq9iQIyIX4vu1S-QKB0Q",
              "width": 360
            },
            {
              "height": 404,
              "url": "https://i.ytimg.com/vi/xe-aHJLC5UU/hq720.jpg?sqp=-oaymwEXCNAFEJQDSFryq4qpAwkIARUAAIhCGAE=&rs=AOn4CLCkSgaE7Lo6Nfcc_iEbXFZd_P-82w",
              "width": 720
            }
          ],
          "title": "Deepseek Harness: Everything is a plugin",
          "url": "https://www.youtube.com/watch?v=xe-aHJLC5UU",
          "video_id": "xe-aHJLC5UU",
          "view_count": "5,230 views"
        },
        {
          "author": "Cloud Codes",
          "channel_id": "UC0DZj1PNa_Fp0MU6uPSKv5w",
          "description_snippet": "Why did DeepSeek raise API prices by up to 1114% while open-sourcing its internal agent harness under MIT on the exact same ...",
          "duration": "13:19",
          "published_time": "1 day ago",
          "thumbnails": [
            {
              "height": 202,
              "url": "https://i.ytimg.com/vi/Llv1WIGyeg8/hq720.jpg?sqp=-oaymwEjCOgCEMoBSFryq4qpAxUIARUAAAAAGAElAADIQj0AgKJDeAE=&rs=AOn4CLDOTp123MTRm7fBhUyC_CmuMzj6Mg",
              "width": 360
            },
            {
              "height": 404,

Examples

Select an example to load its inputs and result into the playground.

Model card

Specifications

Pricing

Base price: $0.003 / run
Daily free calls: First 100 calls per day free (shared per organization)

Request & response

Method: POST
Request body: application/json
Response: application/json
Execution: sync

Parameters

continuation_token: any · optional
duration: any · optional
features: any · optional
keyword: any · optional
sort_by: any · optional
type: any · optional
upload_date: any · optional

Access

Provider: YouTube
API: Platform API
Base URL: https://api.sandbase.ai
Endpoint: /v1/api/youtube/web-v2/general-search-v2
Authentication: Bearer API key

API README

YouTube General Search (Web V2, V2) API

Search YouTube items by providing a keyword query. Pass continuation_token from previous responses to paginate through additional results.

Use cases

Find YouTube videos, channels, or playlists matching specific search terms.
Filter video search results by duration, definition, or upload date.
Sort YouTube content by view count, rating, or upload date.

Request

curl -X POST "https://api.sandbase.ai/v1/api/youtube/web-v2/general-search-v2" \
  -H "Authorization: Bearer $SANDBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

Parameters

Name	Type	Required	Description
`type`	string	No	Result type filter - video/channel/playlist/movie
`keyword`	string	No	Search keyword (required for first request)
`sort_by`	string	No	Sort by - relevance/upload_date/view_count/rating
`duration`	string	No	Video duration filter - short(<4min)/medium(4-20min)/long(>20min)
`features`	string	No	Feature filter (comma separated) - live/4k/hd/subtitles/creative_commons/360/vr180/3d/hdr
`upload_date`	string	No	Upload date filter - last_hour/today/this_week/this_month/this_year
`continuation_token`	string	No	Pagination token (pass from previous response for next page)

Notes

keyword is required for the initial search request.
Use continuation_token from the previous response to retrieve the next page of results.
Filter by type for videos, channels, playlists, or movies, and combine with features such as 4k, hd, or subtitles.

Related APIs

YouTube Channel Community Posts: Returns community posts from a specific YouTube channel, including text content, polls, votes, and comment counts.
YouTube Channel Description: Returns YouTube channel details including subscriber counts, video totals, view counts, joined date, and social links.
YouTube Channel ID from URL: Resolves a YouTube channel URL to its canonical channel ID.

Start building

Send your first request

Platform API endpoint with unified authentication and usage tracking.

Production API

Platform API endpoint

https://api.sandbase.ai/v1/api/youtube/web-v2/general-search-v2

Authorization header

Authorization: Bearer $SANDBASE_API_KEY

# The quoted heredoc keeps Unicode and shell metacharacters unchanged.
result=$(curl --fail-with-body --silent \
  -X POST "https://api.sandbase.ai/v1/api/youtube/web-v2/general-search-v2" \
  -H "Authorization: Bearer $SANDBASE_API_KEY" \
  -H "Content-Type: application/json" \
  --data-binary @- <<'SANDBASE_JSON'
{
  "keyword": "deepseek harness",
  "sort_by": "relevance",
  "type": "video"
}
SANDBASE_JSON
)
printf '%s\n' "$result"

Explore more

Related APIs

All APIs

API	Price	Response	Released
YouTube General Search (Web V2, V2)This API `YouTube`	$0.003 per call	JSON	Jul 31, 2026
YouTube Channel Community Posts `YouTube`	$0.0015 per call	JSON	Jul 31, 2026
YouTube Channel Description `YouTube`	$0.0015 per call	JSON	Jul 31, 2026
YouTube Channel ID from URL `YouTube`	$0.0015 per call	JSON	Jul 31, 2026
YouTube Channel Shorts `YouTube`	$0.0015 per call	JSON	Jul 31, 2026
YouTube Channel URL by ID `YouTube`	$0.0015 per call	JSON	Jul 31, 2026

Questions

FAQ

How do I use the YouTube General Search (Web V2, V2) API?

Send a POST request to https://api.sandbase.ai/v1/api/youtube/web-v2/general-search-v2 with your SandBase API key in the Authorization header (Bearer) and the parameters as a JSON body. You can also try it in the Playground on this page without writing code.

How much does the YouTube General Search (Web V2, V2) API cost?

$0.003 per call. Every organization gets 100 free calls per UTC day, shared across eligible SandBase APIs including this one; after that each call is billed at this price from your SandBase balance. There is no subscription.

What parameters does the YouTube General Search (Web V2, V2) API accept?

No parameters are required. Optional: continuation_token (any), duration (any), features (any), keyword (any), sort_by (any) and type (any) and 1 more. The Parameters table and the Playground on this page list every field.

What does the YouTube General Search (Web V2, V2) API return?

A JSON response returned in the same HTTP request (synchronous).

Do I need a YouTube developer account or API key?

No. YouTube General Search (Web V2, V2) runs through SandBase, so one SandBase API key covers this endpoint and every other API and model in the catalog. You do not need to apply for YouTube API access separately.