Platforms/YouTube
YouTube API
Read YouTube channels with their videos and Shorts, a video's details and chapters, playlists, community posts, search results and hashtag pages, as JSON. Every call reads what a logged-out visitor sees: no YouTube account and no developer app.
YouTube endpoints
9 endpoints, each a GET request with your key in the x-api-key header.
| Endpoint | Request | Returns |
|---|---|---|
| Channel | GET /v1/youtube/channel?handle=MrBeast | A channel's details: name, handle, description, subscribers, videos, views, country and links. |
| Channel videos | GET /v1/youtube/channels/videos?handle=MrBeast | A channel's videos, 30 a page: the latest first, the most viewed first, or the oldest first. |
| Channel shorts | GET /v1/youtube/channels/shorts?handle=MrBeast&sort=popular | A channel's shorts, 48 a page: the latest first, the most viewed first, or the oldest first. |
| Playlist | GET /v1/youtube/playlists?playlist_id=PLoSWVnSA9vG9qV0CVCpg5WwEy3LiP7udY | A playlist's details and its videos, 100 a page. |
| Post | GET /v1/youtube/posts?post_id=Ugkxvj2KoApYAXoqLWnKVr6zZe5JjeHrQeP8 | A channel's post: its text, images and likes, and the video it shares. |
| Video | GET /v1/youtube/videos?video_id=rfscVS0vtbw | A video's details: description, likes, comment count, chapters, captions, keywords and related videos. |
| Search | GET /v1/youtube/search?q=running | Videos and shorts that match a search; is_short tells them apart. |
| Hashtag videos | GET /v1/youtube/hashtags?tag=funny | A hashtag's videos: the first ones its page shows, up to about 20. |
| Hashtag shorts | GET /v1/youtube/hashtags/shorts?tag=funny | A hashtag's shorts, 36 a page. |
Your first request
Save your key and the base URL, then call the channel endpoint:
export API_KEY="your-api-key"
export API_URL="https://api.socialparse.dev"
curl -H "x-api-key: $API_KEY" "$API_URL/v1/youtube/channel?handle=MrBeast"Every answer has the same envelope on every platform: data, page for the next page, and meta. See Responses and Errors.
Compared with YouTube's own API
The YouTube Data API gives each project 10,000 quota units a day, and a single search costs 100 of them. Social Parse needs neither: it reads the public pages, and you pay per successful call.
Pricing
One credit per successful call, whichever endpoint; errors cost nothing and credits never expire. New accounts start with 100 free credits. See pricing for the packs.
FAQ
Do I need YouTube credentials or developer approval?
No. Social Parse reads YouTube's public pages as a logged-out visitor does, so you only need an API key.
What does each YouTube call cost?
One credit per successful call, live or cached; a page of results is one call, and errors cost nothing. New accounts get 100 free credits.
What about private YouTube content?
Only what a logged-out visitor can see is read. Content behind a login answers 403 LOGIN_REQUIRED, and something deleted answers 404 NOT_FOUND.
How fresh is the data?
Each call reads the live page. The same call within a few minutes is answered from a short cache, and deleted content is never served from it.