YouTube Video Search

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

Search YouTube videos by keyword and get video ID, title, channel, views, length and publish time, with country, language and upload-date filters and continuation-token pagination.

Price
$0.0015USD / callFirst 100 calls per day free (shared per organization)
Method
POST
Response
JSON
Parameters
1 required · 4 optional
Production route

Try the model

Playground

Open playground
Input
Token to continue fetching search results. Default is None.
Country code, default is us.
Language code, default is en.
Order by, default is this_month, optional values are this_week, this_month, this_year, last_hour, today.
Search keyword.
OutputExample
Responseoutputs · 23.7 KB · 535 lines
[
  {
    "data": {
      "continuation_token": "EpsFEglBSSBhZ2VudHMajANFZ1FJQkJBQlNCU0NBUXRrY2xONWRHbEpaVFpLWjRJQkMxUk1PRlkwTVVWaE5tOU5nZ0VMUW0wNE5FSkJkRTltVVhlQ0FRdEZlbEZCWjI1cVZIRXlhNElCQ3pWd0xYTnhPSFl6VDFoM2dnRUxXblpFYTBwelMwVTRNR3VDQVF0TlRrNW1ZWFJmVVZBd1JZSUJDelpaYmt4Q01GaGlWRzVKZ2dFTGJqZEhiRFJNT1hCZmJtLUNBUXQyU2tWNU0yNVFNbDlET0lJQkMxRlVZMXBRU1Mxbk4ybHpnZ0VMU0ZGWWFUUnpibEF6TmttQ0FRczFYMDQ0TkhReGNsVlZNSUlCQzFGNE1HWkRjWEJyUW5WemdnRUxNRU0yZUZsMlVXaHFkMUdDQVF0eFdVNXpPREJHUzBsV1k0SUJDMnhsY3pKNFJuWlpOVlkwZ2dFTE1YcFhObFYxTWpGUk5EQ0NBUXRRZGtkeU4zUnRNRWhsYzRJQkMwZDNYMmh1UkRkdE1EQk5zZ0VHQ2dRSUZCQUOSAv0BL3NlYXJjaD9vcT1BSSBhZ2VudHMmZ3NfbD15b3V0dWJlLjMuLjBpNDMzaTEzMWsxajBpNTEyaTQzM2kxMzFrMWwyajBpNDMzaTEzMWsxajBpNTEyaTQzM2kxMzFrMWowaTQzM2kxMzFrMWwyajBpNTEyaTQzM2sxbDRqMGk1MTJrMWowaTUxMmk0MzNpMTMxazFsMi4xNTA2OC4xNTU5OC4wLjE2NDI5LjcuNy4wLjAuMC4wLjYyOC44NDUuMi0xajUtMS41LjAuLi4uMC4uLjFhYy4xLjY0LnlvdXR1YmUuLjIuMi44NDUuMC4uLjc2NS5TYkdUbGlSNkZOYxiB4OgYIgtzZWFyY2gtZmVlZA%3D%3D",
      "country": "US",
      "estimated_results": 1228716,
      "lang": "en",
      "number_of_videos": 20,
      "query": "AI agents",
      "timezone": "America/New_York",
      "videos": [
        {
          "author": "Jake One Page",
          "category": null,
          "channel_id": "UCyNtWXc9TcDYnDkFj-OTwyg",
          "description": "Claim your FREE $499 Masterclass: Build & Sell Apps, AI Agents & Websites with AI https://mikeyno-code.com/Skool-base44 ...",
          "is_live_content": null,
          "keywords": [],
          "number_of_views": 4532,
          "published_time": "12 hours ago",
          "thumbnails": [
            {
              "height": 202,
              "url": "https://i.ytimg.com/vi/drSytiIe6Jg/hq720.jpg?sqp=-oaymwEgCOgCEMoBSFXyq4qpAxIIARUAAIhCGAFwAcABBrgC8xg=&rs=AOn4CLCJT2vUgFOF89IEpK7utza4oAO-Qw",
              "width": 360
            },
            {
              "height": 404,
              "url": "https://i.ytimg.com/vi/drSytiIe6Jg/hq720.jpg?sqp=-oaymwEgCNAFEJQDSFXyq4qpAxIIARUAAIhCGAFwAcABBrgC8xg=&rs=AOn4CLBTmIo89x5xD5WVAEGsRtWEWbiE6g",
              "width": 720
            }
          ],
          "title": "The 6 Claude AI Agents to Get You Ahead of 99% of People",
          "type": "NORMAL",
          "video_id": "drSytiIe6Jg",
          "video_length": "40:37"
        },
        {
          "author": "Sandeep Swadia",
          "category": null,
          "channel_id": "UC4ZVkG3RQPzvZk7alIVjcCg",
          "description": "Join my free newsletter: https://sandeepswadia.beehiiv.com/ Take us on your morning run or commute, follow us on Spotify: ...",
          "is_live_content": null,
          "keywords": [],
          "number_of_views": 676977,
          "published_time": "2 weeks ago",
          "thumbnails": [
            {
              "height": 202,
              "url": "https://i.ytimg.com/vi/TL8V41Ea6oM/hq720.jpg?sqp=-oaymwEgCOgCEMoBSFXyq4qpAxIIARUAAIhCGAFwAcABBrgC8xg=&rs=AOn4CLDnbcj85JpzOWNho3jln9Ny2swnTg",
              "width": 360
            },
            {
              "height": 404,
              "url": "https://i.ytimg.com/vi/TL8V41Ea6oM/hq720.jpg?sqp=-oaymwEgCNAFEJQDSFXyq4qpAxIIARUAAIhCGAFwAcABBrgC8xg=&rs=AOn4CLDdsq1yD_GsWFVG_3O3vX7Xmnugvg",
              "width": 720
            }
          ],
          "title": "4 AI Agents To Automate 99% Of Your Life",
          "type": "NORMAL",
          "video_id": "TL8V41Ea6oM",
          "video_length": "20:47"
        },
        {
          "author": "Dan Martell",
          "category": null,
          "channel_id": "UCA-mWX9CvCTVFWRMb9bKc9w",
          "description": "Get Your FREE AI Company Operating System here: https://go.danmartell.com/3SXCfgk Are you building an AI software ...",
          "is_live_content": null,
          "keywords": [],
          "number_of_views": 332053,
          "published_time": "4 weeks ago",
          "thumbnails": [
            {
              "height": 202,
              "url": "https://i.ytimg.com/vi/Bm84BAtOfQw/hq720.jpg?sqp=-oaymwEgCOgCEMoBSFXyq4qpAxIIARUAAIhCGAFwAcABBrgC8xg=&rs=AOn4CLAyqa09AO7JqxVrlhAvyH4UHYbfJQ",
              "width": 360
            },
            {
              "height": 404,
              "url": "https://i.ytimg.com/vi/Bm84BAtOfQw/hq720.jpg?sqp=-oaymwEgCNAFEJQDSFXyq4qpAxIIARUAAIhCGAFwAcABBrgC8xg=&rs=AOn4CLB4GmM2ueLj9-ZKhotvmrdcXJbtzw",
              "width": 720
            }
          ],
          "title": "You’re Not Behind (Yet): How to Build Your First AI Agent (Full Guide)",
          "type": "NORMAL",
          "video_id": "Bm84BAtOfQw",
          "video_length": "22:25"
        },
        {
          "author": "Greg Isenberg and Allie K Miller",
          "category": null,
          "channel_id": "UCPjNBjflYl0-HQtUvOx0Ibw",
          "description": "I sit down with Allie K. Miller to talk about the shift from managing AI agents to enabling them. Allie runs a workforce of 34 AI ...",
          "is_live_content": null,
          "keywords": [],
          "number_of_views": 34530,
          "published_time": "2 days ago",
          "thumbnails": [
            {
              "height": 202,
              "url": "https://i.ytimg.com/vi/EzQAgnjTq2k/hq720.jpg?sqp=-oaymwEgCOgCEMoBSFXyq4qpAxIIARUAAIhCGAFwAcABBrgC8xg=&rs=AOn4CLAajyxKWUqgBbRndLtdXBN_DLkXdg",
              "width": 360
            },
            {
              "height": 404,
              "url": "https://i.ytimg.com/vi/EzQAgnjTq2k/hq720.jpg?sqp=-oaymwEgCNAFEJQDSFXyq4qpAxIIARUAAIhCGAFwAcABBrgC8xg=&rs=AOn4CLCPr_hOOk5GcOBxxHPFSjfDBCr6OA",
              "width": 720
            }
          ],
          "title": "My top secrets to running an AI Agent Workforce",
          "type": "NORMAL",
          "video_id": "EzQAgnjTq2k",
          "video_length": "48:28"
        },
        {
          "author": "Open Residency and AI with Remy",
          "category": null,
          "channel_id": "UC3P7JC2BIQHpUvdhxFHmnsg",
          "description": "Remy is giving you The AI Agent OS Playbook, everything from this episode in one free PDF ...",
          "is_live_content": null,
          "keywords": [],
          "number_of_views": 367439,
          "published_time": "3 weeks ago",
          "thumbnails": [
            {
              "height": 202,
              "url": "https://i.ytimg.com/vi/5p-sq8v3OXw/hq720.jpg?sqp=-oaymwEgCOgCEMoBSFXyq4qpAxIIARUAAIhCGAFwAcABBrgC8xg=&rs=AOn4CLDFtCaGQf1zbPB44MZPEzdOQ8EpRQ",
              "width": 360
            },
            {
              "height": 404,
              "url": "https://i.ytimg.com/vi/5p-sq8v3OXw/hq720.jpg?sqp=-oaymwEgCNAFEJQDSFXyq4qpAxIIARUAAIhCGAFwAcABBrgC8xg=&rs=AOn4CLDBt1mEj7GjCCK1v3DGSlIAMDMaKw",
              "width": 720
            }
          ],
          "title": "AI Agents: The Most Valuable Skill You Can Learn in 2026 (Full Course)",
          "type": "NORMAL",
          "video_id": "5p-sq8v3OXw",
          "video_length": "2:24:11"
        },
        {
          "author": "Tech With Tim",
          "category": null,
          "channel_id": "UC4JX40jDee_tINbkjycV4Sg",
          "description": "Best courses to learn all about AI agents and AI engineering: DataCamp's Associate AI Engineer for Developers Track ...",
          "is_live_content": null,
          "keywords": [],
          "number_of_views": 118477,
          "published_time": "4 weeks ago",
          "thumbnails": [
            {
              "height": 202,
              "url": "https://i.ytimg.com/vi/ZvDkJsKE80k/hq720.jpg?sqp=-oaymwEgCOgCEMoBSFXyq4qpAxIIARUAAIhCGAFwAcABBrgC8xg=&rs=AOn4CLBxdsPs9rxxkecErm2DU3KdaCAuNw",
              "width": 360
            },
            {
              "height": 404,
              "url": "https://i.ytimg.com/vi/ZvDkJsKE80k/hq720.jpg?sqp=-oaymwEgCNAFEJQDSFXyq4qpAxIIARUAAIhCGAFwAcABBrgC8xg=&rs=AOn4CLCuugNnEyXSSSflm9YAJlv9EBVoqg",
              "width": 720
            }
          ],
          "title": "AI Agents Explained - What Is an AI Agent and how to build one? (Real Examples, Not Hype)",
          "type": "NORMAL",
          "video_id": "ZvDkJsKE80k",
          "video_length": "21:34"
        },
        {
          "author": "Greg Isenberg",
          "category": null,
          "channel_id": "UCPjNBjflYl0-HQtUvOx0Ibw",
          "description": "In this solo episode I break down Cloudflare's AI agent announcement in plain English and explain why I see it as the new ...",
          "is_live_content": null,
          "keywords": [],
          "number_of_views": 194187,
          "published_time": "4 days ago",
          "thumbnails": [
            {
              "height": 202,
              "url": "https://i.ytimg.com/vi/MNNfat_QP0E/hq720.jpg?sqp=-oaymwEgCOgCEMoBSFXyq4qpAxIIARUAAIhCGAFwAcABBrgC8xg=&rs=AOn4CLDqIBMnED_CuvJ9nnPya_VUzZspXw",
              "width": 360
            },
            {
              "height": 404,
              "url": "https://i.ytimg.com/vi/MNNfat_QP0E/hq720.jpg?sqp=-oaymwEgCNAFEJQDSFXyq4qpAxIIARUAAIhCGAFwAcABBrgC8xg=&rs=AOn4CLBY5RMOLUQefuGt1elNemRp5fa6OQ",
              "width": 720
            }
          ],
          "title": "Cloudflare will make 1000+ AI millionaires",
          "type": "NORMAL",
          "video_id": "MNNfat_QP0E",
          "video_length": "34:10"
        },
        {
          "author": "Stanford Online",
          "category": null,
          "channel_id": "UCBa5G_ESCn8Yd4vw5U-gIcg",
          "description": "Want to dive deeper? This curriculum is covered in the following online courses: - Agentic AI professional education program: ...",
          "is_live_content": null,
          "keywords": [],
          "number_of_views": 246663,
          "published_time": "11 days ago",
          "thumbnails": [
            {
              "height": 202,
              "url": "https://i.ytimg.com/vi/6YnLB0XbTnI/hq720.jpg?sqp=-oaymwE6COgCEMoBSFXyq4qpAywIARUAAIhCGAFwAcABBvABAfgB_gmAAtAFigIMCAAQARhlIGUoZTAPuALzGA==&rs=AOn4CLC2PvIuzO5TPmnhOi5IhCAx4fYabg",
              "width": 360
            },
            {
              "height": 404,
              "url": "https://i.ytimg.com/vi/6YnLB0XbTnI/hq720.jpg?sqp=-oaymwE6CNAFEJQDSFXyq4qpAywIARUAAIhCGAFwAcABBvABAfgB_gmAAtAFigIMCAAQARhlIGUoZTAPuALzGA==&rs=AOn4CLDQyTU2QsvD_mTGICzRuQjpzR2nfA",
              "width": 720
            }
          ],
          "title": "Stanford CS329A Self-Improving AI Agents | Part 1 | Course Overview",
          "type": "NORMAL",
          "video_id": "6YnLB0XbTnI",
          "video_length": "1:09:42"
        },
        {
          "author": "Zoetry AI",
          "category": null,
          "channel_id": "UCp9Af6JMvLGnm2c9QYc1DNA",
          "description": "Try Converge AI here with 300 extra free credits in 48 hours: https://enter.converge.ai/s/ABAhH3 What if one person could build, ...",
          "is_live_content": null,
          "keywords": [],
          "number_of_views": 2020,
          "published_time": "1 hour ago",
          "thumbnails": [
            {
              "height": 202,
              "url": "https://i.ytimg.com/vi/n7Gl4L9p_no/hq720.jpg?sqp=-oaymwEgCOgCEMoBSFXyq4qpAxIIARUAAIhCGAFwAcABBrgC8xg=&rs=AOn4CLDv579xagQ1WTPzSb-Qx0uByYZ3EQ",
              "width": 360
            },
            {
              "height": 404,
              "url": "https://i.ytimg.com/vi/n7Gl4L9p_no/hq720.jpg?sqp=-oaymwEgCNAFEJQDSFXyq4qpAxIIARUAAIhCGAFwAcABBrgC8xg=&rs=AOn4CLCWHsXz6xPah6hm_4pgs2n2ZO_rQg",
              "width": 720
            }
          ],
          "title": "Converge AI | Build Production-Ready AI Agents Without Code",
          "type": "NORMAL",
          "video_id": "n7Gl4L9p_no",
          "video_length": "16:38"
        },
        {
          "author": "Greg Isenberg",
          "category": null,
          "channel_id": "UCPjNBjflYl0-HQtUvOx0Ibw",
          "description": "I welcome Ryan Carson back to the show to turn anyone into a world-class agent operator. Ryan spent 25 years founding ...",
          "is_live_content": null,
          "keywords": [],
          "number_of_views": 123817,
          "published_time": "3 weeks ago",
          "thumbnails": [
            {
              "height": 202,
              "url": "https://i.ytimg.com/vi/vJEy3nP2_C8/hq720.jpg?sqp=-oaymwEgCOgCEMoBSFXyq4qpAxIIARUAAIhCGAFwAcABBrgC8xg=&rs=AOn4CLAlHoQ8KJe6Q9-Gml1xUFIJV9GJLg",
              "width": 360
            },
            {
              "height": 404,
              "url": "https://i.ytimg.com/vi/vJEy3nP2_C8/hq720.jpg?sqp=-oaymwEgCNAFEJQDSFXyq4qpAxIIARUAAIhCGAFwAcABBrgC8xg=&rs=AOn4CLArchCicRedfz0aGJbEOL3I8_hE2Q",
              "width": 720
            }
          ],
          "title": "Most Valuable Skill of 2026: Managing AI Agents",
          "type": "NORMAL",
          "video_id": "vJEy3nP2_C8",
          "video_length": "44:47"
        },
        {
          "author": "Paul J Lipsky",
          "category": null,
          "channel_id": "UCmeU2DYiVy80wMBGZzEWnbw",
          "description": "Download Grok Bot: https://x.ai/bot Grok Bot gives each AI agent its own role, always-on computer, browser, files, logins, and ...",
          "is_live_content": null,
          "keywords": [],
          "number_of_views": 32844,
          "published_time": "3 days ago",
          "thumbnails": [
            {
              "height": 202,
              "url": "https://i.ytimg.com/vi/QTcZPI-g7is/hq720.jpg?sqp=-oaymwEgCOgCEMoBSFXyq4qpAxIIARUAAIhCGAFwAcABBrgC8xg=&rs=AOn4CLCKb9Eh5j-AM9GLj4qNUBLis1m8rA",
              "width": 360
            },
            {
              "height": 404,
              "url": "https://i.ytimg.com/vi/QTcZPI-g7is/hq720.jpg?sqp=-oaymwEgCNAFEJQDSFXyq4qpAxIIARUAAIhCGAFwAcABBrgC8xg=&rs=AOn4CLAHIgOV7GOr9SyCMhcrIMvlsLVNrA",
              "width": 720
            }
          ],
          "title": "Cursor Just Released Grok Bot (An Insanely Easy AI Agent)",
          "type": "NORMAL",
          "video_id": "QTcZPI-g7is",
          "video_length": "13:19"
        },
        {
          "author": "Riley Brown",
          "category": null,

Examples

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

Model card

Specifications

Pricing

Base price
$0.0015 / 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

search_query
string · required
continuation_token
string · optional
country_code
string · optional
language_code
string · optional
order_by
string · optional

Access

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

API README

YouTube Video Search API

Search YouTube for a keyword and get matching videos with their title, channel, view count, length and publish time.

Use cases

  • Monitor new videos about a brand or topic.
  • Research competitors and popular formats.
  • Find creators for sponsorships.

Request

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

Parameters

NameTypeRequiredDescription
search_querystringYesSearch keyword.
order_bystringNoOrder by, default is this_month, optional values are this_week, this_month, this_year, last_hour, today.
country_codestringNoCountry code, default is us.
language_codestringNoLanguage code, default is en.
continuation_tokenstringNoToken to continue fetching search results.

Example response

Real response for the request above, trimmed to the main fields. User names and long IDs are masked.

{
  "query": "OpenAI",
  "country": "US",
  "lang": "en",
  "number_of_videos": 20,
  "estimated_results": 395560,
  "continuation_token": "<token>",
  "videos": [
    {
      "video_id": "Fls_onRviPM",
      "title": "OpenAI DevDay 2026 Keynote (FULL)",
      "channel_id": "UCXZCJLdBC09xxGZ6gcdrc6A",
      "number_of_views": 650665,
      "published_time": "Streamed 6 days ago",
      "video_length": "53:35",
      "type": "NORMAL",
      "author": "OpenAI"
    }
  ]
}

Notes

  • order_by: last_hour, today, this_week, this_month (default) or this_year.
  • Paginate with continuation_token.

Related APIs

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/search-video
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/search-video" \
  -H "Authorization: Bearer $SANDBASE_API_KEY" \
  -H "Content-Type: application/json" \
  --data-binary @- <<'SANDBASE_JSON'
{
  "order_by": "this_month",
  "country_code": "us",
  "search_query": "AI agents",
  "language_code": "en"
}
SANDBASE_JSON
)
printf '%s\n' "$result"

Explore more

Related APIs

All APIs
APIPriceResponseReleased
YouTube$0.0015 per callJSONJul 31, 2026
YouTube$0.0015 per callJSONJul 31, 2026
YouTube$0.0015 per callJSONJul 31, 2026
YouTube$0.0015 per callJSONJul 31, 2026
YouTube$0.0015 per callJSONJul 31, 2026
YouTube$0.0015 per callJSONJul 31, 2026

Questions

FAQ

How do I use the YouTube Video Search API?

Send a POST request to https://api.sandbase.ai/v1/api/youtube/web/search-video 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 Video Search API cost?

$0.0015 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 Video Search API accept?

Required: search_query (string). Optional: continuation_token (string), country_code (string), language_code (string) and order_by (string). The Parameters table and the Playground on this page list every field.

What does the YouTube Video Search API return?

A JSON response returned in the same HTTP request (synchronous). The README on this page includes a sample response.

Do I need a YouTube developer account or API key?

No. YouTube Video Search 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.