YouTube channel.shorts

POST

youtube

channel.shorts

curl -X POST https://api.socialrouter.io/v1/youtube/channel.shorts \
  -H "Authorization: Bearer sr_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://www.youtube.com/@mkbhd",
    "limit": 50
  }'

const response = await fetch(
  "https://api.socialrouter.io/v1/youtube/channel.shorts",
  {
    method: "POST",
    headers: {
      "Authorization": "Bearer sr_live_your_key",
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      url: "https://www.youtube.com/@mkbhd",
      limit: 50
    }),
  },
);

import requests

response = requests.post(
    "https://api.socialrouter.io/v1/youtube/channel.shorts",
    headers={"Authorization": "Bearer sr_live_your_key"},
    json={
      "url": "https://www.youtube.com/@mkbhd",
      "limit": 50
    },
)

const run = await sr.run("youtube/channel.shorts", {
  url: "https://www.youtube.com/@mkbhd",
  limit: 50
});

{
  "id": "ext_a1b2c3d4",
  "status": "completed",
  "platform": "youtube",
  "service": "channel.shorts",
  "url": "https://www.youtube.com/@mkbhd",
  "served_by": "apify/streamers",
  "data": [
    {
      "name": "$1 vs $10,000 Cake",
      "title": "$1 vs $10,000 Cake",
      "profile_url": "https://www.youtube.com/shorts/LgbyEFILLJI",
      "source": "youtube",
      "extracted_at": "2026-07-16T09:04:24.249Z",
      "video_id": "LgbyEFILLJI",
      "video_type": "shorts",
      "date_posted": "2026-07-03T16:00:02.000Z",
      "duration": "00:00:49",
      "thumbnail": "https://i.ytimg.com/vi/LgbyEFILLJI/maxresdefault.jpg?sqp=-oaymwEoCIAKENAF8quKqQMcGADwAQH4AbYIgAKAD4oCDAgAEAEYciBJKDgw...",
      "views": 66659034,
      "likes": 1700000,
      "num_comments": 14184,
      "comments_turned_off": false,
      "is_members_only": false,
      "is_paid_content": false,
      "is_age_restricted": false,
      "hashtags": [],
      "channel_id": "UCX6OQ3DkcsbYNE6H8uQQuVA",
      "channel_name": "MrBeast",
      "channel_url": "https://www.youtube.com/channel/UCX6OQ3DkcsbYNE6H8uQQuVA",
      "channel_username": "MrBeast",
      "channel_subscribers": 508000000,
      "channel_total_videos": 992,
      "channel_verified": true,
      "description_links": [],
      "collaborators": [],
      "source_url": "https://www.youtube.com/@MrBeast/shorts",
      "source_order": 1
    }
  ],
  "pagination": {
    "total": 1,
    "returned": 1
  },
  "created_at": "2026-07-30T12:00:00Z",
  "completed_at": "2026-07-30T12:00:03Z"
}

List the Shorts of a YouTube channel. The response is normalized, so it keeps the same shape whichever offer served it. The call is synchronous and comes back completed or failed. Body fields and error codes shared by every service are documented on Run a service.

Body

string[]

required

The URLs to fetch, as urls (array) or url (single string). Each one must match an accepted format below, and a mismatch returns 400 invalid_input_format before any routing or billing.

string

Single-input form of urls.

number

default:"100"

Maximum number of records to return. Integer, 1-250.

string

Pin one offer, as source/name. Serving this service: apify/streamers. Omit it (the default) to let the router walk the failover chain.

object

Typed options for this service. Validation is strict, so an unknown key or an out-of-enum value returns a corrective 400 instead of being dropped.

Hide options

string

Order of the channel’s videos (e.g. NEWEST, POPULAR, OLDEST).

Accepted URL formats

Format	Example
`https://www.youtube.com/@<handle>`	`https://www.youtube.com/@mkbhd`

/channel/<id>, /c/<name> and /user/<name> URLs are accepted too.

Offers

One offer serves this endpoint today. When a second one implements it, failover turns on with no change on your side.

Offer	Inputs per call
`apify/streamers`	100

Prices are live in the catalogue: GET /v1/services/youtube/channel.shorts. See Credits for how a call is billed.

Response

data[] holds the normalized records, served_by names the offer that answered, and credits_used carries the actual charge. The example response is a real run with values shortened for readability. A field is present when YouTube exposes it for that item, so the exact set varies record to record.

curl -X POST https://api.socialrouter.io/v1/youtube/channel.shorts \
  -H "Authorization: Bearer sr_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://www.youtube.com/@mkbhd",
    "limit": 50
  }'

const response = await fetch(
  "https://api.socialrouter.io/v1/youtube/channel.shorts",
  {
    method: "POST",
    headers: {
      "Authorization": "Bearer sr_live_your_key",
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      url: "https://www.youtube.com/@mkbhd",
      limit: 50
    }),
  },
);

import requests

response = requests.post(
    "https://api.socialrouter.io/v1/youtube/channel.shorts",
    headers={"Authorization": "Bearer sr_live_your_key"},
    json={
      "url": "https://www.youtube.com/@mkbhd",
      "limit": 50
    },
)

const run = await sr.run("youtube/channel.shorts", {
  url: "https://www.youtube.com/@mkbhd",
  limit: 50
});

{
  "id": "ext_a1b2c3d4",
  "status": "completed",
  "platform": "youtube",
  "service": "channel.shorts",
  "url": "https://www.youtube.com/@mkbhd",
  "served_by": "apify/streamers",
  "data": [
    {
      "name": "$1 vs $10,000 Cake",
      "title": "$1 vs $10,000 Cake",
      "profile_url": "https://www.youtube.com/shorts/LgbyEFILLJI",
      "source": "youtube",
      "extracted_at": "2026-07-16T09:04:24.249Z",
      "video_id": "LgbyEFILLJI",
      "video_type": "shorts",
      "date_posted": "2026-07-03T16:00:02.000Z",
      "duration": "00:00:49",
      "thumbnail": "https://i.ytimg.com/vi/LgbyEFILLJI/maxresdefault.jpg?sqp=-oaymwEoCIAKENAF8quKqQMcGADwAQH4AbYIgAKAD4oCDAgAEAEYciBJKDgw...",
      "views": 66659034,
      "likes": 1700000,
      "num_comments": 14184,
      "comments_turned_off": false,
      "is_members_only": false,
      "is_paid_content": false,
      "is_age_restricted": false,
      "hashtags": [],
      "channel_id": "UCX6OQ3DkcsbYNE6H8uQQuVA",
      "channel_name": "MrBeast",
      "channel_url": "https://www.youtube.com/channel/UCX6OQ3DkcsbYNE6H8uQQuVA",
      "channel_username": "MrBeast",
      "channel_subscribers": 508000000,
      "channel_total_videos": 992,
      "channel_verified": true,
      "description_links": [],
      "collaborators": [],
      "source_url": "https://www.youtube.com/@MrBeast/shorts",
      "source_order": 1
    }
  ],
  "pagination": {
    "total": 1,
    "returned": 1
  },
  "created_at": "2026-07-30T12:00:00Z",
  "completed_at": "2026-07-30T12:00:03Z"
}

channel.videosList the videos of a YouTube channel. Normalized JSON, one price per record, automatic failover across sources.

curl -X POST https://api.socialrouter.io/v1/youtube/channel.shorts \
  -H "Authorization: Bearer sr_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://www.youtube.com/@mkbhd",
    "limit": 50
  }'

const response = await fetch(
  "https://api.socialrouter.io/v1/youtube/channel.shorts",
  {
    method: "POST",
    headers: {
      "Authorization": "Bearer sr_live_your_key",
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      url: "https://www.youtube.com/@mkbhd",
      limit: 50
    }),
  },
);

import requests

response = requests.post(
    "https://api.socialrouter.io/v1/youtube/channel.shorts",
    headers={"Authorization": "Bearer sr_live_your_key"},
    json={
      "url": "https://www.youtube.com/@mkbhd",
      "limit": 50
    },
)

const run = await sr.run("youtube/channel.shorts", {
  url: "https://www.youtube.com/@mkbhd",
  limit: 50
});

{
  "id": "ext_a1b2c3d4",
  "status": "completed",
  "platform": "youtube",
  "service": "channel.shorts",
  "url": "https://www.youtube.com/@mkbhd",
  "served_by": "apify/streamers",
  "data": [
    {
      "name": "$1 vs $10,000 Cake",
      "title": "$1 vs $10,000 Cake",
      "profile_url": "https://www.youtube.com/shorts/LgbyEFILLJI",
      "source": "youtube",
      "extracted_at": "2026-07-16T09:04:24.249Z",
      "video_id": "LgbyEFILLJI",
      "video_type": "shorts",
      "date_posted": "2026-07-03T16:00:02.000Z",
      "duration": "00:00:49",
      "thumbnail": "https://i.ytimg.com/vi/LgbyEFILLJI/maxresdefault.jpg?sqp=-oaymwEoCIAKENAF8quKqQMcGADwAQH4AbYIgAKAD4oCDAgAEAEYciBJKDgw...",
      "views": 66659034,
      "likes": 1700000,
      "num_comments": 14184,
      "comments_turned_off": false,
      "is_members_only": false,
      "is_paid_content": false,
      "is_age_restricted": false,
      "hashtags": [],
      "channel_id": "UCX6OQ3DkcsbYNE6H8uQQuVA",
      "channel_name": "MrBeast",
      "channel_url": "https://www.youtube.com/channel/UCX6OQ3DkcsbYNE6H8uQQuVA",
      "channel_username": "MrBeast",
      "channel_subscribers": 508000000,
      "channel_total_videos": 992,
      "channel_verified": true,
      "description_links": [],
      "collaborators": [],
      "source_url": "https://www.youtube.com/@MrBeast/shorts",
      "source_order": 1
    }
  ],
  "pagination": {
    "total": 1,
    "returned": 1
  },
  "created_at": "2026-07-30T12:00:00Z",
  "completed_at": "2026-07-30T12:00:03Z"
}

Services

Catalogue

Account

LinkedIn

Instagram

X

Reddit

Facebook

TikTok

YouTube

Pinterest

Bluesky

Snapchat

Google Maps

Body

Accepted URL formats

Offers

Response

​Body

​Accepted URL formats

​Offers

​Response

Body

Accepted URL formats

Offers

Response