YouTubeYouTube ShortsCommunity PostsCreator OutreachAPI Guide

YouTube API New Endpoints: Trending Shorts, Community Posts, Channel Search and Emails

Eight new SocQ YouTube endpoints return trending Shorts, Shorts and channel search, search suggestions, community posts and their comments, related videos and channel business emails.

SocQUpdated November 19, 20267 min read

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 returned task_id, poll GET /v1/tasks/{task_id} until status is succeeded, then read data.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.

EndpointWhat it returnsPrice
YouTube Trending Shorts APIA fresh sample of trending Shorts with channel, views, likes, comments, length and publish time0.5 credits ($0.0025) per Short
YouTube Shorts Search APIShorts for a keyword with link, caption, views and vertical thumbnail0.6 credits ($0.003) per Short
YouTube Channel Search APIChannels for a keyword with ID, name, subscribers, avatar and description snippet0.6 credits ($0.003) per channel
YouTube Search Suggestions APIRanked autocomplete suggestions for a partial query, by language and region0.5 credits ($0.0025) per call
YouTube Community Post APIOne community post: full text, every image, likes and channel0.5 credits ($0.0025) per call
YouTube Community Post Comments APIComments under a community post with commenter, likes and reply count0.3 credits ($0.0015) per comment
YouTube Related Videos APIThe videos YouTube recommends next to a video0.5 credits ($0.0025) per video
YouTube Email Finder APIPublic business emails of a channel and the pages they were found on15 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"}'

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.

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