YouTube Video API
Get one video from its link or ID: title, description, channel, views, likes, length, category, keywords and publish date.
Sendurl
Returnstitlechannel_nameview_countlike_countduration_secondscategory
Get public YouTube videos, channels, Shorts, live streams, comments, playlists and search results as clean JSON. Send a link, a handle or a search. No Google account and no API quota.
| # | Title | Views | Length (s) | Video ID | Views | Duration | Type | View count approximate |
|---|---|---|---|---|---|---|---|---|
| 1 | Planetary Defenders: This Is Not an Exercise | 84,000 | 1215 | 5b3n-u_0QAI | 84K views | 20:15 | video | true |
| 2 | NASA's SpaceX Crew-13 Mission (Official NASA Trailer) | 102,000 | 62 | ErAqN6gXqZQ | 102K views | 1:02 | video | true |
| 3 | NASA Moon Base: The First Six Months | 522,000 | 67 | IwZVXmQdX1E | 522K views | 1:07 | video | true |
| 4 | What It Takes | 325,000 | 152 | 90Kgw_SvK4w | 325K views | 2:32 | video | true |
| 5 | Artemis III: Our Next Step Back to the Moon | 152,000 | 61 | jHKf1eHp3eQ | 152K views | 1:01 | video | true |
| 6 | For Earth, With Love: Artemis II | 437,000 | 203 | MVt2139voxk | 437K views | 3:23 | video | true |
| 7 | Artemis Origins: Humanity's Return to the Moon | 91,000 | 86 | _oXt3-YDih4 | 91K views | 1:26 | video | true |
| 8 | NASA's Nancy Grace Roman Space Telescope Launches (Official NAS… | 212,000 | 127 | 6o3m9Bw67Os | 212K views | 2:07 | video | true |
| 9 | NASA's Artemis II Astronauts Receive the Congressional Space Me… | 89,000 | 115 | 8NOLpgadWXc | 89K views | 1:55 | video | true |
| 10 | President Donald J. Trump Calls the International Space Station… | 118,000 | 90 | 1icdW32gS8A | 118K views | 1:30 | video | true |
| # | Title | Live now | Views | Video ID | Views | Type |
|---|---|---|---|---|---|---|
| 1 | 24/7 halloween ambience 🎃 spooky lofi to get chills to | true | 5200 | 1-LpQekNa9g | 5.2K watching | video |
| 2 | 24/7 deep sleep music 🌌 calm ambient to sleep & dream to | true | 553 | nI725iVsyoQ | 553 watching | video |
| 3 | lofi house radio 🌅 lounge music to vibe/chill to | true | 1400 | 3PFJ9SETS4M | 1.4K watching | video |
| 4 | lofi hip hop radio 📚 beats to relax/study to | true | 19,000 | rFZHOHl-L8A | 19K watching | video |
| 5 | summer lofi radio ☀️ music to put you in a better mood | true | 313 | 0muHFBSiybw | 313 watching | video |
| 6 | sleep lofi radio 🌌 relaxing music to sleep/dream to | true | 505 | VAlMDl00mYY | 505 watching | video |
| 7 | synth ambient radio 🌌 deep space music to sleep to | true | 146 | GSfT7H87zq4 | 146 watching | video |
| 8 | Study With Me 📚 Pomodoro | true | 544 | qGohtGC5Rtk | 544 watching | video |
| 9 | sad lofi radio ☔ beats for rainy days | true | 198 | CwPCy1GLS38 | 198 watching | video |
| 10 | asian lofi radio ⛩️ beats to relax/study to | true | 1000 | 1Tl2FtV06qo | 1K watching | video |
What each one takes and what it returns. Open one for a real response, every input and every field.
Get one video from its link or ID: title, description, channel, views, likes, length, category, keywords and publish date.
Sendurl
Returnstitlechannel_nameview_countlike_countduration_secondscategory
Get a channel from its link, handle or ID: name, description, subscribers, video count, keywords and tabs.
Sendurl
Returnstitlechannel_handlesubscriber_countvideo_countdescriptionis_family_safe
List a channel's videos, newest first, with title, views and length, page by page.
Sendurl
Returnstitleview_countduration_secondsvideo_idviewsduration
Search YouTube for videos, Shorts, channels, playlists or live streams, filtered by upload date and length and sorted by relevance, date, views or rating.
Sendquery
Returnstitleviewsview_countchannelchannel_idduration
Read a video's top or newest comments, and the replies to any of them.
Sendurl
ReturnsJSON; every field is in the API reference
List a channel's Shorts with their view counts.
Sendurl
Returnsheadlineviewsview_countaccessibility_textentity_idthumbnails
List a channel's live streams: live now, scheduled and past.
Sendurl
Returnstitleis_liveview_countvideo_idviewstype
List the playlists on a channel's Playlists tab with their video counts.
Sendurl
Returnstitlevideo_countplaylist_idauthortype
Get a playlist from its link or ID: title, owner, video and view counts, and its videos page by page.
Sendurl
Returnstitleis_editablelast_updatedownerowner_channel_idpages
List the posts on a channel's community tab.
Sendurl
Returnscontentauthorpost_idtypevote_count
Get one community post from its link or ID: text, media, poll and vote count.
Sendurl
Returnscontentauthorpost_idvote_countvote_count_approximatevote_count_text
List the videos YouTube shows on a hashtag's page.
Sendurl
Returnsitemssummary
Get the search suggestions YouTube offers for the start of a query, in the language you choose.
Sendquery
Returnssuggestions
Get a sample of the Shorts YouTube recommends to a visitor right now.
Returnsshorts
Follow channels: subscribers, publishing rhythm and how each video, Short and stream performs.
ChannelChannel videosChannel ShortsSee which videos rank for a search and what YouTube suggests around it.
SearchTypeahead searchHashtag videosBuild datasets of a channel's videos, playlists, live streams and community posts.
PlaylistChannel playlistsChannel live streamsChannel communityOne request shape for every YouTube endpoint: the endpoint ID and its input. No SDK needed.
curl --request POST \ --url https://data.upscrape.com/execute \ --header "Authorization: Bearer $UPSCRAPE_API_KEY" \ --header "Content-Type: application/json" \ --header "Prefer: wait=30" \ --data '{ "capability": "youtube.video.get", "input": { "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ" }}'
import jsonimport osimport requestspayload = json.loads(r'''{ "capability": "youtube.video.get", "input": { "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ" }}''')response = requests.post( "https://data.upscrape.com/execute", headers={ "Authorization": f"Bearer {os.environ['UPSCRAPE_API_KEY']}", "Content-Type": "application/json", "Prefer": "wait=30", }, json=payload,)response.raise_for_status()print(json.dumps(response.json(), indent=2))
const response = await fetch("https://data.upscrape.com/execute", { method: "POST", headers: { "Authorization": `Bearer ${process.env.UPSCRAPE_API_KEY}`, "Content-Type": "application/json", "Prefer": "wait=30", }, body: JSON.stringify({ "capability": "youtube.video.get", "input": { "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ" }}),});if (!response.ok) { throw new Error(`Upscrape request failed: ${response.status}`);}console.log(JSON.stringify(await response.json(), null, 2));
{ "title": "Rick Astley - Never Gonna Give You Up (Official Video) (4K Remaster)", "like_count": 19482118, "view_count": 1825190023, "category": "Music", "channel_id": "UCuAXFkgsw1L7xaCfnd5JJOw", "channel_name": "Rick Astley", "channel_subscriber_count": "4.55M subscribers", "channel_url": "/@RickAstleyYT", "date_text": "Oct 24, 2009", "description": "The official video for “Never Gonna Give You Up” by Rick Astley. \n\nNever: The Autobiography 📚 OUT NOW! \nFollow this link to get your copy a…", "duration_seconds": 213, "embed_url": "https://www.youtube.com/embed/dQw4w9WgXcQ", "full_description": "The official video for “Never Gonna Give You Up” by Rick Astley. \n\nNever: The Autobiography 📚 OUT NOW! \nFollow this link to get your copy a…", "is_family_safe": true, "is_live": false, "is_live_content": false, "is_private": false, "is_unlisted": false, "like_count_text": "19M", "metadata_complete": true, "publish_date": "2009-10-24T23:57:33-07:00", "upload_date": "2009-10-24T23:57:33-07:00", "video_id": "dQw4w9WgXcQ", "view_count_text": "1,825,190,023 views", "most_replayed": { "video_id": "dQw4w9WgXcQ", "segments": [ { "duration_seconds": 2.14, "intensity": 1, "start_seconds": 0 }, { "duration_seconds": 2.14, "intensity": 0.4230315549340408, "start_seconds": 2.14 } ] }, "keywords": [ "rick astley", "Never Gonna Give You Up" ]}
https://data.upscrape.com/mcp
Use Upscrape to get the YouTube video youtube.com/watch?v=dQw4w9WgXcQ. How many views and likes does it have, and when was it published?
With Upscrape, look up the @NASA channel on YouTube. How many subscribers and videos does it have?
Using Upscrape, list NASA's latest YouTube videos with views and length, and tell me which ten got the most views.
The short answers. The docs have the long ones.
The official API needs a Google project and works within a daily quota. Upscrape reads public YouTube pages, so you get videos, channels, comments and search results with one API key and no quota to plan around.
No. You send a link, a handle or a search and get JSON back. Nothing runs on your account. Private videos are not part of it.
Yes, top or newest first, and the replies to any comment by passing back the replies_continuation it came with.
Not yet. Video details, channels, comments, playlists and search are available today.
Video, channel, channel videos, search, comments, channel shorts, channel live streams, channel playlists, playlist, channel community, community post, hashtag videos, typeahead search and trending shorts. Each is its own endpoint with a published input schema, and the response is JSON.
Every YouTube endpoint costs 1 credit per successful call. You buy credits once, with no subscription, and paid credits never expire. New accounts get free credits to try it.
Yes. Connect any MCP client to the Upscrape MCP server with OAuth or an API key. The agent finds the YouTube endpoint, checks its price and runs it with the same credits as the REST API.
Upscrape reads public pages only and needs no login. How you use the data is yours to decide under the laws that apply to you; we sign a data processing agreement for your legal review.
Up to 100 free credits to start, no card needed.