SocQ already returned public YouTube channels, videos, Shorts, comments, search, playlists and transcripts. 7 Best YouTube Scraper APIs compares those, and the YouTube transcript guide covers caption text in bulk. On 2026-11-17, eight more endpoints went live on the YouTube platform page. They fill gaps for Shorts research, creator discovery and outreach, and the community posts creators publish between uploads.
This guide groups the new endpoints by job, shows one request for each, lists the price and says when to use it.
Quick answer: Send a JSON body to
POST https://api.socq.ai/v1/youtube/<endpoint>. Save the returnedtask_id, pollGET /v1/tasks/{task_id}untilstatusissucceeded, then readdata.results.items.
The New YouTube Endpoints at a Glance
1 SocQ credit = $0.005. Per-result endpoints have no base fee, so an empty result costs nothing.
| Endpoint | What it returns | Price |
|---|---|---|
| YouTube Trending Shorts API | A fresh sample of trending Shorts with channel, views, likes, comments, length and publish time | 0.5 credits ($0.0025) per Short |
| YouTube Shorts Search API | Shorts for a keyword with link, caption, views and vertical thumbnail | 0.6 credits ($0.003) per Short |
| YouTube Channel Search API | Channels for a keyword with ID, name, subscribers, avatar and description snippet | 0.6 credits ($0.003) per channel |
| YouTube Search Suggestions API | Ranked autocomplete suggestions for a partial query, by language and region | 0.5 credits ($0.0025) per call |
| YouTube Community Post API | One community post: full text, every image, likes and channel | 0.5 credits ($0.0025) per call |
| YouTube Community Post Comments API | Comments under a community post with commenter, likes and reply count | 0.3 credits ($0.0015) per comment |
| YouTube Related Videos API | The videos YouTube recommends next to a video | 0.5 credits ($0.0025) per video |
| YouTube Email Finder API | Public business emails of a channel and the pages they were found on | 15 credits ($0.075) per channel with an email; free when none is found |
Authentication and the Async Task Flow
All requests authenticate with an API key. The same header is used for submit, task status and result requests:
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
Every collection runs as a background task:
submit -> task_id -> queued -> running -> succeeded
\-> failed
The submit call returns immediately with data.task_id and data.status. Poll the task with that ID:
curl "https://api.socq.ai/v1/tasks/$TASK_ID?limit=50" \
-H "Authorization: Bearer $SOCQ_API_KEY"
When status is succeeded, the response includes result_count, credits_amount and the first page of normalized records in data.results.items. limit defaults to 50 and goes up to 500. If results.has_more is true, pass results.next_cursor as cursor to read the next page. A failed task carries error_message.
Every endpoint below also accepts an optional callback_url. SocQ sends one POST with a task summary when the task finishes; read the records from the task endpoint. A client-side timeout does not cancel a task, so resume with the same task ID instead of submitting again. A 402 means the account is out of credits, and a 429 means the key hit a rate or credit limit.
Research Shorts and Search Demand
Trending Shorts samples the Shorts YouTube is surfacing as trending right now, each with title, channel, views, likes, comments, length and publish time. Every field is optional; results_limit defaults to 48 and goes up to 200. Each run takes a fresh sample, so two runs a few minutes apart share only a handful of Shorts. A scheduled job therefore builds a wider picture over the day than one large call. (docs)
curl -X POST "https://api.socq.ai/v1/youtube/trending-shorts" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"results_limit": 48}'
Shorts Search returns Shorts for a keyword in YouTube's search order, with link, caption, view count and vertical thumbnail. Search results carry only those basics, so pass the links you keep to YouTube Videos when you also need likes, comments or channel details. results_limit defaults to 25 (1 to 200). (docs)
curl -X POST "https://api.socq.ai/v1/youtube/search-shorts" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query": "meal prep", "results_limit": 25}'
Search Suggestions returns the completions YouTube's search box proposes for the start of a query, ranked as viewers see them. language defaults to en and region to US; change them to see the same seed branch out in another market. Each call is billed once, whatever the number of suggestions. Use it for keyword research, titles and tags. (docs)
curl -X POST "https://api.socq.ai/v1/youtube/search-suggestions" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query": "iphone 17"}'
Discover Creators and Find Their Contact Email
Channel Search finds channels for a keyword, in YouTube's order, with channel ID, name, subscriber count, avatar and the description snippet shown in results. results_limit defaults to 20 (1 to 200). It is the first step of creator discovery: shortlist here, then pull details with YouTube Channels or uploads with YouTube Channel Videos. (docs)
curl -X POST "https://api.socq.ai/v1/youtube/search-channels" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query": "home cooking", "results_limit": 20}'
Email Finder looks up the business emails a creator has published: in the channel description, on linked social profiles, link-in-bio pages or the creator's own site. Each address in emails comes with the source_urls it was found on. url takes a channel link in the @handle or /channel/UC... form. A channel with at least one public email returns one result with every address found and costs 15 credits ($0.075); a channel that lists none returns an empty result at no charge. (docs)
curl -X POST "https://api.socq.ai/v1/youtube/channel-email" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"url": "https://www.youtube.com/@mkbhd"}'
Cost example: search 20 channels (12 credits), then run Email Finder on all 20. If 8 list an email, that is 120 credits, for a total of 132 credits ($0.66). You pay nothing for the 12 channels with no public email.
Read Community Posts and Their Comments
Community Post reads one post from its link: full text, every attached image, like count and the posting channel. url takes a https://www.youtube.com/post/{post_id} link or a channel Posts link that carries ?lb={post_id}. Use it when you already hold a post URL, for example from a YouTube Community Posts result. (docs)
curl -X POST "https://api.socq.ai/v1/youtube/community-post" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"url": "https://www.youtube.com/post/Ugkxvj2KoApYAXoqLWnKVr6zZe5JjeHrQeP8"}'
Community Post Comments collects the comments under a post, such as a poll, an announcement or an image drop, with each commenter's channel, metrics.likes_count and metrics.replies_count. Post comments live apart from video comments, so this is how you read the reaction to a creator's updates between uploads. The same URL forms work; results_limit defaults to 100 (1 to 1000). (docs)
curl -X POST "https://api.socq.ai/v1/youtube/community-post-comments" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"url": "https://www.youtube.com/post/UgkxX6gkDxQ0KRucvyG7NLui0LhjHp0CLlfZ", "results_limit": 100}'
See What YouTube Recommends Next
Related Videos returns the list YouTube places beside a video as what to watch next: titles, channels, view counts and thumbnails. url takes a watch, youtu.be, Shorts or live link. One run returns the whole recommendation list, usually about 20 videos, billed per video, so a typical call costs about 10 credits ($0.05). Run it on your own uploads or a competitor's to see which videos and channels YouTube treats as their neighbours. (docs)
curl -X POST "https://api.socq.ai/v1/youtube/related-videos" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ"}'
Related YouTube Guides
To compare SocQ with other YouTube data providers, see 19 Best YouTube API Alternatives. The same discovery and outreach flow for TikTok, including follower countries and fake-view checks, is in the new TikTok endpoints guide.
FAQ
Do I pay for channels with no public email?
No. A channel with no public email returns an empty result, which is free. A channel with at least one email costs 15 credits, however many addresses it lists.
Why do two Trending Shorts runs return different Shorts?
Each run samples what is trending at that moment, so runs a few minutes apart share only a handful of Shorts. Schedule several runs if you want broader coverage.
Which community post URLs are accepted?
https://www.youtube.com/post/{post_id}, or a channel Posts link that carries ?lb={post_id}.
Does Shorts Search return likes and comments?
No. Search results carry the link, caption, view count and thumbnail. Pass the links to YouTube Videos for likes, comments and channel details.
How is Search Suggestions billed?
0.5 credits per call, whatever the number of suggestions returned.
YOUTUBE API
Test the workflow with a public YouTube URL
Submit public inputs and receive normalized records with traceable source context.
Explore YouTube APIs