YouTube Home Feed API
YouTube homepage feed API — get recommended videos from YouTube's front page by region. Discover trending and promoted content from $0.01/call.
Fetch the YouTube home feed — the algorithmically curated mix of videos that appears on YouTube's main page. Includes pagination support.
Try it live
Fill in the fields and hit Run to see a real response.
{
"ok": true,
"data": {
"data": [
{
"type": "video",
"videoId": "abc123",
"title": "Recommended Video",
"channelTitle": "Popular Channel",
"viewCount": "1200000"
}
]
}
}Features
Call /v1/youtube/home to fetch the algorithmically curated mix YouTube shows on its front page — the recommendation engine's default output as JSON.
Each home-feed entry carries videoId, title, channelTitle, and viewCount, so curated recommendations arrive ready to display.
Scroll the home feed programmatically with the continuation token, fetching successive batches just as the YouTube front page loads more.
Pass geo and lang codes to see the home feed as a user in that country and language would, for regional algorithm research.
Use cases
Content Curation
Use YouTube's algorithm to discover popular and recommended content for your audience.
Algorithm Analysis
Study what YouTube's algorithm recommends on the home page across different regions.
Video Widget
Power a YouTube video widget on your site with fresh, algorithmically curated content.
Quick start
Copy this snippet and start making calls.
const res = await fetch('https://api.yepapi.com/v1/youtube/home', {
method: 'POST',
headers: {
'x-api-key': 'YOUR_API_KEY',
'Content-Type': 'application/json',
},
body: JSON.stringify({
"geo": "US",
"lang": "en"
}),
});
const data = await res.json();
console.log(data);The YouTube Home Feed API — the algorithm's front page
The YouTube Home Feed API returns the algorithmically curated mix that loads on YouTube's main page. Call /v1/youtube/home with optional geo and lang codes and get a data array of recommended videos, each with videoId, title, channelTitle, and viewCount, plus a continuation token to scroll deeper. It's a non-personalized window into what YouTube promotes by default in a region.
At $0.01 per call you can sample the home feed across countries and languages to study how the recommendation engine behaves regionally — or simply power a fresh, curated video widget that doesn't require any search query.
What is a YouTube Home Feed API?
A YouTube Home Feed API returns the videos that appear on YouTube's homepage — the algorithm's default, non-query recommendations — as structured JSON. You optionally pass a country (geo) and language (lang), and receive a data array of curated videos, each with videoId, title, channelTitle, and viewCount, plus a continuation token to load more. It's distinct from both search (which needs a query) and trending (a ranked chart): the home feed is the recommendation engine's open-ended mix, the closest programmatic equivalent to opening youtube.com fresh in a given region. The official Data API has no direct counterpart.
Build your own curated video widget
Power a "discover" widget on your site with the home feed: fetch a page, render the videos, and paginate as the user scrolls — a steady stream of algorithmically fresh content with zero query input. For research, sample geo=US, geo=GB, and geo=IN side by side to study how YouTube's default recommendations diverge by region, an angle search and trending can't show you. Cross-reference home-feed videos against the Trending endpoint to see how much the algorithm's open mix overlaps with the official trending chart.
YouTube Home Feed API pricing — $0.01/call
Each home-feed page costs $0.01 and returns a batch of recommended videos with a continuation token for more. There's no daily quota and no personalization to manage. Because the official Data API offers no home-feed endpoint, this is one of the few ways to read the front-page recommendation mix at all — and at a flat cent per page, sampling it across regions for research is inexpensive.
Home feed vs. trending vs. related
The Home feed is the algorithm's open-ended front-page mix; Trending is a ranked chart of what's surging by region and category; Related is the recommendation graph around one specific video. Use Home to study default recommendations, Trending to track established viral momentum, and Related to map neighbors of a known video. All three need no query and all three share one YepAPI key with the rest of the YouTube, TikTok, and Instagram endpoints.
Try the YouTube Home Feed API free
Sign up for $5 in free credit, no card required — 500 home-feed pages. Sample the front-page mix across a few countries and languages to see how the recommendation engine shifts before you build.
Start making API calls in 30 seconds
$5 free credit on signup. No credit card required. Pay per call.
What developers say
“Switched from SerpAPI and cut our SERP costs by 80%. Same data quality, way simpler billing.”
“One API key for AI models, SERP data, and web scraping. Saved us from managing 4 separate providers.”
“The $5 free credit let us prototype our entire rank tracking feature before committing. No other API does that.”
Frequently asked questions
Fetch the YouTube home feed — the algorithmically curated mix of videos that appears on YouTube's main page. Includes pagination support.
Each API call costs $0.01. No monthly minimums or subscriptions — you only pay for what you use.
Sign up for a free API key, then send a POST request to /v1/youtube/home. Check the code example above for a ready-to-use snippet in JavaScript, cURL, or Python.
YepAPI bundles SEO, AI, and web scraping APIs under one key with no monthly minimums. You get lower per-call pricing, a unified dashboard, and one billing account instead of managing multiple providers.
Ready to integrate?
Get your API key and start making calls in 30 seconds. $5 free credit on signup — no credit card required.
More youtube api endpoints
Search
$0.01YouTube search API — find videos, channels, and playlists with filters for date, duration, and type. Structured JSON results from $0.01/call.
Video Details
$0.02Full YouTube video metadata — title, views, likes, description, keywords, thumbnails, and available formats. Video intelligence from $0.02/call.
Comments
$0.01YouTube comments API — fetch top-level comments and replies with author info, likes, and timestamps. Sentiment analysis and engagement research from $0.01/call.