Channel
1 credit/v1/youtube/channelGet YouTube channel info.
channelId, handle, url, hl
Fetch public YouTube data as structured JSON with one SocialCrawl API key. Same Post, Comment, and Author schema as every other platform. Reads are priced in credits.
28 active endpoints
28 live read endpoints for public YouTube data. Channels, videos, comments, transcripts, playlists, search, and shorts surfaces. Data API only.
/v1/youtube/channelGet YouTube channel info.
channelId, handle, url, hl
/v1/youtube/profile/fullYouTube profile, recent posts, and computed analytics in one call.
handle, channelId, url, posts
/v1/youtube/channel/videosList YouTube channel videos.
channelId, handle, sort, continuationToken
/v1/youtube/videoGet YouTube video details.
url, language, hl
/v1/youtube/video/commentsList YouTube video comments.
url, continuationToken, order, searchTerm, format
/v1/youtube/video/transcriptGet YouTube video transcript.
url, language
/v1/youtube/searchSearch YouTube.
query, uploadDate, sortBy, type, duration
/v1/youtube/search/advancedAdvanced YouTube video search.
query, order, duration, event_type, license
/v1/youtube/playlistGet YouTube playlist.
playlist_id, cursor, channel_id
/v1/youtube/shorts/trendingGet trending YouTube shorts.
see docs
Returns a YouTube channel's public profile: subscriber figure on author.followers (approximate above 1,000), total video count, total view count, description, banner URL, and avatar URL.
Use it when you have a handle, channel id, or channel URL and want an account snapshot before pulling its videos.
1 credit
$ curl https://www.socialcrawl.dev/v1/youtube/channel?handle=MrBeast \
-H "x-api-key: sc_YOUR_API_KEY"// Running this live needs your own API key. Hit "Try it" to see an example responseYouTube is a normal SocialCrawl social surface. You call GET /v1/youtube/… with an API key, spend credits on live misses, and get a single JSON envelope back. No second SDK.
Send your key in the x-api-key header. The same key works across the SocialCrawl catalog.
Routes are GET. Pass handles, urls, queries, and cursors as query strings. We validate formats before charging.
Live misses debit the route tier. Cache hits cost 0. Empty or hard failures refund.
Every response is the same shape: success, data, credits_used, credits_remaining, request_id, cached.
Most products resolve an account, page content, then deepen only the posts that matter.
GET /v1/youtube/channelAuthor-shaped profile
Resolve the handle or id once.
GET /v1/youtube/profile/fullPostList of recent public items
Page with cursor or after when the route supports it.
GET /v1/youtube/channel/videosFull Post for one URL or id
List rows are not enough when you need the full record.
GET /v1/youtube/videoCommentList when the platform exposes it
Expand only when a thread matters.
GET /v1/youtube/channel
?handle=example
Host: www.socialcrawl.dev
x-api-key: sc_your_api_key_here{
"success": true,
"data": { "/* Author | Post | PostList | CommentList | … */": true },
"credits_used": 1,
"credits_remaining": 9999,
"request_id": "req_…",
"cached": false
}Field names match the rest of SocialCrawl where archetypes align.
id, username, display_name, avatar_url, bio, followers, url, ext
items[].post with id, url, content, engagement, author, published_at, ext
items[] with author, content.text, engagement, published_at when comments ship
search hits, media metadata, or transcripts depending on route
Same request lifecycle as every other /v1 platform endpoint.
Next.js catch-all routes into the Hono social API. We mint a request_id, authenticate the key, then enforce rate limit and concurrency.
Registry lookup finds the route. Required params run first. Invalid input returns 400 with no charge. Valid calls debit before upstream work.
A deterministic cache key is built from platform + resource + params. Hit: credits_used = 0. Miss: upstream fetch with retries and circuit breaker.
Upstream JSON is mapped to Author / Post / PostList / CommentList (or route archetype), validated, wrapped in the success envelope, and logged for billing audit.
Billing rules that matter in production
YouTube is public-read data on SocialCrawl. We normalize it into the shared schema so your code does not learn a second OAuth flow.
Public YouTube surfaces exposed by the registry. Read-only for research, monitoring, and product jobs.
Social-read upstreams behind one gateway. Prism composites combine legs when a fat route is registered.
Unified JSON envelope: success, data, credits_used, request_id, cached. Shared Author / Post / Comment leaves where archetypes align.
No write endpoints and no private inbox. Disabled routes stay out of the active count. Prefer registry docs for the live inventory.
The jobs this API is most often used for.
Channel intelligence and video VoC
Callers concentrate on profile, content lists, search, and deepen paths on YouTube. Channel to video to comments to transcript chains at credit prices, without maintaining a separate YouTube Data API project for these reads.
Detail reads are typically a few seconds on live miss. Search and fat composites are slower paths.
The jobs YouTube data is most often used for. Each one is a full recipe with the endpoint chain and pricing.
Common ways teams put this data to work, and the stack each one tends to run.
Poll profiles and feeds on YouTube. Alert when engagement velocity jumps.
Search and expand posts for brand, product, and competitor language on YouTube.
Wire resolve to list to detail into pipelines. Cache hits keep recurring runs cheap.
Live misses spend credits by tier. Cache hits are free. Empty or hard failures refund.
curl "https://www.socialcrawl.dev/v1/youtube/channel?handle=example" \
-H "x-api-key: sc_your_api_key_here"curl "https://www.socialcrawl.dev/v1/youtube/profile/full?handle=example" \
-H "x-api-key: sc_your_api_key_here"Same key as the rest of the catalog
Every endpoint returns structured JSON in a unified envelope. Computed fields such as engagement rate and content category are included only where the endpoint supports them and the required source inputs are present.
Same YouTube data, two very different paths. Auth, rate limits, schema, and cost, side by side.
| Feature | SocialCrawl | YouTube Data API v3 |
|---|---|---|
| Authentication | One x-api-key header | Google Cloud API key, plus OAuth for private data |
| Setup / approval | Sign up and call in under a minute | Google Cloud project setup; quota extensions require an audit |
| Rate limits | Pay per request in credits, with no daily quota | 10,000 quota units per day by default; one search costs 100 units |
| Data coverage | Channels, videos, Shorts, comments, playlists, community posts, trending Shorts, and transcripts | Core resources covered; community posts not served, captions only for videos you own |
| Response schema | Unified JSON envelope shared across 51 platforms | YouTube-specific resource payloads |
| Pricing | From 1 credit per request, 100 free credits to start | Free within the daily quota |
| Maintenance | Schema stays stable when YouTube changes its frontend | Official Google support and stable versioning |
Authentication
Setup / approval
Rate limits
Data coverage
Response schema
Pricing
Maintenance
Find answers to frequently asked questions about SocialCrawl's API, pricing, and capabilities.
Contact usAsk AI about SocialCrawl