What it returns
Pull structured YouTube data in one run: video details, channel statistics and uploads, keyword search results and comments. It is built on the official YouTube Data API, so runs are fast and never blocked. You do not need an API key.
Each dataset item has a `type` of `video`, `channel` or `comment`. Export as JSON, CSV or Excel, or read it through the Apify API.
Common uses
Influencer research, competitor channel tracking, content and keyword research, comment sentiment analysis, and building datasets for analytics.
Request
POST https://api.pushbuild.com/youtube-data/run with a JSON body. Send your key in the X-API-Key header.
| Field | Type | Description |
|---|---|---|
searchQueries | list of strings | Search YouTube for videos matching these terms. |
channels | list of strings | Channel URLs, @handles, channel IDs (UC...) or names. Returns channel stats plus its latest uploads. |
videos | list of strings | Video URLs or 11-character video IDs (watch, shorts, youtu.be links all work). |
maxVideosPerSource | integer | How many videos to collect for each search query and each channel. Default: 50. |
searchOrder | string: relevance, date, viewCount, rating | Sort order for search results. Default: "relevance". |
publishedAfter | string | Only search results published after this date (YYYY-MM-DD). |
regionCode | string | Two-letter country code to localise search results (e.g. US, GB, DE). |
includeComments | boolean | Also collect top-level comments for every video. Default: false. |
maxCommentsPerVideo | integer | Comment cap per video. Default: 100. |
commentsOrder | string: relevance, time | Top comments first, or newest first. Default: "relevance". |
maxItems | integer | Maximum items to return (1-500). Default: 100. |
Example
curl -X POST https://api.pushbuild.com/youtube-data/run \
-H "X-API-Key: YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"searchQueries": ["home espresso machine review"], "channels": ["@mkbhd"], "maxItems": 20}'Response
{"count": 20, "truncated": false, "seconds": 1.4, "items": [ { ... } ]}Each call returns up to 500 items. Records that fail validation or are not found are flagged in the items and not charged.
Pricing
Pay only for results returned: $0.32 per 1,000 comments · $1.20 per 1,000 videos · $1.60 per 1,000 channels. No charge for errors or empty searches.
Related APIs
Bulk SEO Audit & PageSpeed / Core Web Vitals Checker API
Audit any list of URLs: Lighthouse performance, SEO, accessibility and best-practice scores, real-user Core Web Vitals (LCP, INP, CLS), speed opportunities, and on-page SEO checks (title, meta description, H1, canonical, alt text, sitemap, robots, schema)..
FEC Campaign Finance (Candidates, PACs, Contributions) API
US federal campaign finance from official FEC bulk data: candidate receipts, spending, cash on hand and debts; PAC, super PAC and party committee totals; PAC and party contributions and independent expenditures for or against candidates.
Federal Register API
Search every Federal Register document since 1994: final and proposed rules, notices, executive orders and presidential documents, by keyword, agency, type, date and CFR part.
Google News Scraper API
Fast Google News results for any keyword, topic or country: title, source, publish time, snippet and link.
Google Trends Scraper API
Google Trends data for any keywords: interest over time, interest by country/state, related queries and topics (top and rising), plus today's trending searches.
Hacker News Scraper API
Search every Hacker News story and comment by keyword, date and points, or pull the live Top, New, Best, Ask, Show and Jobs feeds.
Tell us what you need built.
Questions about this API, higher volumes, or a data source you need that we don't cover yet.
hello@pushbuild.com