# YouTube Shorts Scraper: Views, Likes, Hashtags & Creators (`automatic/youtube-shorts-scraper`) Actor

Scrape YouTube Shorts from channels or keyword searches: title, views, likes, comments, exact upload date, hashtags and description, with the creator's subscribers on every row. Sort a channel's Shorts by latest or popular, keep only recent ones. No login or API key.

- **URL**: https://apify.com/automatic/youtube-shorts-scraper.md
- **Developed by:** [Philip Kirkbride](https://apify.com/automatic) (community)
- **Categories:** Videos, Social media
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $2.50 / 1,000 shorts

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## YouTube Shorts Scraper

Turn YouTube Shorts into a clean spreadsheet: title, views, likes, comment totals, upload date, duration, description, hashtags and thumbnail for every Short, with the creator's name, handle, channel link and subscriber count on the same row. Collect a channel's Shorts tab or the Shorts YouTube finds for a search term.

### What you get

- **One row per Short** with exact upload date, views, likes, comment total, duration, description, hashtags, thumbnail and the `/shorts/` link.
- **Creator details on every row**: channel name, handle, channel ID, channel link and subscriber count, ready for creator comparison without a second scraper.
- **Channel Shorts in the order you want**: latest, most popular or oldest first, and only Shorts published after a date such as `2026-10-01` or `30 days`.
- **Shorts search**: the Shorts YouTube shows for any search phrase, and only Shorts.
- **Paste sources the way you have them**: channel links, @handles, UC… IDs, `/shorts` tab links, search-results links, or the `startUrls` list you already use with other YouTube scrapers.
- No login, API key or quota. Export JSON, CSV or Excel, or connect through the API.

### Use cases

- **Short-form content research**: which Shorts and hashtags get the most views in a niche.
- **Creator comparison and influencer discovery**: subscriber counts and Shorts performance side by side.
- **Competitor tracking**: a channel's newest or most popular Shorts, on a schedule.
- **Trend monitoring**: recent Shorts for a topic, with their hashtags and descriptions.

### Also available

The YouTube suite: pick the job.

| Actor | Use when |
|---|---|
| **YouTube Shorts Scraper (this Actor)** | Shorts from channels or searches, with creator details |
| [YouTube Scraper](https://apify.com/automatic/youtube-scraper) | Videos, channels, search results and comments |
| [YouTube Channel Scraper](https://apify.com/automatic/youtube-channel-scraper) | Channel profiles, emails, links and latest videos |
| [YouTube Comments Scraper](https://apify.com/automatic/youtube-comments-scraper) | Comments and replies from videos or channels |
| [YouTube Transcripts](https://apify.com/automatic/youtube-transcripts-scraper) | Bulk transcripts as text, SRT or VTT |
| [YouTube Outlier Finder](https://apify.com/automatic/youtube-outlier-finder) | Breakout videos that beat their channel median |

### Input

The Console prefill collects 5 Shorts from a channel and 5 from a search (10 rows):

```json
{
  "channelUrls": [
    "https://www.youtube.com/@mkbhd"
  ],
  "searchTerms": [
    "science experiments"
  ],
  "maxShortsPerSource": 5,
  "maxItems": 10
}
```

The 20 most popular Shorts from each channel, published in the last six months:

```json
{
  "channelUrls": ["@mkbhd", "UCHnyfMqiRRG1u-2MsSQLbXA"],
  "maxShortsPerSource": 20,
  "channelSort": "popular",
  "publishedAfter": "6 months"
}
```

`maxItems` caps all delivered rows across all sources. Equivalent links and duplicate items are counted once. Public counts may be rounded; unavailable values are `null`.

Switching from another YouTube Shorts scraper? Paste your usual input: `startUrls` (plain links or `{"url": "…"}` objects), `channels` (handles with or without @, or links), `maxResultsShorts`, `sortChannelShortsBy` (`NEWEST`, `POPULAR`, `OLDEST`) and `oldestPostDate` are understood.

### Input options

| Input | Default | What it controls |
| --- | --- | --- |
| `channelUrls` | `"empty: sample"` | Public channels, for example https://www.youtube.com/@mkbhd, @mkbhd or UCBJycsmduvYEL83R_U4JriQ. Their Shorts tab is collected. Empty sources run the announced sample. |
| `searchTerms` | `"empty: sample"` | Search phrases, for example science experiments. Results include only Shorts identified by YouTube. |
| `startUrls` | — | Channel or search-results links in the common `startUrls` format. |
| `maxShortsPerSource` | — | At most this many Shorts from each channel or search term. Empty: only `maxItems` applies. |
| `channelSort` | `"latest"` | `latest`, `popular` or `oldest`, as on the channel's own Shorts tab. |
| `publishedAfter` | — | Only Shorts published on or after a date (`2026-10-01`) or a relative value (`7 days`, `6 months`), from channels and searches. |
| `maxItems` | `100` | Hard cap across all sources, for example 200. Duplicates count once. |

Every row is a Short (`isShort: true`). `detailsComplete: false` means a Short was found but some detail fields could not be collected; the run status reports partial success.

### Output example

This real public record was collected on 2026-11-15.

```json
{
  "type": "video",
  "input": "https://www.youtube.com/@mkbhd",
  "scrapedAt": "2026-11-15T00:13:30Z",
  "id": "ai1gIWacf0I",
  "url": "https://www.youtube.com/shorts/ai1gIWacf0I",
  "title": "This can SEE Sound!",
  "description": "This is an acoustic imaging camera",
  "hashtags": [],
  "views": 2742613,
  "likes": 76924,
  "comments": 1500,
  "publishedAt": "2026-10-27T00:00:00Z",
  "publishedText": "Oct 27, 2026",
  "channelId": "UCBJycsmduvYEL83R_U4JriQ",
  "channelName": "Marques Brownlee",
  "channelHandle": "@mkbhd",
  "channelUrl": "https://www.youtube.com/@mkbhd",
  "channelSubscribers": 21400000,
  "duration": 91,
  "thumbnail": "https://i.ytimg.com/vi/ai1gIWacf0I/hqdefault.jpg",
  "isShort": true,
  "detailsComplete": true
}
```

### Pricing

**$0.0025 per Short ($2.50 per 1,000) plus $0.005 per run start.** The start fee is charged per GB of memory at startup (rounded up, minimum one GB); the default 512 MB run is one start event. Failed inputs produce no result rows.

| Example | Results | Cost |
| --- | ---: | ---: |
| Console prefill | 10 | $0.0300 |
| 100 results | 100 | $0.2550 |
| 1,000 results | 1,000 | $2.5050 |

All examples use the default 512 MB memory.

### Good to know

- Public data visible without signing in only. Unavailable sources appear in `OUTPUT.errors`; valid sources continue, and the status reports partial results.
- Up to 50 listing pages per channel or search term; availability varies, and large runs may stop early with partial results. This is not a complete historical archive.
- Counts can be rounded or hidden. Upload dates are calendar days at midnight UTC. `publishedAfter` checks each Short's upload date, for channels and searches (a search also uses YouTube's own upload-date filter when the date is within a year); `OUTPUT.publishedAfter` reports the cutoff and how many Shorts were skipped. A sort order YouTube does not offer falls back to latest, with a notice.
- Up to 100 source entries per run. Empty lists use the same small sample as `{}`; whitespace-only entries are invalid. Duplicates count once per run. Scheduled runs collect the input again; saved-state deduplication is not supported.
- A search-results link pasted as a channel, or a channel link pasted as a search term, is read as what it is (noted in `OUTPUT.notices`). Video and playlist links are skipped with a note in `OUTPUT.errors` and are not charged. A channel without a Shorts tab and a search YouTube answers with "No results found" are reported the same way. If no input could be collected (all missing, unavailable or skipped), the run still finishes successfully with `OUTPUT.status: "no_results"` and a status message that says why.
- Input fields this Actor does not use, including connection settings, are listed in `OUTPUT.notices` and in the status message instead of failing the run. The Actor always uses its own standard connection.

This product is independent of YouTube and is not endorsed by it.

# Actor input Schema

## `channelUrls` (type: `array`):

Public channels, for example https://www.youtube.com/@mkbhd, @mkbhd or UCBJycsmduvYEL83R_U4JriQ. Their Shorts tab is collected. Empty sources run the announced sample. Up to 100 sources total; each entry is at most 2048 characters.

## `searchTerms` (type: `array`):

Search phrases, for example science experiments. Results include only Shorts identified by YouTube. Up to 100 sources total; each entry is at most 500 characters.

## `startUrls` (type: `array`):

The common startUrls input format from other YouTube Actors: plain links or {"url": "…"} objects, for example \[{"url": "https://www.youtube.com/@mkbhd/shorts"}]. Channel links collect their Shorts; search-results links collect the Shorts found. Combined with the lists above, duplicates removed.

## `maxShortsPerSource` (type: `integer`):

At most this many Shorts from each channel or search term, for example 20. Empty means no per-source limit: only Maximum total rows applies.

## `channelSort` (type: `string`):

Which of a channel's Shorts come first, as on its own Shorts tab. Searches keep YouTube's order. Empty uses latest.

## `publishedAfter` (type: `string`):

Only Shorts published on or after this date: 2026-10-01, or a relative value such as 7 days or 6 months. Checked against each Short's upload date, for channels and searches.

## `maxItems` (type: `integer`):

Hard cap across all sources, for example 200. Duplicates count once.

## Actor input object example

```json
{
  "channelUrls": [
    "https://www.youtube.com/@mkbhd"
  ],
  "searchTerms": [
    "science experiments"
  ],
  "maxShortsPerSource": 5,
  "maxItems": 10
}
```

# Actor output Schema

## `results` (type: `string`):

No description

## `summary` (type: `string`):

No description

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "channelUrls": [
        "https://www.youtube.com/@mkbhd"
    ],
    "searchTerms": [
        "science experiments"
    ],
    "maxShortsPerSource": 5,
    "maxItems": 10
};

// Run the Actor and wait for it to finish
const run = await client.actor("automatic/youtube-shorts-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "channelUrls": ["https://www.youtube.com/@mkbhd"],
    "searchTerms": ["science experiments"],
    "maxShortsPerSource": 5,
    "maxItems": 10,
}

# Run the Actor and wait for it to finish
run = client.actor("automatic/youtube-shorts-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "channelUrls": [
    "https://www.youtube.com/@mkbhd"
  ],
  "searchTerms": [
    "science experiments"
  ],
  "maxShortsPerSource": 5,
  "maxItems": 10
}' |
apify call automatic/youtube-shorts-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,automatic/youtube-shorts-scraper"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/m47NgkZKHWX6CIsjr/builds/aPqXOQBpLyJ2Hl6aF/openapi.json
