Public video metadata

YouTube API

Search YouTube, then read a video's details and statistics, its comments, and its captions as timed text. Channels, playlists, and Shorts are covered too. Responses carry public metadata only, with media and stream URLs removed.

Capabilities

What you can do with the YouTube API

Eighteen read-only endpoints for search, videos, channels, and playlists. A public video, channel, or playlist link works as input wherever an id does.

Search

Search returns videos, channels, and playlists for a query, with filters for type, sort order, duration, and upload date. Autocomplete suggestions and a list of popular videos by category are separate calls. See examples

One video

Title, description, publish date, length, views, likes, comment count, category, tags, chapters, and the channel with its subscriber count. Related videos and a batch lookup of up to 20 videos are separate calls. See examples

Comments

Top-level comments sorted by top or newest, each with the text, like count, reply count, and author. Replies to one comment come from a separate call. See examples

Transcript

The captions as timed cues with text, start time, and duration. You can pick a language when the video has more than one track, and a video without captions returns an empty list. See examples

The channel

A channel profile with handle, country, join date, and subscriber, video, and view counts. Its uploads, Shorts, live streams, and playlists are separate paged lists, and you can search inside the channel. See examples

A URL in

Resolve identifies a youtube.com or youtu.be link as a video, Short, playlist, or channel and returns its id and canonical URL. Channel handles and custom URLs are looked up to find the UC… channel id. See examples

How a call is made

From a link to the details

Send your key as a bearer token in the Authorization header. Video, channel, and playlist calls take either an id or a link.

Search

GET /api/v1/youtube/search requires q. Optional type, sort, duration, and uploadDate narrow the results, and the returned cursor keeps those filters for the next page.

One video

GET /api/v1/youtube/video takes id or url, and accepts watch, youtu.be, Shorts, embed, and live links. The comments, transcript, and related-videos calls take the same value.

The channel

Channel calls take id (UC…), handle (@name), or url. Optional country and language set the region and interface language, which default to US and en.

Shortened examples

Sample responses

Trimmed responses for a video, a channel search result, a comment, a transcript, a channel, and a popular video. Counts are the numbers from when each sample was captured, and none of the samples contains a media URL.

{
    "id": "MOLZOXqaomM",
    "title": "Learn Laravel from Scratch [FULL BOOTCAMP COURSE]",
    "publishedAt": "2025-09-16T09:00:06-07:00",
    "lengthSeconds": 7395,
    "viewCount": 105869,
    "likeCount": 2237,
    "commentCount": 129,
    "category": "Science & Technology"
}
{
    "id": "Ugzge340dBgB75hWBm54AaABAg",
    "text": "can confirm: he never gave us up",
    "publishedText": "1 year ago",
    "likeCount": 322000,
    "replyCount": 962,
    "author": {
        "name": "@YouTube",
        "handle": "@YouTube"
    }
}
{
    "id": "UCBR8-60-B28hp2BmDPdntcQ",
    "handle": "@YouTube",
    "title": "YouTube",
    "country": "United States",
    "subscriberCount": 46400000,
    "videoCount": 1625
}
{
    "type": "channel",
    "title": "Laravel",
    "handle": "@LaravelPHP",
    "subscriberCount": 79700
}
{
    "id": "dQw4w9WgXcQ",
    "languageCode": "en",
    "autoGenerated": false,
    "cues": [
        {
            "text": "♪ We're no strangers to love ♪",
            "startSeconds": 18.64,
            "durationSeconds": 3.24
        },
        {
            "text": "♪ You know the rules and so do I ♪",
            "startSeconds": 22.64,
            "durationSeconds": 4.32
        }
    ]
}
{
    "type": "video",
    "id": "9UQGXUlMYFU",
    "title": "comehelpglo - onsra (official music video)",
    "viewCount": 236000,
    "viewCountText": "236K views",
    "lengthSeconds": 132,
    "channel": {
        "name": "comehelpglo"
    }
}

Before you integrate

Common questions

Answers about what comes back, which inputs work, and what this API does not return.

No. Responses carry public metadata such as the title, description, length, and counts. Media, audio, and stream URLs are removed from every response, so you cannot download or play a video through this API.

Yes. /api/v1/youtube/video/comments takes the video id or link and pages through top-level comments, sorted by top or newest. /api/v1/youtube/video/comment-replies takes the video and a commentId. When the uploader has turned comments off, commentsTurnedOff is true.

No. They are trimmed responses kept to show the field names. On a live call, video and channel details are cached for up to 10 minutes.

Pass the link as url, or as id, to /api/v1/youtube/video. If you only need to know what a link points to, /api/v1/youtube/resolve returns its type, id, and canonical URL.

Only when the video has captions. Without language, the video's default caption track is used, then English. A video with no captions returns an empty list of cues, and a language the video lacks returns a 404 that lists the available codes.

Documentation

The YouTube docs cover the accepted link formats, the search filters, cursor paging, and how a transcript language is chosen, with a sample response for each of the 18 endpoints.

Code samples

Every endpoint in the documentation includes a sample request in Shell, JavaScript, PHP, and Python.

ShellShellJavaScriptJavaScriptPHPPHPPythonPython

View documentation

Related APIs

Other social and video APIs

These APIs run on the same SteadyAPI key.

TikTok

Public TikTok profiles, videos, comments, hashtags, and keyword search, starting from a username, a video id, or a link. TikTok API

Instagram

An Instagram account's public profile, posts, followers, and the comments on a post. Instagram API

X

Read X profiles, posts, reply threads, followers, and trending topics. Posting is not part of the API. Twitter / X API

Pricing

One plan covers every API

Your plan's monthly requests work on this API and every other SteadyAPI API. Plan details, overage rates, and the Free plan's daily cap are on the pricing page. Need more volume than the largest plan? Email [email protected].

Free
$0.00
$9.99
per month
Starter
$14.99
$19.99
per month
Developer
$39.99
$59.99
per month
Business Popular
$89.99
$99.99
per month
Enterprise
$299.99
$499.99
per month
SubscribeSubscribeSubscribeSubscribeSubscribe
Requests per month50010,00050,0002,500,000
Stock Market API
Options Data API
Crypto Data API
AliExpress API
Reddit API
Booking.com API
Real Estate API
Baseball (MLB) API
Hockey API
Football API
Amazon API
eBay API
Walmart API
Instagram API
Twitter / X API
TikTok API
YouTube API
AutoHub API
ScrapeFlow
Commercial Use
Optional overage rate*$1.50 per 1,000 requests$1.05 per 1,000 requests$0.09 per 1,000 requests
Overage capup to 50,000 extraup to 250,000 extraup to 12,500,000 extra
Free
$0.00
$94.99
per year
Starter
$11.96
$14.35
per month$143.52 billed yearly
Developer
$32.50
$40.00
per month$389.99 billed yearly
Business Popular
$72.50
$90.00
per month$869.99 billed yearly
Enterprise
$320.83
$400.00
per month$3,849.99 billed yearly
SubscribeSubscribeSubscribeSubscribeSubscribe
Requests per month50010,00050,0002,500,000
Stock Market API
Options Data API
Crypto Data API
AliExpress API
Reddit API
Booking.com API
Real Estate API
Baseball (MLB) API
Hockey API
Football API
Amazon API
eBay API
Walmart API
Instagram API
Twitter / X API
TikTok API
YouTube API
AutoHub API
ScrapeFlow
Commercial Use
Optional overage rate*$1.50 per 1,000 requests$1.05 per 1,000 requests$0.09 per 1,000 requests
Overage capup to 50,000 extraup to 250,000 extraup to 12,500,000 extra

* Overage is optional and stays off until you turn it on in Billing. It is available on paid plans billed by card through Stripe, and not during a trial. Usage is counted in monthly periods that start on your billing day, yearly plans included. Requests past the included limit are charged at the plan's rate for each started block of 1,000, up to the overage cap, on one invoice after the period ends. Amounts under $0.50 carry over to the next invoice. If you change plans during a period, the limit and overage rate of the plan you are on when the period ends apply to the whole period.

The Free plan is also capped at 20 requests per day (New York time). Requests count by endpoint weight, and only responses with HTTP status 200 count.

Commercial use is included only on the plans that list it. If you are not sure whether your project counts as commercial use, email [email protected] before you launch.

Why this API

How the YouTube calls fit together

Details, comments, and captions come from separate calls, so you request only the parts your product uses.

Metadata, not media

You get the public record of a video: details, counts, comments, and captions. Media and stream URLs are stripped, so playback stays on YouTube.

Paste the URL

Watch, youtu.be, Shorts, embed, and live links all work as the video input. Resolve handles channel and playlist links when you need the id first.

Channel, then lists

The channel call returns the profile. Uploads, Shorts, streams, and playlists are separate lists, each with a cursor for the next page.

Your monthly plan

Most YouTube endpoints weigh 2. Suggest and resolve weigh 1, and the 20-video batch weighs 5. Requests are deducted from your plan's monthly total by those weights.

Also on the blog

From the blog

These posts come from across SteadyAPI, so the one at the top may be about a different API. The reference for this page is the documentation above.

How to Search Hotels Using SteadyAPISep 25, 2026

How to Search Hotels Using SteadyAPI

Learn how to find hotels by destination using SteadyAPI. Resolve a place name to coordinates, then pull property names, ratings, and prices with the Booking.com hotel search endpoints.

READ MORE
Predicting Property Value Trends: How to Use Real Estate Valuation APIsJul 19, 2026

Predicting Property Value Trends: How to Use Real Estate Valuation APIs

Learn how to build a predictive real estate valuation pipeline using SteadyAPI. This guide shows developers how to combine historical property values, multi-provider forecasts, neighborhood market trends, housing market indicators, and comparable sales data to power automated valuation models (AVMs), investment analytics, and property intelligence platforms with structured real-time API data.

READ MORE
How to Fetch Local School Ratings and Neighborhood Amenities via APIJul 19, 2026

How to Fetch Local School Ratings and Neighborhood Amenities via API

Neighborhood insights are just as important as the property itself. This guide shows developers how to use the SteadyAPI Neighborhood Amenities API to fetch school ratings, walkability and transit scores, and nearby amenities through a single endpoint. You'll learn how to authenticate requests, retrieve structured neighborhood data, filter schools and local businesses, and combine these metrics into a custom neighborhood quality score. Whether you're building a real estate marketplace, property valuation model, or location intelligence dashboard, this tutorial helps you enrich listings with valuable contextual data while reducing the complexity of managing multiple third-party integrations.

READ MORE
The Developer’s Guide to Integrating Real-Time MLS Property DataJul 19, 2026

The Developer’s Guide to Integrating Real-Time MLS Property Data

This guide walks developers through building a modern real estate data pipeline with SteadyAPI. You'll learn how to search MLS property listings, retrieve tax and transaction histories, analyze local housing market trends, and enrich property data with neighborhood and environmental insights. Instead of maintaining fragile web scrapers or navigating complex MLS integrations, SteadyAPI provides structured JSON APIs that simplify property data ingestion and help you build faster, more reliable real estate applications. Whether you're creating an investment platform, property valuation engine, market research tool, or analytics dashboard, this tutorial covers the essential endpoints and architecture needed to get started.

READ MORE